Skip to main content
Version: Release 23.3

Troubleshoot the Release Service

This topic describes how to troubleshoot the Release service.

Release service does not start​

If the Release service does not start, increase the startup timeout by performing the following steps:

  1. Stop the service.

    Operating systemShortcut
    Microsoft WindowsCtrl + c
    Unix-based systemsCtrl + c

  2. Uninstall Release.

  3. Add a timeout value.

    • Unix-based systems: Go to XL_RELEASE_SERVER_HOME/conf/xlr-wrapper-linux.conf and add the following line: wrapper.startup.timeout=<timeout>
    • Microsoft Windows: Go to XL_RELEASE_SERVER_HOME\conf\xlr-wrapper-win.conf and add the following line: wrapper.startup.timeout=<timeout> Where <timeout> is the startup timeout in seconds.

  4. Save the file.

  5. Reinstall the Release service.

  6. Start the service:

    • Microsoft Windows: Open a terminal, navigate to XL_RELEASE_SERVER_HOME/bin, and execute run.cmd.
    • Unix-based systems: Open a terminal, navigate to XL_RELEASE_SERVER_HOME/bin and execute run.sh.

Release service occasionally fails to start or stop​

The Release service may occasionally fail to stop after a stop command is issued, or start after a start command is issued (as shown in the server log). If these situations occur:

  1. Stop the service:

    Operating systemShortcut
    Microsoft WindowsCtrl + c
    Unix-based systemsCtrl + c

  2. Uninstall Release.

  3. In the XL_RELEASE_SERVER_HOME/conf/xlr-wrapper-linux.conf file, add the following line:wrapper.fork_hack = true

  4. Save the file.

  5. Reinstall the Release service.

  6. Start the service:

    • Microsoft Windows: Open a terminal, navigate to XL_RELEASE_SERVER_HOME/bin, and execute run.cmd.
    • Unix-based systems: Open a terminal, navigate to XL_RELEASE_SERVER_HOME/bin, and execute run.sh.

Release is occasionally killed by service wrapper​

If Release suddenly stops working, inspect the service wrapper logs. The service wrapper process may have killed the Release instance JVM because it did not respond within the configured time period. The configuration option that defines this period is wrapper.ping.timeout and the default time is 30 seconds.

If the JVM heap is large, it may cause a long garbage collection pause when Release is under load. If this occurs, increase the ping timeout to 60 or 120 seconds. You can configure the service wrapper options via XL_RELEASE_SERVER_HOME/conf/xlr-wrapper-linux.conf (on Unix-based systems) or XL_RELEASE_SERVER_HOME\conf\xlr-wrapper-win.conf (on Microsoft Windows) files.

For more information on the service wrapper, see the Java Service Wrapper documentation.

Reinstall the Release Service​

To reinstall Release as a service from your system:

  1. Open a terminal.

  2. Run the following commands:

    Operating systemShortcut
    Microsoft WindowsXL_RELEASE_SERVER_HOME\bin\install-service.cmd
    Unix-based systemsXL_RELEASE_SERVER_HOME/bin/install-service.sh

Uninstall the Release Service​

To remove an installed Release service from your system:

  1. Open a terminal.

  2. Run the following commands:

    Operating systemShortcut
    Microsoft WindowsXL_RELEASE_SERVER_HOME\bin\uninstall-service.cmd
    Unix-based systemsXL_RELEASE_SERVER_HOME/bin/uninstall-service.sh