Using Entire Access as Service under Windows

#### Search Results

Search

# Using Entire Access as Service under Windows

Entire Access can be configured as service so that the Entire Access server can be automatically started during system startup time. The registration of the Entire Access service to the Windows service control manager is already done during the installation of Entire Access.

This section covers the following topics:

- Installing an Entire Access Service under Windows

- Starting the Service

- Starting the Service Automatically

- Stopping the Service

## Installing an Entire Access Service under Windows

The Entire Access service consists of two files which can be found in the Entire Access bin directory after the installation procedure has finished:

- sagosx.exe: This is the service itself.

- sagosx.cfg: This is the service configuration file.

First the service has to be registered to the Windows service control manager.

This is done by typing the command

    sagosx –install

at any command prompt. This step has usually already been performed by the installation procedure.

The service can be de-registered again with the command

    sagosx –remove

This is usually done during the de-installation of Entire Access.

## Starting the Service

The service is started from the Start menu as follows:

Start > Settings > Control Panel > Administrative Tools > Services > Entire Access Service.

1. Highlight the Entire Access Service.

2. Press the Start button of the service.

During the starting process the Entire Access service is executing the commands from the sagosx.cfg configuration file. Per default the relevant part of the configuration file is as follows:

    # Start listener on port 2001
    serversingle.exe -p2001

This command would start a serversingle listener process on port 2001. Generally, lines in the configuration file can either be commands, environment variable settings or comments. Therefore, a more complex example for a configuration file could look like the following example:

    # First set environment variables
    ORACLE_HOME=d:\db\ora12
    ORACLE_SID=mysid
    # Start listener on port 4711
    serversingle.exe -p4711
    # Start second listener on port 4712
    serversingle.exe -p4712

The Entire Access service always searches for the file sagosx.cfg in the same directory where the corresponding sagosx.exe file is located. However, it is possible to specify a Windows environment variable `ENTIRE_ACCESS_SERVICE_FILE` that points directly to the configuration file. When using an environment variable, the file can be located in any desired location; e.g. setting `ENTIRE_ACCESS_SERVICE_FILE=d:\mydir\myfile.cfg` would force the Entire Access service to read the configuration from the file myfile.cfg in the directory d:\mydir.

## Starting the Service Automatically

The Entire Access service can be configured to start automatically during a system startup. This can be achieved using the Start menu as follows:

Start > Settings > Control Panel > Administrative Tools > Services > Entire Access Service.

1. To open the Properties box of the service, double-click the Entire Access Service.

2. Select the Startup type Automatic on the tab General.

## Stopping the Service

The service is stopped from the Start menu as follows:

Start > Settings > Control Panel > Administrative Tools > Services > Entire Access Service.

1. Highlight the Entire Access Service.

2. Press the Stop button of the service.

When the Entire Access service is stopped, all previously started listener processes as specified in the configuration file will also be stopped.

### On this page

- Installing an Entire Access Service under Windows
- Starting the Service
- Starting the Service Automatically
- Stopping the Service