Setup & Configuration of EPM Integration Agent as a Windows service

The EPM Integration Agent can be installed as a Windows service. This enables you to run the agent in using its’ own Windows session. This is especially beneficial when the windows servers are restarted we can automatically start the EPM agent service. Further, as needed, we can additionally pause and manually restart the EPM agent windows service. On Linux computers, the EPM Integration Agent is started as a background process.

Please note the following:

• The agent name must be specified in the params.ini file. It cannot be passed as a parameter in the Install command.
• During execution the service logs are present in the agents EPM_APP_DATA_HOME\logs folder with the name <serviceName>_<agent_name>_Service_<date>.log. This log contains all the console.
• To display help, use the option EPMAgentService.exe -help or double click EPMAgentService.exe in Windows Explorer.
• When installed, you can start and stop the service as a Windows service from the Windows services console.
• Multiple agent services with a different service name, agent name and port can be created and run simultaneously.
• Always check the log file after starting the service.

To setup up the Windows Service:

1. Open Command Prompt as an Administrator. Type below command and hit enter.

2. You will see the service created in service.msc as below.

3. The status for the agent will be stored in the log under the path and filename.

 If successful, the agent should be available as a Windows service.

The display name will be generated with same as the service name. The service is set to manual and the account which runs the service will be local system, so you may want to update the service configuration to fit your requirements.

4. Once the agent has been started, there will be “EPMAgentService.exe” as a process which will have the agent Java process running as a child process.

5. It is possible to run multiple agents as Windows services on the same machine.
   

Multiple services will now be available.

6. There will be a separate agent log for each Windows service.

To change the dislay name of the service:

1. If you want to update the display name for the Windows service, this can be achieved easily through command line.

The display name will be updated.

To remove the service:

1. To remove an agent as a Windows service, the following syntax can be used:EPMAgentService -uninstall <windows_service_name>

A log will have been generated with further details.

Pratik Alde

Links

• Using the EPM Integration Agent