Progress
DataServer
for ORACLE Guide


Starting and Stopping the UNIX Broker Process

Follow these steps to start the broker process on the UNIX host machine:

  1. Start an instance for the supporting ORACLE database.
  2. Set the environment variables in the shell from which you are starting the DataServer. Table 4–2 describes how to set them.
  3. Table 4–2: Environment Variables for the Remote DataServer 
    Variable
    How to Set It
    DSLOGDIR
    The pathname to the log file that Progress uses to keep track of DataServer processes and error messages.
    ORACLE_HOME
    The pathname of the directory where you installed ORACLE.
    ORACLE_SID
    The identifier for the ORACLE instance you are accessing.
    ORASRV
    The name of the executable (including the path) of the ORACLE DataServer.
    PROBRKR
    The pathname to the executable of the broker.
    LD_LIBRARY_PATH
    (Sun Solaris)
    or
    LIBPATH (AIX)
    or
    SHLIB_PATH (HP-UX)
    The identifier of the shared ORACLE libraries. On your UNIX system, if the SETUID bit is on, make sure there is a soft link from /usr/lib pointing to the ORACLE shared libraries.
    Note that ORACLE does not support shared objects on all UNIX platforms. See your ORACLE documentation for more information.
    You must set this environment variable to include $ORACLE_HOME/lib when you run executables that you built with PROBUILD to access ORACLE7 or ORACLE8.

    NOTE: If you change the values of any environment variables, such as ORACLE_SID, ORACLE_HOME, or ORASRV, you must shut down the DataServer processes and restart them.

  4. To start the DataServer broker process, enter the following command at the system prompt on your UNIX host machine. Select the service-name from the list of available services in the /etc/services file for your host:
  5. brokername -H host-name -N network-type -S service-name 
    

    For example, the following command uses the default broker executable. The service name demosv is a service listed in the /etc/services file:

    _probrkr  -H paris -N TCP -S demosv 
    

  6. Stop the DataServer modules by shutting down the broker. Enter this command at the system prompt of the client machine:
  7. proshut -Gw -H host-name -S service-name -N TCP 
    


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095