Siebel Database Upgrade Guide > Upgrading the Siebel Database >

Running the Siebel Database Configuration Wizard on UNIX

Environments: Development, production test, production.

Platforms: UNIX only.

Run the Database Configuration Wizard to upgrade the Siebel database. The Wizard collects information, populates a master configuration file, and calls the SQL generator to create SQL commands. You then run the Upgrade Wizard to upgrade the Siebel database.

Prior to running the Database Configuration Wizard you must install the new release's languages packs for each language that you deploy.

Requirements

• Collect the information that the Database Configuration Wizard requires. See Preparing to Run the Siebel Database Configuration Wizard.
• Install the new release's languages packs for all deployed languages. See Upgrade Planning for Multilingual Siebel Deployments.
• Run the Database Configuration Wizard as described in this topic. All customers must perform this procedure. This procedure allows you to determine whether you have deployed languages that are not shipped with the Siebel product, or have unintended languages within your system that must be removed. For a list of shipped languages, see 1513102.1 (Article ID) on My Oracle Support.

  NOTE:  If this procedure fails due to the presence of unshipped languages within your system, then you will receive an error message stating that your present installation was found to be incomplete. You are also displayed a list of languages which caused the error.

  If your system only contains shipped languages, and you still receive this error message, then you must review the records in the S_LST_OF_VAL database table using Siebel Tools. For more information, see Preparing for a Multilingual Upgrade.

• If applicable, perform the tasks in Process of Deleting Unshipped Languages from the S_LST_OF_VAL Table on UNIX.

  CAUTION:  Perform the tasks in this process only if your configuration operation failed due to unshipped languages being deployed within your system.

  This process allows you to run the configuration utility, validate all data in shipped languages, and pass over all data in unshipped languages. You can manually verify the data in unshipped languages following the successful completion of the Database Configuration Wizard.

For more information about starting the Database Configuration Wizard, see the Siebel Installation Guide for UNIX.

To run the Database Configuration Wizard on UNIX

1. Verify that all servers are stopped:
   • Stop all Siebel Servers.
   • Stop the Siebel Gateway Name Server.
2. Make $SIEBEL_ROOT the current directory.
3. Source the environment variables from the siebsrvr root directory: install_location/siebsrvr:

   Korn shell: . siebenv.sh

   C shell: source siebenv.csh

4. Review the values of the following environment variables and confirm the settings are correct:
   • SIEBEL_ROOT. This path must end in siebsrvr. For example, /usr/siebel/siebsrvr.
   • LANGUAGE. This is the language in which the Database Configuration Wizard runs. The value of this variable is a language identifier string. For example, enu is the identifier string for English.

     If either $SIEBEL_ROOT or $LANGUAGE is not set or is incorrect, then you must correct them before proceeding.

5. Start the Database Configuration Wizard:

   install_location/config/config -mode dbsrvr

6. Enter the information requested in each screen and click Next.

   After you have entered all the requested information, the wizard displays a screen that lists the values you entered.

7. If you must make changes, then click Back.
8. If you are performing a development upgrep or combined production upgrep and upgphys, then do not start the Upgrade Wizard. Instead, return to the upgrep process checklist and perform the next steps.
9. If you are performing any of the following, then enter the command to start the Upgrade Wizard:
   • Development environment upgphys.
   • Additive Schema Changes. The Upgrade Wizard creates the schema.additive.sql script.
   • Prepare for Production.
10. The Database Configuration Wizard will now exit and prompt you to launch the Upgrade Wizard (srvrupgwiz).