Controlling Service Startup

The server software has a framework component that handles all communication between the client application and the modules. On Windows, the framework component is a service. On UNIX, the framework component is an application, usually run as a daemon.

Windows

By default, the service is configured for automatic startup, which means that it will restart automatically when the computer is rebooted. When started this way, the service runs unattended and the server computer can be logged off without affecting the service. You can use the Windows Services Control Panel to change the service startup parameters. See the topic Services Control Panel for more information. If you are running multiple instances, the Services Panel will include an entry for each server instance.

Note: If the server computer does not support the localhost IP address (127.0.0.1/::1), then you must create a system environment variable that is named STATS_LH_OVERRIDE and set its value to YES before you start the server. For information on starting and stopping the server, see Starting and Stopping the Server Software.

UNIX

A startup script, start_statistics_server, is included in the /bin subdirectory of the installation directory. The script calls statsenv.sh to configure the environment for the server software and then starts the application. You must start the server software with this script. The startup script must be run from the /bin subdirectory. To execute it, you must be logged in as root if using the default unix authentication or the Pluggable Authentication Module (PAM) . Otherwise, you must be logged in as the user who owns the server software daemon. For more information about authentication, see the topic Authentication. The command:

./start_statistics_server -d

will start the server software as a daemon process, which is the recommended way to run the server software.

If you are running multiple instances of the server software, this command will start the default instance. To start another instance, specify the instance group with the -g switch:

./start_statistics_server -d -g <groupname>

where <groupname> is the instance group name.

Note: If the server computer does not support the localhost IP address (127.0.0.1/::1), then you must set the environment variable STATS_LH_OVERRIDE to YES before you start the server. STATS_LH_OVERRIDE is set from statsenv.sh, which is included in the /bin subdirectory of the installation directory. For information on starting and stopping the server, see Starting and Stopping the Server Software.