Updating Apache Tomcat Server Installed with CA OM Web Viewer › Prerequisites

Prerequisites

This section contains information about the prerequisites that must be in place to run the Tomcat update installer.

JVM (Java Virtual Machine) Version

You can run Tomcat Update Installer on Java Runtime Environment 1.6 or higher.

Update an Existing CA OM Web Viewer r12.1 or Later

The Tomcat Updater for CA OM Web Viewer is intended to update the Apache Tomcat software that was installed along with CA OM Web Viewer (at product installation, Install Set Full was selected).

Note:

• Do not run the Tomcat Updater for CA OM Web Viewer unless CA OM Web Viewer Version r12.1 with Apache Tomcat is already installed on your system.
• We strongly recommend that you back up your current CA OM Web Viewer according to your application server environment before you run the Tomcat Updater for CA OM Web Viewer.

Run the Tomcat Updater for CA OM Web Viewer

Update the Apache Tomcat server shipped with CA OM Web Viewer.

Follow these steps:

1. Obtain the CA OM Web Viewer APAR that contains the Apache Tomcat update. Refer to the included SpecialInstructions.txt for instructions on locating the installer file. Copy or transfer (binary) the file to the system where Web Viewer is installed.
2. It is recommended that you stop the Apache Tomcat web server prior to running the update.
3. Start the update installer as follows:

   Windows

   • Run CA_OM_WEBVIEWER_12_1_Tomcat.exe

   Linux/UNIX

   • Set the current folder to the one containing the update installer.
   • Launch the update installer with Java:

     java -jar CA_OM_WEBVIEWER_12_1_Tomcat.jar
     

Update Installation Modes

The Tomcat Update Installer for CA OM Web Viewer automatically runs in the appropriate mode for your operating system:

■ GUI mode--for Windows only

■ Console mode—for all supported operating systems except Windows

Update Using the GUI Mode

This section explains how to update using the GUI mode.

Follow these steps:

1. Review the Introduction panel for information about the Tomcat Updater for CA OM Web Viewer.
2. Click Next to continue.
3. Specify the folder where CA OM Web Viewer is installed. This folder is the parent of the apache-tomcat-n.n.n folder.
4. Click Install to begin the update.
5. Review the Install Complete panel for messages.
6. Click Done.

Update Using the Console Mode

The steps in this section explain how to install CA OM Web Viewer using the Console mode.

Follow these steps:

1. Review the Introduction panel for information about the Tomcat Updater for CA OM Web Viewer.
2. Press <ENTER> to continue.
3. Specify the absolute path where CA OM Web Viewer is installed. This is the parent of the apache-tomcat-n.n.n folder.
4. Press <ENTER>.
5. Verify the install folder is correct.
6. If correct, type Y.
7. Press <ENTER> to begin the update.
8. Review the Install Complete panel for messages.
9. Click Done.

Post-Install Actions

Tomcat Updater for CA OM Web Viewer places a newer build of Apache Tomcat under the CA OM Web Viewer installation folder. It will not replace the existing Apache Tomcat files (assuming APAR is not re-installed). The update does copy your WAR files and deployed applications from the older Tomcat to the new Tomcat. It also copies your primary web server port number.

Important! The update installer only preserves the Apache Tomcat connector port number customization. If any additional Apache Tomcat customization had been performed, these must be done again for the new Tomcat.

1. Review the prior Tomcat's /conf folder for customization.

   If any files have been customized, make the same changes to the new Tomcat's /conf folder.

   Note: Copy/replace of the /conf files is not recommended UNLESS you can confirm the older Tomcat's /conf files are compatible with the newer Tomcat.

2. Review your Apache Tomcat start-up procedures.
   • For Windows, the Tomcat update installer for Windows (EXE) will update the Windows Service to reference the new Tomcat location. Review this service to ensure proper update. Optionally set the service's start-up type to automatic.
   • If Tomcat was started on Windows via BAT files, review, update and use the BAT files under the (newer) Tomcat's /bin folder. The program group short-cuts were updated to reference the new BAT files.
   • For USS, if Tomcat was started via a mainframe started task (PROC), update your procedure JCL to reference the new Tomcat location.
   • For all other platforms where Tomcat is started via SH files, review, update and use the SH files under the (newer) Tomcat's /bin folder.
3. (Optional) Once you are satisfied with the updated Apache Tomcat server, ensuring all configuration settings were migrated and web applications deployed, you can delete the old Apache Tomcat folder.

Viewing the Update Install Installation Tracing and Log

This section provides you with instructions of how to review the logs that are produced by the Tomcat Updater for CA OM Web Viewer.

Note: When the update installation summary starts with Warning or Non-Fatal Failure the information about the error is logged in the installation logs.

Log Locations

There are three primary logs that are produced Tomcat Updater for CA OM Web Viewer.

• Primary Update Install Log
• Update Install Standard Out
• Update Install Standard Error

Primary Install Log - CA_Output_Management_Web_Viewer_r12.1_Install_<date_time>.log.

Install Standard Out - CA_OM_WV_updater_standard_out.log.

Install Standard Error - CA_OM_WV_updater_standard_error.log.

Primary Install Log

The main install log is placed in:

$USER_INSTALL_DIR$/uninstaller/Logs

Note: If there is a failure early in the installation, or you cancel the installation then the log file may be placed in your Home folder in USS/Unix/Linux or on the Desktop on Windows.

The filename for the primary install log is:

CA_Output_Management_Web_Viewer_r12.1_Install_<date_time>.log

Install Standard Out

The install standard out is written to:

$TEMP$/CA_OM_WV_updater_standard_out.log

Note: The user temp folder can be found on the Windows by typing echo %TEMP% in the command prompt. The system temp folder on USS/Unix/Linux systems is often /tmp. For more information, on alternate USS/Unix/Linux system temp folder locations, see the OS documentation.

Install Standard Error

The installation standard error is written to:

$TEMP$/CA_OM_WV_updater_standard_error.log

Note: The user temp folder can be found on Windows by typing echo %TEMP% in the command prompt. The system temp folder on USS/Unix/Linux systems is often /tmp. For more information on alternate USS/Unix/Linux system temp folder locations, see the OS documentation.