Administering the Siebel Gateway Name Server System Service

The Siebel Gateway Name Server authenticates any client attempting to access configuration information. You set up the method of authentication during initial configuration.

Occasionally, you must stop and restart the Siebel Gateway Name Server system service for maintenance purposes. Restart the system service only when it is necessary.

This topic includes the following information:

"About Siebel Gateway Name Server Authentication"
"Administering the Siebel Gateway Name Server System Service on Windows"
"Administering the Siebel Gateway Name Server System Service on UNIX"

About Siebel Gateway Name Server Authentication

This topic provides an overview of Siebel Gateway Name Server Authentication. All of the server and client side executable programs that connect to the Gateway Name Server, including the Siebel Server, pass a user name and password to the Gateway Name Server for authentication. Setup of this service is done at the time of initial configuration and requires no additional configuration unless, for instance, you change a data source, or chose to use a different means of authentication than that specified during initial configuration.

Configuration changes like these are made in the namesrvr.cfg file, which is located in the GTWYSRVR_ROOT/bin subdirectory of the Siebel Gateway Name Server installation. For more information about authentication for the Siebel Gateway Name Server, see the Siebel Installation Guide for the operating system you are using and Siebel Security Guide. This topic is part of "Administering the Siebel Gateway Name Server System Service".

Administering the Siebel Gateway Name Server System Service on Windows

This topic describes how to start, stop, and check the status of the Siebel Gateway Name Server system service on Windows. This topic is part of "Administering the Siebel Gateway Name Server System Service".

Starting the Siebel Gateway Name Server System Service on Windows

This procedure describes how to start the Siebel Gateway Name Server system service on Windows.

To start the Siebel Gateway Name Server system service on Windows

Right-click My Computer.
Click Manage.

The Computer Management panel appears.
In the Computer Management tree, expand Services and Applications.
Click Services.
In the details panel, scroll through the list of services and select Siebel Gateway Name Server.
Right-click Siebel Gateway Name Server and select Start.

Windows starts the Siebel Gateway Name Server system service. This operation might take a few seconds. After the service has started, the Status field changes to Started.

Stopping the Siebel Gateway Name Server System Service on Windows

This procedure describes how to stop the Siebel Gateway Name Server system service on Windows.

To stop the Siebel Gateway Name Server system service on Windows

Right-click My Computer.
Click Manage.

The Computer Management panel appears.
In the Computer Management tree, expand Services and Applications.
Click Services.
In the details panel, scroll through the list of services and select Siebel Gateway Name Server.
Right-click Siebel Gateway Name Server and select Stop.

The Stop Other Services dialog box now appears and asks whether you want to stop the Siebel Server system service.
Click Yes.

Windows stops the Siebel Gateway Name Server system service. This operation might take a few seconds. After the service has stopped, the Status field is blank.

Checking the Status of the Siebel Gateway Name Server System Service on Windows

This procedure describes how to check the status of the Siebel Gateway Name Server system service on Windows.

To check the status of the Siebel Gateway Name Server system service on Windows

Right-click My Computer.
Click Manage.

The Computer Management panel appears.
In the Computer Management tree, expand Services and Applications.
Click Services.
In the details panel, scroll through the list of services and select Siebel Gateway Name Server.

A value of Started in the Status field for the specified service indicates that the system service is running for the Siebel Gateway Name Server. If the Status field is blank, then the system service is not currently running.

Administering the Siebel Gateway Name Server System Service on UNIX

This topic describes how to start, stop, and check the status of the Siebel Gateway Name Server system service on UNIX. This topic is part of "Administering the Siebel Gateway Name Server System Service".

Starting the Siebel Gateway Name Server System Service on UNIX

This procedure describes how to start the Siebel Gateway Name Server system service on UNIX.

To start the Siebel Gateway Name Server system service on UNIX

Log in as the Siebel Service owner user.
Run the siebenv.sh or siebenv.csh script to set Siebel environment variables. For more information about these scripts, see Siebel Installation Guide for UNIX.
Enter the following command:
```
start_ns
```
With some of the available command-line flags, you can do the following:
- To specify the Siebel root directory, use the -r flag, as follows:
```
start_ns -r siebel_root
```
  Typically, you do not have to use this flag, because the SIEBEL_ROOT environment variable is set by the siebenv.csh (or siebenv.sh) script. If the variable is not set, 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 flag, as follows:
```
start_ns -a
```
  Typically, use this flag only when invoking the start_ns script from an autostart script. For more information about the autostart script, see Siebel Installation Guide for UNIX.
- To force the startup, use the -f flag, as follows:
```
start_ns -f
```
  This command can be used to make sure that the Siebel Gateway Name Server starts even if it was not previously shut down completely. This flag is typically not needed.

Stopping the Siebel Gateway Name Server System Service on UNIX

This procedure describes how to stop the Siebel Gateway Name Server system service on UNIX.

To stop the Siebel Gateway Name Server system service on UNIX

Log in as the Siebel Service owner user.
Run the siebenv.sh script in the current shell process, as follows:
```
. ./siebenv.sh
```
Enter the following command:
```
stop_ns -r siebel_root -f
```
With some of the available command-line flags, you can do the following:
- To specify the Siebel root directory, use the -r flag, as follows:
```
stop_ns -r siebel_root
```
  Typically, you do not have to use this flag, because the SIEBEL_ROOT environment variable is set by the siebenv.csh (or siebenv.sh) script. If the variable is not set, 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 flag, as follows:
```
stop_ns -f
```
  This flag causes the Siebel Gateway Name Server to shut down sooner, but it might not shut down completely. In general, use the -f flag only if the Siebel Gateway Name Server did not respond to the unforced shutdown in a timely manner.

Checking the Status of the Siebel Gateway Name Server System Service on UNIX

This procedure describes how to check the status of the Siebel Gateway Name Server system service on UNIX.

To check the status of the Siebel Gateway Name Server system service on UNIX

Enter the following command:
```
list_ns
```
To specify the Siebel root directory, use the -r flag, as follows:
```
list_ns -r siebel_root
```
Typically, you do not have to use this flag, because the SIEBEL_ROOT environment variable is set by the siebenv.csh (or siebenv.sh) script. If the variable is not set, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Gateway Name Server is configured.