Additional CA Chorus for Storage Management Configuration › Initialize and Configure the Storage Management Interface

Initialize and Configure the Storage Management Interface

CA Chorus for Storage Management customers must initialize and perform some Storage Management interface configuration so users can use it. The following items must be done:

• A name for the single-signon authenticating host for the Storage Management interface must be specified. 
• A display port must be specified so reports can be created from the Storage Management interface.
• The Storage Management interface database must be initialized.
• At least one public host for the single-signon authenticating storage engine subsystem for the Storage Management interface must be created.
• Email server settings must be specified.
• The charting facility must be configured.

Note: Some Storage Management interface functions have limited use until the system administrator performs more tasks. For more information about these tasks, see the Administration Guide.

Follow these steps:

1. Edit and submit the ENVE4H member in your_chorus_hlq.CETJOPTN as described in the member. All of the Storage environment variables can run with the supplied default values except the <vantage_public_host> variable in the following statement:

   #IJO="$IJO -Dvantage.web.client.host.name=<vantage_public_host>"
   

   Note: If you have started the CA Chorus JBoss task, restart it to activate the environment variable changes by issuing the following commands:

   /P CHORJBOS, to stop it
   

   /S CHORJBOS, to start it
   

2. Log in to CA Chorus.
3. Add the Quick Links module to your CA Chorus dashboard, and click Manage Storage Resources.

   The Storage Management interface log on window opens in a separate browser window.

4. Enter the system administrator user Name and Password.

   The system administrator credentials are as follows:

   • The default system administrator user Name: APP
   • Password: See the WEBUI_ADMINPASSWORD parameter that is specified in the E4HI0010 job in your_chorusstor_hlq.CE4HJCL.
5. Select VantageDB in the Authenticating Host field, and click Login.

   If you are logging in to the Storage Management interface as the system administrator for the first time, the Storage Management interface database starts to initialize.

6. Click OK in the initialize confirmation dialogs that appear.

   After the database initialization completes, the Storage Management interface opens in your browser with the My Profile window open. If the My Profile window does not open, click My Profile in the Storage Management interface Menu bar or select My Profile from the Tools menu.

   Note: The Storage Management interface online help details how to use the different options in the My Profile window.

7. Click Add Host Definition.
8. Enter values and make selections in the New Host Definition dialog for the following required fields:

   Important! Create a single public host for users to authenticate for single-sign on using the host that is specified in step 1.a. When a user is logged in to the Storage Management interface, they can create their own private hosts.

   Note: New Host Definition dialog field explanations are available in the Storage Management interface online help system.

   Host Name

   Specifies a unique host name. This name appears in the Host Definition List and Object Tree. Consider that you could eventually have multiple hosts. The host names must be equivalent to the StorageDsName variables in the E4HI0010 job.

   Important! Create a public host for the single-signon authenticating host that is specified in step 1.a.

   Note: The host name is case-sensitive. Enter the host names exactly as you entered the values for the StorageDsName variables in the E4HI0010 job.

   IP Address

   Specifies the IP address where the storage engine z/OS host runs. This value is the same as the value of the VantageIpAddr variable in the E4HI0010 job.

   Port

   Specifies the port number of the storage engine z/OS host. This value is the same as the value of the VantageIpPort variable in the E4HI0010 job.

   Include On Object Tree

   Select this option so that the Storage Management interface displays the host name in the Object Tree for all end users.

   Use PassTicket

   Select this option. When this option is selected, the following actions occur:

   • The PassTickets security feature is invoked.
   • Automatic log in to the Storage Management interface occurs when end users select the Manage Storage Resources link in the Quick Links module.

   PassTickets do not send the password over the network, instead the PassTicket configuration on the host is used. PassTickets must be activated on each storage engine host for this option to work.

   Note: For more information about activating PassTickets on the storage engine hosts, see the CA Chorus for Storage Management Site Preparation Guide.

   Public Host

   Select this option. At least one public host is required for CA Chorus for Storage Management. However, if you are using multiple storage engine subsystems for your CA Chorus user-interface, create a public host for each subsystem.

   Note: This option is only available if you are logged in as the system administrator to the VantageDB database.

   Note: Do not define private hosts when logged in as the system administrator to VantageDB if you plan to activate PassThrough in the private host definition. Users can activate PassThrough in their private host definitions. Use the Storage Management interface online help to learn how to use the different My Profile options to create their private hosts after they open the Storage Management interface from the Quick Links module.

