In productive environments it is recommended to run the Axon.ivy Engine as a service.
bin/AxonIvyEngineService.exe is the implementation of
Axon.ivy Engine as Windows Service. It can also be used as command
line tool to register, unregister, start and stop Axon.ivy Engine
as Windows Service. The command line tool must run as administrator.
Register Axon.ivy Engine as Windows Service
AxonIvyEngineService.exe -register [windowsServiceName] [username] [password]
Unregister Axon.ivy Engine as Windows Service
AxonIvyEngineService.exe -unregister [windowsServiceName]
Start the Windows Service
AxonIvyEngineService.exe -start [windowsServiceName]
Stop the Windows Service
AxonIvyEngineService.exe -stop [windowsServiceName]
windowsServiceNameis always optional and set by default to Axon.ivy Engine.
usernameis optional and defines under which user the windows service should run.
passwordis mandatory if
usernameis set and defines the password for the given user.
You can also use the Control Center to register, unregister, start and stop the Axon.ivy Engine Windows Service.
The install service program
InstallService.sh helps to install the
Axon.ivy Engine as a systemd Linux daemon. To install the service:
Run following command as root:
Accept the directory of your engine installation.
Set the user and group under which the Engine service should run. Must not be root. Typically, a special user with limited access right should be used.
Start the Engine service with
systemctl start AxonIvyEngine.serviceto check if it works.
Check the current status of the service with
systemctl status AxonIvyEngine.service
If you want to start the Engine service on the system start, execute following command:
systemctl enable AxonIvyEngine.service
For more information about systemd services consult
man systemd and