Installing OM Web Viewer 12.1 into the USS environment
book
Article ID: 9407
calendar_today
Updated On:
Products
Output Management Web Viewer
Issue/Introduction
There are additional install instructions that would be of use to a first-time installer.
Environment
Output Management Web Viewer 12.1 for USS
View®
Output Management Distributed Repository Access System (DRAS)
Common Components and Services for z/OS
Output Management View™ for z/OS
Resolution
Web Viewer r12.1 USS Additional Install Instructions
Start a DRAS task. The task will need to be found in the DRAS discovery step of the installation (Step 5 below). DRAS was installed with View.
Common Services 15.0 must been installed and a CCI task started
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.
Obtain the Install File from the Broadcom Website: The Install File is an .iso file, DVD0000000001981.ISO a cd image file . Do NOT chose the .PAX file or Web Services
Extract the .jar file on the PC. The .jar file is obtained from the DVD0000000001981.ISO. Right click on the .iso file and select MOUNT. The file is located at E:\InstData\Multiplatform, for example. If MOUNT is disabled use an unzip utility such as winzip or 7zip.
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:
Make sure that the Java bin directory is in your PATH environment variable, for example using:
PATH=/sys/java64bt/v8r0m0/usr/lpp/java/J8.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 CAOMWV.jar for 12.1
Follow the panels and instructions,
"Installation Using the Console Mode":
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.
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].
Step 3: Choose Your Java Virtual Machine
Type "1" [Enter], to choose a Java VM installed with the application.
Type "/sys/java64bt/v8r0m0/usr/lpp/java/J8.0/bin/java" [Enter] For example, can use later javas
Verify the selection with "Y" [Enter].
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.
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.
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.
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
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 Broadcom Support.
Additional Information
Note: For USS, in the Tomcat server.xml file, the SHUTDOWN port should be set to -1.