Running WebSphere Liberty as a service (IBM i2 Analyze 4.0.0 - 4.1.3)

Answer

Use the IBM i2 Analyze Deployment Toolkit to deploy the system as normal and test that everything is working before configuring services.

1. Extract the liberty_service_4.0.0-4.1.3.zip to a directory on disk. The zip contains the following files:
• \service
• \service\bin\server_mod.bat
• \service\install_service.bat
2. Note: the server_mod.bat is a modified version of the server.bat file provided by Liberty (8.5.5.7) in wlp/bin and may not be suitable for other versions.
3. Download the Apache Commons Daemon 1.0.15 binary from http://www.apache.org/dist/commons/daemon/binaries/windows/
4. Extract the contents of commons-daemon-1.0.15-bin-windows.zip to the \service folder extracted previously, giving the following files:
• \service
• \service\amd64
• \service\amd64\prunsrv.exe
• \service\bin\server_mod.bat
• \service\ia64
• \service\ia64\prunsrv.exe
• \service\install_service.bat
• \service\LICENSE.txt
• \service\NOTICE.txt
• \service\prunmgr.exe
• \service\prunsrv.exe
• \service\RELEASE-NOTES.txt
5. For each server in Liberty, i.e. each <install_path>\wlp\servers\<server_name> directory, replacing <server_name> with the appropriate value:
1. Copy the \service folder into it, i.e. to <install_path>\wlp\usr\servers\<server_name>\service
2. In the service folder, modify the install_service.bat file to set the following variables as appropriate for current server:
• @REM Configuration required per server.
• set SERVER_NAME=<server_name>
• set IBM_JAVA_HOME=<install_path>\java
• set LIBERTY_HOME=<install_path>\wlp
3. Note: If using an Intel Itanium processor, you should also modify the set PR_INSTALL command to %SERVICE_HOME%\ia64\prunsrv.exe rather than amd64.
4. From an elevated command prompt (as an Administrator) run the install_service.bat script.
• The service should be created as IBM_Liberty_<server_name> with a Display Name of IBM Liberty <server_name>.
5. Recovery options can be configured through Windows Services (services.msc), if required.
6. Ensure that the "Enable actions for stops with errors" option is checked.
7. The service logs will be created at <install_path>\wlp\usr\servers\<server_name>\logs\service
8. Rename the prunmgr.exe to IBM_Liberty_<server_name>.exe
• The IBM_Liberty_<server_name>.exe can be used to perform further configuration of the Apache Commons Daemon service.
• The name of the executable needs to match the name of the service that it will configure.
6. Start the service(s) and test that they work as configured.