ConfigTool may not work using System Level External Configuration OM Webviewer 12.1

Products

• Output Management Web Viewer

Issue/Introduction

The ConfigTool may not run or may end unexpectedly.

Environment

• Output Management Web Viewer 12.1
• Apache Tomcat®
• IBM WebSphere Application Server

Cause

The CAOMWV12_HOME variable must be set for UNIX, Linux and USS.

Resolution

If you are using System Level External Configuration, an environment variable named CAOMWV12_HOME is required. You set the environment variable to the path of your OM Web Viewer install home or the parent directory of your configuration directory. The OM Web Viewer installer automatically creates an environmental variable except on USS, Linux, or UNIX. If you copy the configuration tool to another computer you will need to create the CAOMWV12_HOME variable there also.

Important! In all cases, the home variable must point to the configuration folder parent. Be sure to use /config not /util/config. Point to the parent of the /config folder that contains the properties files used by OM Web Viewer. Note that there may be a second folder with the same name config, /util/config, that contains the properties files the ConfigTool uses, do not set the home variable to the parent of this lower-level folder. Refer to CAOMWV12_HOME Environment Variable.

If you are using System Level External Configuration, set the CAOMWV12_HOME variable on your system.

Apache Tomcat®

If you are running Tomcat as a started task, the variable should be specified in the Tomcat JCL.

IBM WebSphere Application Server

If you are using a System Level External Configuration, you must set the CAOMWV12_HOME variable within WebSphere. You set up a new environment variable named CAOMWV12_HOME in the Java and Process Management > Process definition > Environment Entries section of your Application Server. Then, restart your WebSphere server in order for the setting to take effect.

Important! Add CAOMWV12_HOME as an environment variable not as a property in order for Web Viewer to recognize CAOMWV12_HOME.