Administering the Siebel Server System Service

Occasionally, you must stop and restart the Siebel Server system service for certain administrative changes to take effect. Restart the system service only when it is necessary.

Note:

The Siebel Server system service must be running before any Siebel Server can be started.

Administering the Siebel Server also sometimes requires you to start or stop the application container manually, as described in "Starting and Shutting Down a Siebel CRM Deployment". See also the Siebel Installation Guide for the operating system you are using.

This topic includes the following information:

"Administering the Siebel Server System Service on Windows"
"Administering the Siebel Server System Service on UNIX"

Administering the Siebel Server System Service on Windows

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

Starting the Siebel Server System Service on Windows

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

To start the Siebel 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 the Siebel Server system service that you need (the enterprise name and Siebel Server name are indicated within square brackets).
Right-click the Siebel Server system service and select Start.

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

Stopping the Siebel Server System Service on Windows

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

To stop the Siebel 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 the Siebel Server system service that you need (the enterprise name and Siebel Server name are indicated within square brackets).
Right-click the Siebel Server system service and select Stop.

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

Note:
A Microsoft Windows 1053 error might occur during this process. This error does not prevent the Siebel Server system service from stopping.

Checking the Status of the Siebel Server System Service on Windows

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

To check the status of the Siebel 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 the Siebel Server system service that you need (the enterprise name and Siebel Server name are indicated within square brackets).

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

Administering the Siebel Server System Service on UNIX

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

Starting the Siebel Server System Service on UNIX

This procedure describes how to start the Siebel Server system service on UNIX. For this procedure, it is assumed that the Siebel Gateway system service is already running.

To start the Siebel Server system service on UNIX

On the Siebel Server computer, 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.
Run the ps command and check whether the application container for the Siebel Server (javaw daemon process) is running.

If you need to start the application container manually, do so as described in Siebel Installation Guide for the operating system you are using.
Enter the following command:
```
start_server siebel_server_name
```
In this command, siebel_server_name is the name of the Siebel Server.

You can run this script to start the system service for a specified Siebel Server (or servers), either within a specified Siebel Enterprise Server or across Siebel Enterprise Servers defined for the current installation.
- To start multiple servers, enter the names of the Siebel Servers (separated by spaces), or enter all to start all of the Siebel Servers configured under the specified SIEBEL_ROOT on the particular server computer (or all of the Siebel Servers for a particular Siebel Enterprise Server, if the Siebel Enterprise Server name is specified, as described in the use of the -e flag):
```
start_server server1 server2...
start_server all
```
- To specify the Siebel root directory, use the -r flag, as follows:
```
start_server -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 during initial configuration. If the variable is not set, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Server (or servers) run.
- To limit the operation to Siebel Servers in a specific Siebel Enterprise Server, use the -e flag, as follows:
```
start_server -e enterprise server1 server2...
```
  You do not have to use this flag if the SIEBEL_ENTERPRISE environment variable is set in the siebenv.csh (or siebenv.sh) script during initial configuration. If the variable is not set, then you must specify the Siebel Enterprise Server name. To start all of the servers for all of the Siebel Enterprise Servers configured for the SIEBEL_ROOT, do not use this flag (you might also have to unset the SIEBEL_ENTERPRISE environment variable).
  
  For example, to start the Siebel Server system services for the prod01 server in the Siebel Enterprise Server, use a command like the following:
```
start_server -e siebel prod01
```
  To start the Siebel Server system services for the prod01 and prod02 servers in the Siebel Enterprise Server, use a command like the following:
```
start_server -e siebel prod01 prod02
```
- To start only Siebel Servers that are marked with the autostart attribute, use the -a flag, as follows:
```
start_server -a
```
  Typically, use this flag only when invoking the start_server 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_server -f
```
  This flag can be used to make sure that the Siebel Server (or servers) start even if it was not previously shut down cleanly. This flag is typically not needed.

Note:

Do not manually copy or rename the svc.siebsrvr.* filenames or any files in the SIEBSRVR_ROOT/sys directory. Additionally, do not delete the MW* (mainwin) files stored in the /tmp directory while the Siebel Server is running. These files are reused by components in the event of a component restart.

Stopping the Siebel Server System Service on UNIX

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

