Siebel System Administration Guide > Administering Server System Services > Administering the Siebel Gateway Name Server System Service >

Siebel Gateway Name Server System Service on UNIX

This section describes how to start, stop, and check the Siebel Gateway Name Server System Service on UNIX.

To start the Siebel Gateway Name Server System Service on UNIX

1. Log in as the Siebel Service owner user.
2. Run the siebenv.sh or siebenv.csh script to set Siebel environment variables. For more information on these scripts, see the Siebel Installation Guide: Servers, Mobile Web Clients, and Tools for UNIX.
3. Enter:

   start_ns

   • To specify the Siebel root directory, use the -r switch by entering:

   start_ns -r siebel_root

   Typically, you do not need to use this switch, because the SIEBEL_ROOT environment variable is set by the siebenv.csh (or siebenv.sh) script. If this is not the case, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Gateway Name Server runs.

   • To start the Siebel Gateway Name Server only if currently marked with the autostart attribute, use the -a switch by entering:

   start_ns -a

   Typically, this flag should only be used when invoking the start_ns script from an autostart script. For more information on the autostart script, see Siebel Installation Guide: Servers, Mobile Web Clients, and Tools for UNIX.

   • To force the start up, use the -f switch by entering:

   start_ns -f

   This can be used to make sure that the Siebel Gateway Name Server starts even if it was not previously shut down completely. This switch is typically not needed.

To stop the Siebel Gateway Name Server System Service on UNIX

1. Log in as the Siebel Service owner user.
2. Run the siebenv.sh script in the current shell process as follows:

   . ./siebenv.sh

3. Enter:

   stop_ns -r siebel_root -f

   • To specify the Siebel root directory, use the -r switch by entering:

   stop_ns -r siebel_root

   Typically, you do not need to use this switch, because the SIEBEL_ROOT environment variable is set by the siebenv.csh (or siebenv.sh) script. If this is not the case, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Gateway Name Server is running.

   • To force the shutdown, use the -f switch by entering:

   stop_ns -f

   This causes the Name Server to shut down sooner, but it may not shut down completely. In general, the -f switch should only be used if the Name Server did not respond to the nonforced shutdown in a timely manner.

To check the status of the Siebel Gateway Name Server System Service on UNIX

• Enter:

  list_ns

  To specify the Siebel root directory, use the -r switch by entering:

  list_ns -r siebel_root

  Typically, you do not need to use this switch, because the SIEBEL_ROOT environment variable is set by the siebenv.csh (or siebenv.sh) script. If this is not the case, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Gateway Name Server is configured.