Deploy the Product to a WebSphere Liberty Server

If you plan to use a WebSphere Liberty Server, see the IBM documentation WebSphere Application Server for z/OS Liberty for an overview and installation instructions. After WebSphere Liberty installation, create a WebSphere Liberty server to use for Web Viewer deployment.  For more information, see the IBM documentation Creating a Liberty server manually.
Before you deploy
Web Viewer
, verify that you applied all fixes for your WebSphere Liberty server.
The following procedure describes how to configure and deploy
Web Viewer
to a WebSphere Liberty server.
Follow these steps:
Complete the WebSphere Liberty Requirements
  • Verify whether you need to create a WebSphere Liberty Angel process.  A WebSphere Liberty Angel process is not required by Web Viewer, but may be required by other WebSphere Liberty features that you use.  For more information, see the IBM documentation Configuring the Liberty Angel process and z/OS authorized services.
  • Create the required server jobs. Web Viewer requires a WebSphere Liberty server job.  If you plan to use a WebSphere Liberty Angel process, a WebSphere Liberty Angel job is also required.  For more information, see the IBM documentation Administering Liberty on z/OS.
  • Install the WebSphere Liberty Java Servlets 3.1 feature. For an overview and installation instructions, see the IBM documentation Java Servlets 3.1.
  • Secure the connection to your WebSphere Liberty Server. For more information, see the IBM documentation Securing communications with Liberty.
Add
Web Viewer
DD Statements to your WebSphere Liberty Server
Web Viewer
needs access to the following libraries:
  • DSN=YourCAViewHLQ.CVDELOAD
  • DSN=YourCCSHLQ.CAW0PLD
Add the APF-authorized load libraries to the STEPLIB DD in your WebSphere Liberty server job, or to your linklist.
If you plan to use Java Transformers, complete the following additional requirements:
  • include a STDENVX DD statement for the Java Transformer configuration file:
    • DSN= YourCAViewHLQ.CVDEOPTN(CAHVX2YP)
  • If the Java Transformers are provided by CA Spool, add the CA Spool library to the STEPLIB:
    • DSN=YourCASpoolHLQ.CBQ4LOAD
Set WebSphere Liberty Modules as Program Controlled
The WebSphere Liberty modules that are used to run the server must be set as program controlled. Use the following USS commands to ensure the program controlled flag is set:
extattr +p $WLP_INSTALL_DIR/lib/native/zos/s390x/bbgzs* extattr +p $WLP_INSTALL_DIR/lib/native/zos/s390x/libzNativeServices.so
$WLP_INSTALL_DIR
Indicates your WebSphere Liberty install directory in USS.
Set the CAWVHOME Environment Variable
To set the CAWVHOME Environment Variable for your WebSphere Liberty server, specify the CAWVHOME variable in the WebSphere Liberty server.env file. You can specify the CAWVHOME variable at the WebSphere installation level or for a specific server instance.
Keep in mind that server.env files have a very specific format and do NOT support variable expansion. See the IBM documentation Customizing the Liberty environment for more information about server.env files.
The following example shows the location of the Websphere Liberty server.env file:
$WLP_USER_DIR/servers/<SERVER_NAME>/server.env
$WLP_USER_DIR
Specifies your WebSphere Liberty server user directory in USS.
<SERVER_NAME>
Specifies the name of your WebSphere Liberty server.
The following example shows how to specify the CAWVHOME variable:
CAWVHOME=/cai/CASoftware/CCAFE00/webviewer/CAWVHOME
Verify the Java Temporary Directory
Use the Java property java.io.tmpdir to set the java temporary directory. The java temporary directory must have read/write access for all users that access the application.
See the IBM documentation Customizing the Liberty environment for more information about customizing JVM options.
The following example shows the location of the jvm.options file:
$WLP_USER_DIR/servers/<SERVER_NAME>/jvm.options
$WLP_USER_DIR
Specifies your WebSphere Liberty server user directory in USS.
<SERVER_NAME>
Specifies the name of your WebSphere Liberty server.
The following example shows how to specify the java temporary directory:
-Djava.io.tmpdir=/tmp
Deploy
Web Viewer
to your WebSphere Liberty Server
Use the following procedure to deploy
Web Viewer
to your WebSphere Liberty server:
  1. Use the following command to specify your WebSphere Liberty user directory in USS:
    export WLP_USER_DIR=/wlp/user/dir
  2. Use the following command to specify the name of your WebSphere Liberty server:
    export SERVER_NAME=myServer
  3. Copy the
    Web Viewer
    application WAR file to your WebSphere Liberty applications directory in USS.
    Example:
    Locate the WAR file in the following location:
    /cai/CASoftware/CCAFE00/webviewer/web-viewer.war
    Copy the WAR file to the following destination:
    $WLP_USER_DIR/servers/$SERVER_NAME/apps/web-viewer.war
    $WLP_USER_DIR
    Specifies your WebSphere Liberty server user directory in USS.
    <SERVER_NAME>
    Specifies the name of your WebSphere Liberty server.
  4. Customize the sample webApplication element file with the modification instructions that are included in the file.
    The sample webApplication element file is in ASCII format.
  5. Add the webApplication element from the sample webApplication element file to the server element in the $WLP_USER_DIR/servers/$SERVER_NAME/server.xml file.
    See the IBM documentation Deploying a web application to Liberty for more information.
  6. Restart your WebSphere Liberty server.