To stop the Siebel Server system service on UNIX

On the Siebel Server computer, 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_server siebel_server_name

You can run this script to stop the system service for a specified Siebel Server (or servers), either within a specified Siebel Enterprise Server or across all of the Siebel Enterprise Servers defined for the current installation.

To stop multiple Siebel Servers, enter the names of the Siebel Servers (separated by spaces), or enter all to stop all of the Siebel Servers configured under the specified SIEBEL_ROOT (or all of the Siebel Servers for a particular Siebel Enterprise Server, if the Siebel Enterprise Server name is specified, as described in the use of the -e flag), as follows:
```
stop_server server1 server2...
stop_server all
```

To specify the Siebel root directory, use the -r flag, as follows:
```
stop_server -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 during initial configuration. If the variable is not set, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Server (or servers) is running.

To limit the operation to Siebel Servers in a specific Siebel Enterprise Server, use the -e flag, as follows:
```
stop_server -e enterprise server1 server2...
```
You do not have to use this flag if the SIEBEL_ENTERPRISE environment variable is set in the siebenv.csh (or siebenv.sh) script during initial configuration. If the variable is not set, then you must specify the Siebel Enterprise Server name. To stop all of the Siebel Servers for all of the Siebel Enterprise Servers configured for the SIEBEL_ROOT, do not use this flag (you might have to unset the SIEBEL_ENTERPRISE environment variable).

To stop the Siebel Server system service for the prod01 server in the Siebel Enterprise Server, use a command like the following:
```
stop_server -e siebel prod01
```

To force the shutdown, use the -f flag, as follows:
```
stop_server -f
```
This flag causes the Siebel Server to shut down sooner, but might not give all of the components a chance to shut down cleanly. In general, use the force option only if the Siebel Servers did not respond to the unforced shutdown in a timely manner.

Note:

A normal shutdown of the Siebel Server system service on UNIX deletes MainWin page files of the format MW* stored in the /tmp directory. You can safely delete these files if they remain after the Siebel Server shuts down. However, do not delete these files while the Siebel Server is running.

Run the ps command and check whether the application container for the Siebel Server (javaw daemon process) is running.

If you need to stop the application container manually, do so as described in Siebel Installation Guide for the operating system you are using.

Resetting the Siebel Server System Service on UNIX

This procedure describes how to reset the Siebel Server system service on UNIX.

To reset the Siebel Server system service on UNIX

Enter the following command:

reset_server siebel_server_name

Note:

Use this script only if the Siebel Server system service is unable to start after an abnormal shutdown or crash of the Siebel Server computer. Do not use it as part of the normal operation of the Siebel Server.

You can run this script to reset the system service for a specified Siebel Server (or servers), either within a specified Siebel Enterprise Server or across all of the Siebel Enterprise Servers defined for the current installation. The names of one or more Siebel Servers (separated by spaces) must be specified on the command line.

To reset multiple Siebel Servers, enter the names of the Siebel Servers (separated by spaces), or enter all to reset all of the Siebel Servers configured under the specified SIEBEL_ROOT (or all of the Siebel Servers for a particular Siebel Enterprise Server, if the Siebel Enterprise Server name is specified, as described in the use of the -e flag), as follows:
```
reset_server server1 server2...
reset_server all
```
To specify the Siebel root directory, use the -r flag, as follows:
```
reset_server -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 during initial configuration. If the variable is not set, then you must specify the Siebel root directory to indicate the Siebel installation under which the Siebel Server (or servers) is running.
To specify the Siebel Enterprise Server under which the specified Siebel Server (or servers) is configured, use the -e flag, as follows:
```
reset_server -e enterprise server1 server2...
```
You do not have to use this flag if the SIEBEL_ENTERPRISE environment variable is set in the siebenv.csh (or siebenv.sh) script during initial configuration. If the variable is not set, then you must specify the Siebel Enterprise Server name to indicate the Siebel Enterprise Server under which the Siebel Servers are configured. To reset all of the Siebel Servers for all of the Siebel Enterprise Servers configured for the SIEBEL_ROOT, use all for the enterprise variable.

To reset the Siebel Server system service for the prod01 server in the Siebel Enterprise Server, use a command like the following:
```
reset_server -e siebel prod01
```