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

Engineering Knowledge Manager

Installation Guide | Chapter 15: Appendices |

15.7. Appendix G: Changing the MySQL Database Server Port |  | 15.9. Appendix I: Updating EKM Server Objects
Prev |  | Next

## 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.

Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Prev | Up / Contents | Next

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