ODXSRVR

Windows Service

On a Windows Server, Omnidex Network Services can be set up as a Windows service or run manually (interactively) as needed. Both have advantages and disadvantages that should be weighed carefully.

Manually Started Listener (All Platforms)

• Can have multiple listeners running at the same time.
• Each listener can be configured differently.
• Can create scripts to set environment variables and run the listener.
• Configuration file is optional depending on the desired settings.
• Listener must be manually stopped and restarted.

Windows NT Service

• The service can be maintained using the Windows Service Manager.
• This includes starting, stopping and pausing the service.
• The service can be configured to automatically restart every time the system is rebooted.
• A listener process can always be ready for client requests.
• Every client that connects through the service will connect with the same options/permissions.
• Configuration file is required.

In either situation, the Omnidex environment variables must be set prior to starting the listener process.

Setup

The ODXSRVR service uses settings defined in the ODXSRVR configuration file to run the service. Adjust any settings in the configuration file as needed.

Install ODXSRVR as a service by running ODXSRVR from the command line using the -ntsrvaction argument with one of the "INSTALL" options.

odxsrvr c:\omnidex\bin\odxs1232.cfg -ntsrvaction=INSTALL

If the ODXSRVR executable and configuration file are not in the system path, the system will not find them at start up and will return an error. You must pass the fully qualified path and file names of both the ODXSRVR executable and configuration file when installing ODXSRVR as a service.

Use the Windows NT Service Manager to maintain (start, stop, pause, continue) the service. Use the "DELETE" command line option to remove the ODXSRVR service.

top

Start the Service

The following commands can be passed with the -ntsrvaction directive to install ODXSRVR as a Windows NT service:

INSTALL
The service is installed but must be started manually.

c:\omnidex\bin\odxsrvr -ntsrvaction=INSTALL c:\omnidex\bin\odxs1232.cfg

INSTALL_AUTO
The service is installed but not started, and will start automatically each time the system reboots.

c:\omnidex\bin\odxsrvr -ntsrvaction=INSTALL_AUTO c:\omnidex\bin\odxs1232.cfg

The INSTALL_START and INSTALL_DEMAND options are no longer supported.

top

Stop the Service

DISC recommends that you use the Windows Service Manager to stop the installed service. However, you can also use the STOP -ntsrvaction option from a DOS prompt.

odxsrvr -ntsrvaction=STOP

top

Maintenance Options

DISC recommends that you use the Windows Service Manager to maintain the installed service. However, the following options are provided to allow maintenance from the command line.

DELETE
This action deletes the previously installed service and removes it from the system registry.

c:\omnidex\bin\odxsrvr -ntsrvaction=DELETE

START
This action starts the previously installed and not currently running service.

c:\omnidex\bin\odxsrvr -ntsrvaction=START

STOP
This action stops the currently running service.

c:\omnidex\bin\odxsrvr -ntsrvaction=STOP

PAUSE
This action pauses the currently running service.

c:\omnidex\bin\odxsrvr -ntsrvaction=PAUSE

CONTINUE
This action restarts the currently paused service.

c:\omnidex\bin\odxsrvr -ntsrvaction=CONTINUE

top