Table 31 User Configuration Variables (continued)
User Configuration Variables | Description |
MAINTENANCE_FLAG (for example, | This variable will enable or disable maintenance mode for the Tomcat package. |
MAINTENANCE_FLAG ="yes") | By default, this is set to "yes". In order to disable this feature, |
| MAINTENANCE_FLAG should be set to "no". When Tomcat needs to be |
| maintained the file, <package directory>/tomcat.debug needs to be |
| touched. During this maintenance period, the tomcat process monitoring is |
| paused. Even if the tomcat instance is brought down, the package will not be |
| failed over to the adoptive node. To continue monitoring and turning off |
| maintenance mode, remove the tomcat.debug file. It is the user's |
| responsibility to ensure that the tomcat instance is running properly after the |
| maintenance phase. |
| NOTE: Setting MAINTENANCE_FLAG to "yes" and touching the |
| tomcat.debug file in the package directory will put the package in toolkit |
| maintenance mode. Serviceguard A.11.19 release has a new feature which |
| allows individual components of the package to be maintained while the |
| package is still up. This feature is called Package Maintenance mode and is |
| available only for modular packages. For more information using Package |
| Maintenance mode, see Modular package support in Serviceguard for Linux |
| and ECM Toolkits available at |
| |
MONITOR_PORT (for example: | This is the tomcat server listening port. This should be as same as the port |
MONITOR_PORT=8081) | configured in the Tomcat configuration file $CATALINA_BASE/conf/ |
| server.xml. The toolkit checks the existence of the Tomcat process by |
| periodically checking whether this port is listening. If multiple instances of |
| tomcat are configured, this port needs be unique for each instance. The default |
| value is 8081. |
MONITOR_INTERVAL (for example, | Specify a time interval in seconds for monitoring the Tomcat instance. The |
MONITOR_INTERVAL=5) | monitor process checks the Tomcat daemons at this interval to validate they |
| are running. The default value will be 5 seconds. |
RETRY_TIMES (for example, | This variable holds the number of times to attempt to check the 'tomcat' daemon |
RETRY_TIMES=2) | processes before giving up and exiting to fail state. If not defined, its default |
| value will be 2. |
For the alert mail notification feature, an additional parameter called ALERT_MAIL_ID is introduced in the ADF. It sends an
The following information provides the steps for configuring the toolkit and running the package. This includes configuring the Tomcat toolkit user configuration file:
NOTE: Before working on the toolkit configuration, the package directory (for example, /etc/cmcluster/pkg/tomcat_pkg1) must be created and all toolkit scripts copied to the package directory.
1.Edit the Tomcat Toolkit user configuration file.
In the package directory, edit the user configuration file (hatomcat.conf ) as indicated by the comments in that file.
For Example:
CATALINA_HOME="/opt/hpws22/tomcat" CATALINA_BASE="/shared/tomcat_1"
