Though the client had attended sprint sessions and had read documentation, it was noted that there was a lack of direction with the installation portion of the documentation.
The client wanted the steps for the procedure.
Needed guidance
OM Web Viewer 14.0 Installation/Deployment Instructions (Previously known as MTC Content Viewer 14.0)
Web Viewer 14 is referenced in the online View® Documentation - Install Web Viewer
The Web Viewer 14 FMID is CCAFE00, and it is packaged together with View/Deliver, and the CA Spool Java standalone Transformers.
If you did not include the CCAFE00 FMID, you will need to install View/Deliver again, just installing the CCAFE00 FMID.
The package can be downloaded manually, from the Broadcom Support site:
. Select and download a component that contains the product package:
Ex:
CA View, CA Deliver, CA OM Web Viewer 14.0 0000 - Product Package
DVD0000000000961.pax.z
176.11 MB
or
CA View, CA Deliver, CA OM Web Viewer 14.0 0000 - Product Package
VIEW.V14R0.ZOSMF.pax.Z
Please refer to the official documentation which contains updated information:
Common Components and Services for z/OS 15.0
Ex: SHARE.VIEW.V14CD4.ZFS
/u/users/cai/view/runtime/webviewer is the mount-point of the filesystem.
Below is the list of USS files/directories that are currently shipped with the install.
They should be visible after the install and at the mount-point specified:
. h2.jar
. log4j2.xml
. ConfigFile.cfg
. CA
. CAWVHOME
. Web-Viewer.war
. MTC-ContentViewer-properties.war
. Web-Viewer-util.jar
. NOTICE.txt
. WebViewer.jar
. WebViewer.sh
. WebViewer.war
3. Prepare the Apache Tomcat® server. This will be used by OM Web Viewer14.0
Ex: /u/users/cai/view/tpv/tomcat
Ex: cp -R /u/users/cai/tomcat /u/users/cai/view/tpv
Ex:
TSO OMVS
cd /u/users/cai/view/runtime/webviewer - go to install WV dir
cp –R CAWVHOME /u/users/cai/view/tpv/tomcat - copy to my tomcat dir
Ex:
TSO OMVS
cd /u/users/cai/view/tpv/tomcat - go to my tomcat dir
mkdir H2 - create a dir for H2 DB
cd /u/users/cai/view/runtime/webviewer - go to install WV dir
cp h2.jar /u/users/cai/view/tpv/tomcat/H2 - copy the H2 DB
Ex:
TSO OMVS
cd /u/users/cai/view/runtime/webviewer - go to install WV dir
cp MTC-ContentViewer.war /u/users/cai/view/tpv/tomcat/webapps
cp MTC-ContentViewer-properties.war /u/users/cai/view/tpv/tomcat/webapps
Ex: /u/users/cai/view/tpv/tomcat/CAWVHOME/config/ConfigFile.cfg
LOGLEVEL = "INFO";
SCHEMANAME = "CV_MASTER";
REPOSITORYTABLE = "REPOSITORIES";
…
DBTYPE = "H2";
DBLOCATION = "/u/users/cai/view/tpv/tomcat/H2/H2DB";
DBUSER = "<userid>";
DBPASSWORD = "<......>";
DEFAULTGROUPNAME = "";
TRANSLATEMETADATA = "false";
Ex: /u/users/cai/view/tpv/tomcat/conf/server.xml
Ex: <Server port="-1" shutdown="SHUTDOWN">
<Connector port="8083" protocol="HTTP/1.1"
connectionTimeout="30000"
disableUploadTimeout="true"
enableLookups="false"
maxHttpHeaderSize="8192"
maxThreads="250"
minSpareThreads="50" />
Ex:
<Host name="localhost" appBase="webapps"
deployOnStartup="true"
unpackWARs="true" autoDeploy="true">
Ex: /u/users/cai/view/tpv/tomcat/conf/web.xml
<!--
<security-constraint>
<web-resource-collection>
<web-resource-name><strong>restricted methods</strong></web-resource-name>
<url-pattern>/*</url-pattern>
<http-method>DELETE</http-method>
<http-method>OPTIONS</http-method>
<http-method>PUT</http-method>
<http-method>POST</http-method>
<http-method>TRACE</http-method>
</web-resource-collection>
<auth-constraint />
</security-constraint>
-->
Ex:
export JAVA_HOME=/sys/java64bt/v8r0m0/usr/lpp/java/J8.0_64 - set this to the java path available to your system
CV_INSTALL_HOME=/u/users/cai/view/tpv/tomcat – set this to the path you have created and where you have the WV14 Tomcat
J2Z_DUMP_HLQ=SHARE.VIEW – set this to a HLQ which will be used when the JVM will create dumps in case of errors
#BASE_INSTALL – you may comment out this line. Most likely the CCS Tomcat and the WV14 Tomcat are under different path
#INSTALL_HOME – you may comment out this line
#PRODUCT_HOME – you may comment out this line
CATALINA_HOME=/u/users/cai/tomcat – set this to the CCS Tomcat path. We will be using the CCS Tomcat lib & bin libraries. In case there’s an fix applied to the CCS Tomcat, then the WV14 Tomcat will be using it as well.
CATALINA_BASE=/u/users/cai/view/tpv/tomcat – set this to the WV14 Tomcat path
H2_JAR=${CV_INSTALL_HOME}/H2/h2.jar – set this to where the h2.jar file is
LIBPATH="$LIBPATH":"${JAVA_HOME}"/lib/s390x/classic – make sure that files under this path have the extended attribute of program controlled active
IJO="$IJO -Xms2048m -Xmx4096m" – you may lower these for test LPAR
export CAWVHOME=${CATALINA_BASE}/CAWVHOME – check that this variable is set to the CAWVHOME directory in the WV14 Tomcat filesystem
External security
Configure HTTPS to Override HTTP
Configure Web Viewer To Use The Java Transformers
Migrate from a DRAS Config File to Your Application Database
Migrate Export Rules from Web Viewer 12.1
Run the CAHVCFUP Job to Update the Configuration File
Automate the Recall of Offline Reports
For information on the installation of CA Content Viewer, now named OM Web Viewer:
or
Deploy the product to a WebSphere Application Server