15.8. Appendix H: Configuring Windows Services (Windows Only)

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:

  1. Stop the EKM service.

  2. Edit JBOSS_HOME/domain/configuration/wrapper.conf

  3. Start the EKM service.


Release 18.2 - © ANSYS, Inc. All rights reserved.