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:
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.
The service is started from the menu as follows:
.
Highlight the Entire Access Service.
Press the 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.
The Entire Access service can be configured to start automatically during a system startup. This can be achieved using the menu as follows:
.
To open the box of the service, double-click the Entire Access Service.
Select the Startup type on the tab General.
The service is stopped from the menu as follows:
.
Highlight the Entire Access Service.
Press the 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.