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 may include a database schema or user-defined files to be installed with version tracking.

For regional databases, the Siebel administrator should be especially careful to distribute the database schema 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.

To set the correct configuration for Regional Node Servers

1. From the application-level menu, select Navigate > Site Map > Administration - Server Management > Servers.
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.

To set the correct configuration for 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"

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

Please contact HQ administrator. An upgrade may be required.

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

To manually invoke the Upgrade Wizard on Windows

1. Open a command prompt window on the Windows server where the Siebel Regional Node Server is installed.
2. Navigate to the SIEBSRVR_ROOT\BIN directory, where SIEBSRVR_ROOT is the root directory of the Siebel 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 launch the Upgrade Wizard.

   Follow the prompts on the wizard pages.

5. Restart the Siebel Regional Node Server.

   See Siebel System Administration Guide for details.

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

To manually invoke the Upgrade Wizard on UNIX

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

   Follow the prompts on the wizard pages.

4. Restart the Siebel Regional Node Server.

   See Siebel System Administration Guide for details.

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

Should the Upgrade Wizard fail, there will be an error message to that effect.

You should 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 Siebel Regional Node Server to its preupgrade state (if possible), or to retry the upgrade from the point of failure. You will need to restart the Siebel Regional Node Server to initiate a version check to restart the upgrade process. If you want to restart, you should choose Retry.

The Siebel 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.