9. Click OK.

   The My Profile window opens with the public host definition in the Host Definition List. The Scope column should read "PUBLIC".

   A public host is created for the StorageDsName: ADDR(VantageIpAddr) PORT(VantageIpPort) (first) line that you have in the E4HI0010 job. This single public host is required for users to authenticate for single-sign on using the host that is specified in step 1a.

10. (Optional) Create more public hosts for each additional storage engine subsystem that is set up for your CA Chorus user-interface by repeating steps 7 through 9. This step is for creating public host definitions for the remaining StorageDsName: ADDR(VantageIpAddr) PORT(VantageIpPort) lines that you have in the E4HI0010 job.

    Note: This step is marked optional because it is easier to perform it now while you are logged on to the Storage Management interface as a system administrator. You also have the additional hosts information from the E4HI0010 job. However, the system administrator can add new and can manage existing public hosts any time. For the instructions, see the Administration Guide.

11. Test that the public Host Definitions work for the Storage Management interface from the My Profile dialog:
    1. Select the newly created public Host Definition in the Host Definition List.
    2. Click Actions, and then Connect.

       The login dialog opens.

    3. Enter a valid User Name and Password for the public host. The User Name and Password must have the access authority to the storage engine on the z/OS host of the public host definition.
    4. Click Log In.

       The public host is listed in the Object Tree pane with status connected. You have created and tested the public host.

    5. Repeat steps a through d for each public host definition.
    6. Click Close to close the My Profile dialog.
12. Set the Storage Management interface email server settings of the email server the Storage Management interface uses to send emails and set number of concurrent reports. Follow these steps:

    In this context, the email server is the email server the Storage Management interface uses to send emails to the following items:

    • The output report recipients.
    • Email failure notices if the reports are not produced (for example, as scheduled).

    Note: Output report schedules and request for a failure notification are maintained using the Customize Report Wizard by the end user.

    1. Click Tools in the Storage Management interface Menu bar and then Application Configuration to open the Application Configuration dialog.
    2. Specify email server settings.

       The email Server pane in the Application Configuration dialog has the following options:

       Email Server

       (Required) The DNS name or IP address of your email server, which the Storage Management interface uses to relay email messages. The Storage Management interface sends email directly to the recipient email server using the SMTP protocol.

       Port

       (Required) The port number of the email server that the Storage Management interface uses to send emails.

       The Storage Management interface sends emails for the following items:

       - Report emails with output report attachments.

       - Report generation failure messages.

       The default value is 25. However, some sites use a different value, for example, 587.

       User Name

       (Optional) Enter the user ID that has the authority to send email from the designated email server. This field is for sites that have the security requiring an authorized user ID and password to send email.

       Note: Only enter a user ID if the mail server designated for relaying Storage Management interface email only accepts authorized requests.

       Password

       (Optional) Enter the password of the user ID that has the authority to send email from the designated email server.

       Note: Only enter a password if the mail server designated for relaying Storage Management interface email only accepts authorized requests.

       Note: If the Storage Management interface continues to have problems sending email after adding the Email Server settings, you have probably encountered a security problem. For example, some corporate firewalls disable or could be configured to disable outgoing connections to port 25 (the SMTP default port). Contact your Email Administrator, Network Administrator, and Security Administrator to discuss the correct values for the Email Server Setting fields. Storage Management interface emails are sent with the sender address of VantageGMIScheduler@ca.com.

13. Verify that the single-sign on authenticating public host connection and passticket for the Storage Management interface works from the Quick Links module:
    1. Click Logout in the Storage Management interface toolbar and close the Storage Management interface browser window.
    2. Click Manage Storage Resources in the Quick Links module from your CA Chorus dashboard.

       The Storage Management interface opens in a separate window and logs on automatically.

       Note: If automatic logon is unsuccessful, verify PassTickets are defined properly. For more information, see the CA Chorus for Storage Management Site Preparation Guide.

