Installing Web Viewer 12.1 into the USS environment can be challenging. Are there any additional install notes?

Document ID:  TEC593107
Last Modified Date:  07/06/2017
{{active ? 'Hide' : 'Show'}} Technical Document Details

Products

  • CA Output Management Web Viewer

Releases

  • CA Output Management Web Viewer:Release:12.1

Components

  • OUTPUT MGMT WEB VIEWER - UNIX SYSTEM SERVICES:WBVUSS
  • CA OUTPUT MANAGEMENT WEB VIEWER FOR ALL PLATFORMS:WBVLUW
Summary:

Yes, there are additional install instructions that would be of use to a first-time installer.

Instructions:

Web Viewer r12.1 USS Additional Install Instructions

  1. Start a CA DRAS task.  The task will need to be found in the DRAS discovery step of the installation (Step 5 below).
  2. Have a USS environment and directories established, where the installation will be performed.
    Note: You can use either the OMVS environment on the mainframe or the PuTTY application on the PC.
  3. Obtain the Install File from the CA Website The Install File is an .iso file (cd image file) .  Do NOT chose the .PAX file
  4. Extract the .jar file on the PC. The .jar file is obtained from the .iso file that is available at the Support.CA.com site. A PC product like "Virtual CloneDrive" or "7-zip" can be used to extract the .jar file from the .iso file.
  5. Prepare to Upload the .jar file to the mainframe.
  • Make sure the filesystem in mounted in USS
  • On the mainframe:
    • Do TSO command OMVS.
    • Change directory (cd) to the directory  where the transfer will be done.
  • On the PC:
    • Bring up a Command Prompt screen
    • Using the "cd ..." command, change to the directory where the .jar file is located.
    • To perform the upload (FTP) of the .jar file, Type 
      • ftp SystemName  and press Enter
      • Your TSO_UserID and press Enter
      • Your mainframe password for the LPAR/System (the same used to log onto TSO) and press Enter
      • bin and press enter
      • put the_.jar_file /u/users/dir_a/UserID/the_.jar_file and press Enter
  • On the mainframe:

    • Use command "ls -la", to note the progress of the .jar file transfer.
    • The DOS command window will shortly show the FTP has completed.
  • To install the Web Viewer, with either the mainframe OMVS or PuTTY:

    • Set the CAOMVW12_HOME variable  (Set it to the install path)
      CAOMVW12_HOME=/usr/CA_OM_Web_Viewer     (for example)
      EXPORT CAOMWV12_HOME

    • Make sure that the Java bin directory is in your PATH environment variable, for example using:

      PATH=/sys/java64bt/v7r0m0/usr/lpp/java/J7.0/bin
    • Point to the directory, where the .jar file was uploaded to, and run the following Java command to

      start the installer:

      java -jar CA_OMWEBVIEWER_12_0_SP0.jar   for 12.0   or
      java -jar CAOMWV.jar for 12.1
    • Follow the panels and instructions, 

      "Installation Using the Console Mode":

      1. Step 1: Introduction and License Agreements
        • Press [Enter] (about 54 times) until you come to

          "DO YOU ACCEPT THE TERMS ... ? (Y/N):"
          Type "Y" [Enter] to accept.
        • Press [Enter] (about 150 times) until you come to

          "DO YOU ACCEPT THE TERMS ... ? (Y/N):"
          Type "Y" [Enter] to accept.

      2. Step 2: Supply the Installation Information
        • For the message "ENTER AN ABSOLUTE PATH ..."

          Type "/u/users/dir_a/UserID/CA_OM_Web_Viewer" [Enter]
          Verify the selection with "Y" [Enter].

      3. Step 3: Choose Your Java Virtual Machine
        • Type "1" [Enter], to choose a Java VM installed with the application.
        • Type "/sys/java64bt/v7r0m0/usr/lpp/java/J7.0/bin/java" [Enter]
        • Verify the selection with "Y" [Enter].

      4. Step 4: Choose a Deployment Method
        • Type "1" [Enter], to install an Apache Tomcat application server.  If you are using TOMCAT.  Otherwise select Websphere.
        • Type "/u/users/dir_a/UserID/CA_OM_Web_Viewer" [Enter], to point to which directory to install the server.
        • Type "9096" [Enter] for example, to specify the port number.

          Note: The port specified will be used in the URL for Web Viewer.  The port can be modified later if needed.
      5. Step 5: Supply CCI Server and DRAS Server Information
        • Type " SystemName " [Enter], for the Server.
        • Type "1202" [Enter], for the Port.    NOTE: 1202 is the default.  If you have a different port, enter that.
        • Type "1" [Enter], to "Test CCI connection".
        • Type "2" [Enter], to Accept the CCI settings.
        • For "Select A DRAS ... Server":    Please allow several minutes for the list of DRAS servers (from DRAS discovery) to be returned.

          Note: If a list is not returned, occasionally click the "Clear Screen" icon (in the 3270 Emulator/QWS3270), to get a list.
          If PuTTY is used, you need to wait for the list to be returned, for further activity.

        • Type the number then [Enter] for the DRAS server to be used.
      6. Step 6: Connect to a database
        • Type "2" [Enter], to "Use embedded database".

          Note: The Derby database will be established at the first launch of the installed Web Viewer.  The Derby database is for testing only.
      7. Step 7: Indicate LDAP User Authentication
        • Type "1" [Enter], for "Mainframe security first"     NOTE: If you are using LDAP, you may set this up later
      8. Step 8: Complete the Installation
        • Type your TSO_UserID [Enter], to specify a mainframe user ID.
        • Press [Enter], to accept the list presented for "Pre-Installation Summary".
        • Type "/u/users/dir_a/UserID/CA_OM_Web_Viewer" [Enter], to perform the install.
        • Review the information presented for the Tomcat Application Server.
        • Type "1" [Enter], to start up the application server.
        • Review the "Installation Complete" information and use the URL shown to start Web Viewer v12.1 in a web browser.

          Note: The URL http://HOST_NAME:nnnn/CAOMWebViewer12 is generated. The HOST_NAME should be "SystemName", and "nnnn" is the port used from Step 4 above (for the Tomcat server).
        • Press Enter to exit the installer.

Note: If you are having problems or want to specify options other than those above and need assistance, please contact CA Support.

Please help us improve!

Will this information enable you to resolve your issue?

Please tell us what we can do better.

{{feedbackText.length ? feedbackText.length : '0'}}/255

{{status}}

Not what you were looking for?

Search Again >

Product Information

Support by Product >

Communities

Join a Community >

Chat with CA

Just give us some brief information and we'll connect you to the right CA ExpertCA sales representative.

Our hours of availability are 8AM - 5PM CST.

All Fields Required

connecting

We're matching your request.

Unfortunately, we can't connect you to an agent. If you are not automatically redirected please click here.

  • {{message.agentProfile.name}} will be helping you today.

    View Profile


  • Transfered to {{message.agentProfile.name}}

    {{message.agentProfile.name}} joined the conversation

    {{message.agentProfile.name}} left the conversation

  • Your chat with {{$storage.chatSession.messages[$index - 1].agentProfile.name}} has ended.
    Thank you for your interest in CA.


    Rate Your Chat Experience.

    {{chat.statusMsg}}

agent is typing