Command Line Options - UNIX Data Server

Starting the Data Server Manually

At the host server console, do the following to start the Data Server:

  1. Move to the Data Server directory.

  2. Enter pro5.server, along with any of the following optional command line switches:

    Switch

    Description

    -cconfigfile

    Specifies a configuration filename and path to override the config.bbx file contained in the /usr/basis/pro5 directory.

    -e

    In Rev 5.0 and higher, this option enables Secure Sockets Layer (SSL). This option requires all clients using the data server to enable SSL for encrypting the data going to and from the data server.

    Note 1: All client configurations require SSL in the data server prefix as follows: /<server,ssl>/path.

    Note 2: This SSL implementation protects the data from packet sniffing but may not protect the data from a "man in the middle attack" (a computer that pretends to be the data server, participates in the SSL key negotiation, decrypts and re-encrypts the data, and forwards it to the real data server). A "man in the middle attack" requires tampering with things like routers, DNS servers, DHCP servers, and wiring and is more difficult to accomplish than a packet-sniffing or eavesdropping attack.

    -h

    Displays usage information.

    -?

    Displays usage information.

    -k

    Enables the SO_KEEPALIVE socket flag that prevents automatic termination of a network socket connection during periods of inactivity. Must be used when PRO/5 is invoked.

    -llogfile

    Specifies a log file path and filename to override the default log file created by the -r option.

    -pportnum

    Specifies an alternate port number to override the port number listed in the /etc/services file.

    -q

    Initial connection queue size.

    -r

    Enables the logging function, which is helpful for debugging and security audits. It creates a text file named /usr/adm/pro5log (unless overridden by the -l option) and logs all Data Server activities. This file must be periodically cleared because it is never cleared by the Data Server.

    -sservicename

    Specifies an alternate service name to override the service name listed in the /etc/services file.

    -t

    Expiration time (in seconds) for hung connections.

    Stopping the Data Server Manually

    Either a superuser or the user that started the Data Server can kill an active Data Server process, as follows:

    1. Determine the Data Server process ID by entering one of the following:

      Operating System

      Command

      BSD-type systems (SunOS, etc.)

      ps -ax | grep pro5.server

      UNIX System V and similar systems

      ps -ef | grep pro5.server

    2. Send a kill signal (SIGTERM) to the process by entering the following, replacing pid with the process ID:

      kill pid