EKM cluster nodes can be registered and run as Windows services.
When run in console mode, environment variables and other parameters required by EKM are
set in the control scripts located in
EKM_NODE_ROOT182/bin and are evaluated when the
EKM console mode control scripts are executed.
When run in service mode, environment variables and other parameters required by EKM are set and evaluated in the manner described below:
EKM cluster nodes use a program called Yet Another Java Service Wrapper (also referred to in this guide as "Java Service Wrapper") to register and run the JBoss application server as a Windows service. EKM cluster nodes also use the service registration and execution capability of the MySQL database server to register and run MySQL as a Windows service, where applicable.
The environment variables and other parameters used by the EKM service,
which runs the JBoss application server, are set in the configuration
file for Java Service Wrapper. This file is named wrapper.conf and is located at the following path:
JBOSS_HOME/domain/configuration/wrapper.conf
wrapper.conf contains settings for the Java Virtual Machine that is
executed by Java Service Wrapper. It also contains environment variable settings for the
program that it launches—in this case, the JBoss application server where the EKM
server application is deployed. The environment variables and parameters in this file include
settings for EKM that correspond to the settings in the console mode control scripts in
EKM_NODE_ROOT182/bin, including
ekm_env.cmd and ekm_start.cmd. Java
Service Wrapper does not use the control scripts; all environment variables and parameters
that apply to EKM running in service mode are defined in
wrapper.conf itself.
Most settings in wrapper.conf are processed
each time the EKM service starts, and do not require re-registration
of the EKM service to take effect. A few settings are processed
only when the service is registered – these are limited to items
whose parameter names begin with wrapper.ntservice – these have to do with the Windows service definition itself
and generally do not need to be changed.
If you need to modify any environment variables or parameters for the EKM service, follow these steps:
Stop the EKM service.
Edit JBOSS_HOME/domain/configuration/wrapper.conf
Start the EKM service.