Siebel Database Upgrade Guide for DB2 for z/OS > Running the Database Configuration Wizard to Perform Upgrade Tasks >

Starting the Siebel Upgrade Wizard

Upgrades: All upgrades.

Environments: All environments.

This topic is part of an upgrade process. See How to Perform a Siebel Database Upgrade.

The Siebel Upgrade Wizard executes the upgrade of the Siebel database. It takes a master configuration file as input. This file contains environment information and a driver filename. The Upgrade Wizard executes the steps in the driver file to perform the upgrade.

As the Upgrade Wizard performs the steps in the driver file, it lists the steps in a state log. The state log is located in \siebsrvr\LOG\process\state where process is the upgrade process, for example upgrep_dev_753 (upgrade from 7.5.3, upgrep process, development environment).

If the Upgrade Wizard encounters an error and exits during an upgrade, you can restart it after correcting the error. The Upgrade Wizard reads the state log and continues the upgrade from the last successfully completed step.

When you run the Database Configuration Wizard under Windows, you are prompted to indicate whether or not you want to start the Upgrade Wizard. When you run the Database Configuration Wizard under UNIX, you must start the Upgrade Wizard manually. For more information on the Siebel Upgrade Wizard, see About the Siebel Upgrade Wizard and Driver Files.

Requirements for Starting the Siebel Upgrade Wizard After Errors

If the Siebel Upgrade Wizard stops due to errors, verify that you have met these requirements before restarting the wizard:

• Carefully review the relevant log files to make sure that your upgrade has completed successfully up to that point.
• If you are continuing a previous and incomplete schema upgrade, do not change the Log Output Directory that you previously selected.
• If problems with your environment prevent the upgrade from restarting, you must restore the database from the prior base version (the version from which you are upgrading).

  If you have to restore your database and restart the upgrade, delete or store the upgrade log files. The files are located in the following directory:

  Windows: SIEBEL_ROOT\log\PROCESS\output

  UNIX: $SIEBEL_ROOT/log/PROCESS/output

  Also delete the state.log file. It is located in the following directory:

  Windows: SIEBEL_ROOT\log\PROCESS\state

  UNIX: $SIEBEL_ROOT/log/PROCESS/state

Starting the Siebel Upgrade Wizard

Use this procedure to start the Upgrade Wizard. See Restarting the Siebel Upgrade Wizard After Pauses for the procedure to restart the Upgrade Wizard after it has paused and Stopping the Siebel Upgrade Wizard for the procedure to stop the Upgrade Wizard.

To start the Upgrade Wizard

1. Navigate to the following directory:

   Windows: SIEBEL_ROOT\bin

   UNIX: $SIEBEL_ROOT/bin

2. Enter the following command from the command line:
   • Windows: siebupg /m master_UPGRADEOPTION_ENVIRONMENT_VERSION_MasterFileType.ucf
   • UNIX: srvrupgwiz /m master_UPGRADEOPTION_ENVIRONMENT_VERSION_MasterFileType.ucf

     where UPGRADEOPTION_ENVIRONMENT_VERSION_MasterFileType is the portion of the upgrade configuration filename that lists the upgrade process, the upgrade environment, the Siebel release from which you are upgrading, and the master file type. The file is located in SIEBEL_ROOT\bin (UNIX: $SIEBEL_ROOT/bin). See About the Siebel Database Configuration Utilities and Database Configuration Wizard for further information.

     NOTE:  Specify either mf_m or mf for the MasterFileType value depending on whether you want to start the manual or automatic portion of an Upgrade Wizard process.

     The following table lists examples of filenames for an upgrade from Siebel CRM version 7.5.3.

     Upgrade Option	Master File Generated
     Development environment upgrep	master_upgrep_dev_753_mf_m.ucf master_upgrep_dev_753_mf.ucf
     Development environment upgphys	master_upgphys_dev_753_mf.ucf
     Prepare for Production	master_prepare_for_production_upgrade.ucf
     Production environment upgrep and upgphys	master_upgrep_prod_753_mf_m.ucf master_upgrep_prod_753_mf.ucf

3. To begin the upgrade, click OK (Windows) or click Enter (UNIX).

   The Upgrade Wizard resumes from the point at which it stopped.