Siebel Anywhere Administration Guide > Retrieving, Installing, and Testing Upgrade Kits >

Retrieving Upgrade Kits for Siebel Regional Node Servers

Upgrade kits for Siebel Regional Node Server configurations are retrieved automatically by the Siebel Server. These upgrade kits might include a Siebel database schema or user-defined files to be installed with version tracking. This task is a step in Process of Retrieving, Installing, and Testing Upgrade Kits.

For regional databases, the Siebel administrator must take care to distribute the Siebel Database Schema upgrade kit under the correct configuration. The default configuration that ships with Siebel Business Applications is Siebel Regional Server. You can create your own configuration for Regional Node Servers to suit the particular needs of your organization.

Configuring Siebel Regional Node Servers Using the Server Manager GUI

The following procedure describes how to set the correct configuration for Siebel Regional Node Servers using the Server Manager GUI.

To set the correct configuration for Siebel Regional Node Servers

1. Navigate to the Administration - Server Management screen, then the Servers view.
2. From the Siebel Servers list, select the appropriate server, and click on the Server Parameters tab.

   The Server Parameters list appears.

3. Modify the parameters as necessary.

   Modify the server parameter Upgrade Component to your configuration name. This configuration name can be Siebel Regional Server or the name of your custom configuration.

Configuring Siebel Regional Node Servers Using the Server Manager Command Line

The following procedure describes how to set the correct configuration for Siebel Regional Node Servers using the Server Manager command line.

To set the correct configuration for Siebel Regional Node Servers using command line

• From the srvrmgr command line, enter:

  srvrmgr.exe /g gateway_srvr_host /e enterprise /s server_name /u user_name /p password

  change param UpgComponent="Siebel Regional Server" or "name of your custom configuration"

If the version check recognizes a required upgrade, then the Siebel Server fails to start and logs an error message in the siebsrvr.log or repagent_$taskid.log file similar to the following:

Please contact HQ administrator. An upgrade may be required.

With the Regional Node Server and all tasks stopped, the Siebel administrator must manually invoke the Upgrade Wizard.

Manually Invoking the Upgrade Wizard on Windows

The following procedure describes how to manually invoke the Upgrade Wizard on Microsoft Windows.

To manually invoke the Upgrade Wizard on Windows

1. Open a command prompt window on the Windows server where the Regional Node Server is installed.
2. Navigate to the SIEBSRVR_ROOT\BIN directory, where SIEBSRVR_ROOT is the root directory of the Regional Node Server installation.
3. Copy the file siebupg.exe to another directory, and navigate to that directory.
4. Execute the copy of siebupg.exe to start the Upgrade Wizard.

   Follow the prompts on the wizard pages.

5. Restart the Regional Node Server.

   For more information, see Siebel System Administration Guide.

6. Repeat the process from Step 1 on any other Regional Node Server, as appropriate.

Manually Invoking the Upgrade Wizard on UNIX

The following procedure describes how to manually invoke the Upgrade Wizard on UNIX platforms.

To manually invoke the Upgrade Wizard on UNIX

1. Open a shell on the UNIX server where the Regional Node Server is installed.
2. Navigate to the SIEBSRVR_ROOT/BIN directory, where SIEBSRVR_ROOT is the root directory of the Regional Node Server installation.
3. Execute the file srvrupgwiz to start the Upgrade Wizard.

   Follow the prompts on the wizard pages.

4. Restart the Regional Node Server.

   For more information, see Siebel System Administration Guide.

5. Repeat the process from Step 1 on any other Regional Node Server, as appropriate.

If the Upgrade Wizard fails, then an error message is logged. Exit the Upgrade Wizard, correct the condition that caused the error, and restart the Upgrade Wizard using the copy of the siebupg.exe file. Upon restarting, Upgrade Wizard prompts you either to cancel the upgrade, restoring the Regional Node Server to its preupgrade state (if possible), or to retry the upgrade from the point of failure. You must restart the Regional Node Server to initiate a version check to restart the upgrade process. To restart, choose Retry.

The Regional Node Server will be down until you successfully recover from the failed upgrade. This downtime can affect many users. After a successful installation of an upgrade, it will take manual intervention to roll it back.