Control Center
The Control Center integrates all tools to configure an engine, register it as a Windows service and to start & stop the installed Axon Ivy Engine.
Launchers
Use one of the following launchers to start the Control Center.
Launcher |
Platform |
Console support |
---|---|---|
|
Windows |
no |
|
Windows |
yes |
|
Linux |
yes |
Start / Stop
To start the Axon Ivy Engine, simply choose the Axon Ivy Engine in the list on the left side and then press the green start button. Alternatively, you can choose the Axon Ivy Engine [Console] from the list to start the engine within a console. Some information about the engine is logged to this console. Please note that closing this console window will terminate the Axon Ivy Engine without shutting it down properly. To stop the engine, click the red stop button.
Register Windows Service
If you’ve installed the Axon Ivy Engine under a Windows operating system, you can register it as a Windows service. To do so, select the entry Axon Ivy Engine [Windows Service] from the list on the left and press the button Windows Service on the right. A dialog will open, prompting you for additional configuration data:
First of all press Register service to register the service and to enable the remainder of the configuration sections.
Note
Service operations (register, unregister, start, stop) may fail because the
current user does not have the required access rights. In this case close the
Control Center and start it again by right clicking on the
ControlCenter.exe
and choose the command Run as
administrator from the context menu. After that, the service operation
should work.
Now you may configure the user under which the service (and therefore the Axon Ivy Engine) will be executed. This can either be the system user or any other user with sufficient rights to start services and access the Axon Ivy Engine installation directory (read and write).
By default, the service start kind is Manually. To start the engine each time Windows is booted, choose the setting Automatically.
The last thing that can be configured are the services that the Axon Ivy Engine depends on. This might be the database management system which hosts the system database or the reverse proxy web server used by the Axon Ivy Engine (IIS or Apache). All the services you add in this list will have to be started before the Axon Ivy Engine, and if any of these services fail to start, the Axon Ivy Engine won’t start, either.
After you have finished the configuration, click Ok. Now you will be able to start the engine from the control center or you may also use the Windows Service Management Console.
Testing the Engine
Once you’ve started the Axon Ivy Engine, try to open the following address in your preferred web browser: http://ServerName:Port/. If a web page with the Axon Ivy logo appears, the installation and configuration of the Axon Ivy Engine has been successful - continue with the next chapter.
Service List Configuration
The Control Center also allows you to configure the Axon Ivy Engine.
Note
The indication whether the program behind an entry in the server list is running or not is only shown for the Axon Ivy Engine binaries of the installation the Control Center belongs to and for any Windows services (including the Axon Ivy Engine services). This applies too for the show console setting because only Axon Ivy Engine binaries can be started in a console (third party applications cannot).
Add first opens a dialog to choose the type for the new entry. You can choose between a normal Axon Ivy Engine setup or to setup an Axon Ivy Engine as a Windows Service. Remove removes the selected entry from the list and Edit allows to edit the configuration for the selected entry in the server list.
In the configuration dialog for a normal application, you can set the base name and/or change the instance name (in the server list the instance name is printed in brackets after the name). Add the server binary (or your third party tool) in the Engine start executable.
If you select the console based binaries (the ones with C at the end of the
file name, e.g. AxonIvyEngineC.exe
) you may tick the check box
Show console. It has no effect for all other binaries.
In the configuration dialog for adding and editing a service entry, you can choose an already existing service from the combo box or set the service name if you have not already registered the service. Set the service binary equivalent to the description above. To simply start and stop existing services from the Control Center, it is not necessary to define the service binary.
Note
The name in this dialog must be exactly the same name used to register the service, otherwise the lookup will fail.