14. Close Storage Management interface and CA Chorus.
15. Configure the charting utility that is used in the Storage Management interface:
    1. Copy the member E4HWEBX from the CE4HJCL library to your proclib.

       This member contains the charting utility started task that is used to create charts in the Storage Management interface. Start the CHORWEBX procedure before the CA Chorus JBOSS started task. Verify with your system administrator that execution permissions are granted on the Xvfb X Server (application) and the Xvfb startXvfb.sh script.

       The JCL is copied and ready for modifications.

    2. Follow the instructions in the sample JCL.

       Because this procedure runs as a started task, its JCL procedure must reside in one of your system proclibs.

       Note: The Xvfb application is part of the IBM Ported Tools for z/OS. IBM Ported Tools for z/OS is a nonpriced program product that is designed to deliver tools and applications for the z/OS environment. These applications have been modified to operate within the z/OS environment. IBM Ported Tools for z/OS is only available to customers with a license to z/OS; it is supported on z/OS 1.4 and above. Xvfb is an X server that can run on machines without display hardware and physical input devices. Xvfb emulates a dumb framebuffer using virtual memory. APAR OA10965 provides support for Xvfb. Consult with administrators for the location of the installed application for Xvfb X-Server. For example: /usr/lpp/tcpip/bin/X11/samples directory.

       The STC is now ready for execution.

    3. Start the CHORWEBX PROCLIB member for the Xvfb X server.

       The X server address space starts.

       If the server starts successfully, the following messages appear in STDOUT:

       Starting Xvfb using server/display: 11
       Xvfb will be run in the background.
       Run "ps -ef | grep Xvfb" to see process ID.
       

       If the startup fails, the following message appears in STDOUT:

       XVFB0178: Failed to establish all listening sockets
       

       The Xvfb X server JOB is completed.

       The CHORWEBX is started.

    4. Start CHORMUF, CHORTSF, and CHORJBOS in this order by issuing the following commands:

       /S CHORMUF
       /S CHORTSF
       /S CHORJBOS
       

       You receive a confirmation message after entering each command.

       Note: You must start CHORWEBX before starting the CHORJBOS task.

16. Verify that charting is enabled in the Storage Management interface by doing the following steps:
    1. Log in to CA Chorus.
    2. Click Manage Storage Resources in the Quick Links module from your CA Chorus dashboard.

       The Storage Management interface opens in a separate window and logs on automatically.

    3. Open any object in the Storage Management interface. For example, the Space and Other Attributes object in the Storage Groups folder of the Object Tree.
    4. Click Customize Settings to open the Customize View Wizard.
    5. Click Chart in the Navigation Tree of the Customize View Wizard.
    6. Click the check-box next to Show Chart, and click Finish.

       A line chart with default settings is displayed in the Storage Management interface. You have verified that charting is enabled in the Storage Management interface.

    7. Click Log Out in the Storage Management interface Menu bar, close the browser window, and log out of the CA Chorus user-interface.

The following Storage Management interface initialization and configuration items are completed:

• A name for the authenticating single-signon storage engine subsystem for the Storage Management interface is specified.
• The Storage Management interface database is initialized.
• A display port is specified so that charts can be created from the Storage Management interface.
• At least one public host for the authenticating single-signon storage engine subsystem is configured.
• Email server settings are specified.
• The charting facility is configured.

Note: The Storage Management interface system administrator can do the following tasks any time:

• Create new and manage existing Storage Management interface Public Hosts.

  Note: Users can manage their Storage Management interface global options. For more information, see the CA Chorus for Storage Management User Guide. Users can also create their own Storage Management interface private host definitions when they are logged on to the Storage Management interface.

• Stop and Start the Storage Management interface Scheduler.
• Manage Storage Management interface scheduled items.
• Create new and manage existing Storage Management interface public logo images.
• Create new and manage existing Storage Management interface public holiday schedules.
• Create new and manage existing Storage Management interface public user views of source objects.

For more information about these tasks, see the Administration Guide.