Skip to end of metadata
Go to start of metadata

This page contains instructions to help you install GSS Server on Windows.

1. Download and Install the GSS Server

Before you begin, please ensure that you have read the System Requirements section of the GSS Server Installation Guide.

1. Download the GSS Server installation file from GSS Server Download Page.

2. Extract the files from the ZIP Archive (ilerian-gss-server-x.x.zip) to a GSS Server installation directory of your choice. By default, the root directory in your zip file is named "ilerian-gss-server".

2. Prepare your executables

Put your executable files under <GSS_INSTALL_DIR>/repository/executables

Put your jar files under <GSS_INSTALL_DIR>/repository/java

There is a sample executable (echo_executable) exists for replying the request parameters back

3. Configure the server

1. Define your interfaces for the server. By default, HTTP interface for localhost:1655 is already defined.

The configuration file is at: <GSS_INSTALL_DIR>/conf/gss-server.xml. It contains simple definitions as starting point of your configuration.

4. Launch GSS Server

You can start GSS Server via the batch files that are shipped with GSS Server. You can find the following batch files in your installation directory:

  • /bin/gss-server.bat : this starts GSS Server in a Windows console.
  • /bin/install-service.bat : this installs GSS Server as a Windows service. Note that this will not start GSS Server.
  • /bin/uninstall-service.bat : this un-installs the GSS Server Windows service from your machine.
  • /bin/start-gss-server.bat : this starts your installed GSS Server Windows service.
  • /bin/stop-gss-serverbat : this stops your installed GSS Server Windows service

You can run GSS Server in two modes, either in a Windows console or as a Windows service:

Running GSS Server in a Windows console

 Enter the bin subdirectory of your GSS Server installation directory and execute gss-server.bat

Running GSS Server As Service

To run GSS Server as a Windows service, enter <GSS_INSTALL_DIR>/bin directory and execute install-service.bat.

Once you have installed GSS Server as a service, GSS Server will start up automatically every time Windows restarts.

Start GSS Server

After the service is installed,  enter the bin subdirectory of your GSS Server installation directory and execute:

<GSS_INSTALL_DIR>\bin > start-gss-server.bat

5. Stop GSS Server

Enter the bin subdirectory of your GSS Server installation directory and execute:

<GSS_INSTALL_DIR>\bin > stop-gss-server.bat

Changing the user running the GSS Server service — The default behaviour in Windows is to start the service under the 'SYSTEM' user when GSS Server starts up. You can change this behaviour from the 'Services' console available via the 'Control Panel'. Please note, you may need to uninstall the service and re-install it again, if you have just upgraded or re-installed GSS Server.

Next Steps

  • See GSS 101 for fast start concept and configuring your GSS Server.
  • No labels