Back to Contents

Hot Restart of Genero Web Services

Topics

Overview

The GWS hot restart in the Genero Application Server provides the ability to:

Back to the top

Principles

The hot restart is only available for Web Services defined in external configuration files. It is not available for services defined in the GAS configuration file.

When a hot restart is issued, all current requests are finished properly, after which all new requests are serviced by the new Web service.

Back to the top

Using Hot Restart of Web Services

Step 1: To avoid the overriding of the previous version of the program that still serve the current requests, put the new service in a different directory 

Step 2: Change the external configuration file. For example:

Original Configuration Example:

<?xml version="1.0" encoding="UTF-8"?>
<!-- echo demo service application -->
<APPLICATION Parent="ws.default">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)/WebServices/echo/echoServer</PATH>
    <MODULE>echoServer</MODULE>
  </EXECUTION>
</APPLICATION>

New Configuration Example:

<?xml version="1.0" encoding="UTF-8"?>
<!-- echo demo service application -->
<APPLICATION Parent="ws.default">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)/WebServices/newecho/echoServer</PATH>
    <MODULE>echoServer</MODULE>
  </EXECUTION>
  <TIMEOUT />
</APPLICATION>

In this example, the old service is in echo directory and the new service in newecho directory.

Step 3: Tell the Application Server to reload the modified configuration files:

For Linux, issue the command: kill -1 gasdPID or killall -1 gasd

Instead of number -1, you can use the -SIGHUP keyword.

For Windows, if the Application Server runs in a DOS console, use: Ctrl+Break

To use the Ctrl+Break on windows, in the fglprofile set the entry fglrun.ignoreDebuggerEvent to true, otherwise the Ctrl+Break will be sent to the DVM.

For Windows, if the Application Server runs as a service, use: sc control name_of_gas_service paramchange

For example: 

SERVICE_NAME: fglas_2.10.01_210907122547
        TYPE               : 10  WIN32_OWN_PROCESS
        STATE              : 4  RUNNING
                                (STOPPABLE,NOT_PAUSABLE,IGNORES_SHUTDOWN)
        WIN32_EXIT_CODE    : 0  (0x0)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0

In this example, the service name is fglas_2.10.01_210907122547.

Note:

Back to the top