Upgrade Guide > How to Perform a Siebel Database Upgrade >

Process of Upgrading a Siebel Development Environment


Upgrades: All Siebel upgrades.

Environments: Development environment only.

This process is part of a road map. See Road Map for Performing a Siebel Database Upgrade.

This topic lists the steps required to upgrade a Siebel development environment to the current release. Print this topic and use it as a checklist for doing the upgrade.

The topic is divided into sections, each containing a list of numbered steps. Complete each section in the order shown.

Upgrade the Servers

Verify you have identified all the maintenance releases, Fix Packs, and quick-fix patches required for the upgrade. These requirements are located on Oracle's Siebel SupportWeb under Product Documentation > Maintenance Release Guides.

CAUTION:  Do not install a new Siebel Database as part of upgrading the Siebel Enterprise.

To perform the following steps, see the Siebel Installation Guide for the operating system you are using.

  1. Upgrade the Gateway Name Server, Siebel Servers, and Siebel Web Server Extension (SWSE).

    For information upgrading these Siebel Enterprise components, see Siebel Installation Guide for the operating system you are using.

  2. Install the Siebel Database Server files on the Siebel Server you will use to perform the upgrade. You only need to install the database server files for the database type that you are upgrading.
  3. Install language packs for your currently deployed languages and any new languages.
  4. If you have customized the configuration of Enterprise components, such as Siebel Servers, you must manually enter the customizations in the upgraded environment. See Going Live with Siebel Business Applications.

Upgrade Third-Party Software

  1. Upgrade third-party software as required due to dependencies on Oracle's Siebel software or other installed software. For example, you may need to upgrade the following software:
    • Actuate Server (Siebel Reports Server).
    • Operating system software. Some database upgrades require newer versions of AIX or Windows.

Upgrade the RDBMS

  1. If required, upgrade the RDBMS version. Refer to the vendor's documentation to perform the upgrade. For information on supported RDBMS systems, see System Requirements and Supported Platforms on Siebel SupportWeb.

Pre-Upgrade Tasks for the Siebel Database

These steps apply to all database types.

  1. Review guidelines for configuring the RDBMS. See the Siebel Installation Guide for the operating system you are using.
  2. Verify that the Workflow Monitor and Workflow action agents have processed all pending requests.
  3. Stop the Siebel Server and the Siebel Gateway Name Server.
  4. Verify that there are no open database connections.
  5. Perform the tasks in Basic Database Preparations for a Siebel Upgrade.

Pre-Upgrade Tasks for IBM DB2

  1. Perform the tasks in Preparing an IBM DB2 Database for a Siebel Upgrade.
  2. Execute runstats on the Siebel Database. This will improve upgrade performance.

Pre-Upgrade Tasks for Oracle

  1. Perform the tasks in Preparing an Oracle Database for a Siebel Upgrade.
  2. Run the Oracle Analyze command on the Siebel Database. Highly fragmented indexes can cause the upgrade to fail.

Pre-Upgrade Tasks for MS SQL Server

  1. Perform the tasks in Preparing an MS SQL Server Database for a Siebel Upgrade.
  2. Run MS SQL Server statistics. This will improve upgrade performance.

Pre-Upgrade Tasks for Application Data

  1. Perform the tasks in Technical Note 521 on Oracle's Siebel SupportWeb. Table 16 shows the applicability of the tasks in the Technical Note.
Table 14. Tasks in Technical Note 521
Item
Environment

Location and amendment of S_VIEW_WTMPL_IT.ITEM_NUM records

Development, production test, production

Update multi-value group (MVG) and association list applets

Development only

Update unnamed controls in applet web template items

Development only

  1. Perform the tasks in the Technical Notes and Alerts on Oracle's Siebel SupportWeb shown in Table 17.
Table 15. Technical Notes and Alerts
Title
Environment

Technical Note 481

Development only

  1. Perform the tasks in Preparing Siebel Application Data for Upgrade.

Upgrade Siebel Database Schema (upgrep)

  1. Verify that all developers have checked in their projects.
  2. Install Siebel Tools on development workstations. Keep at least one copy of the previous version of Siebel Tools. You will need it to perform repository operations before the repository merge.
  3. Renaming the Siebel Repository.
  4. Back up the development database. (If you backed up the database as part of an RDBMS upgrade, ignore this step.)
  5. (Optional) Changing the Siebel Database Server Configuration Utilities Language.
  6. Run the Database Server Configuration Utilities:
  7. Review the following topic and perform the procedure if applicable: Identifying and Dropping Obsolete Indexes for a Siebel Upgrade.
  8. Edit generated SQL files as required by Siebel Technical Notes, Alerts, Release Notes or other publications. For a complete list, see the Installation and Upgrade Portal page on Oracle's Siebel SupportWeb.
  9. Resume the upgrade: Starting the Siebel Upgrade Wizard.
  10. Review the upgrade logs and resolve errors:
  11. If the upgrade contains unacceptable errors, do the following:
    1. Restore the backup of the database.
    2. Correct the errors.
    3. If errors occurred because you entered incorrect information in the Database Server Configuration Utilities, see Regenerating SQL Files for a Siebel Upgrade.
    4. Rerun the Database Server Configuration Utilities.
  12. Multilingual deployments: Perform the steps in Technical Note 447 on Oracle's Siebel SupportWeb to import language-specific repository strings and seed data into the upgrade repositories.
  13. Back up the upgraded database.

Prepare for Repository Merge

  1. Set the Upgrade Ancestor property for copied objects. See Configuring Siebel Repository Objects to Inherit Upgrade Behavior.
  2. Configuring Siebel Tools for the Repository Merge.
  3. (IBM DB2 and MSSQL Only) Run database statistics on the Siebel Database. If upgrading from Siebel 7.0.x or 7.5.x, run statistics specifically on S_SYM_STR and SYM_STR_INTL.

    Running statistics on the Siebel Database improves merge performance.

Perform Repository Merge

Use the upgraded version of Siebel Tools to perform these tasks.

  1. Performing a Siebel Repository Merge.
  2. Determining if a Siebel Repository Merge was Successful.
  3. If the repository merge contains unacceptable errors, do the following:
    1. Restore the backup of the upgraded database.
    2. Correct the errors.
    3. Rerun the repository merge.
  4. Running the Siebel Postmerge Utilities.
  5. Generating Siebel EIM Temporary Columns.
  6. Reset Siebel Tools configuration. See Configuring Siebel Tools for the Repository Merge.
  7. Back up the Siebel Database.

Upgrade Custom Database Schema (upgphys)

  1. Run the Database Server Configuration Utilities:
  2. Review the upgrade logs and resolve errors:
  3. If the upgrade contains unacceptable errors, do the following:
    1. Restore the backup of the database you made after the repository merge.
    2. Correct the errors.
    3. Repeat the steps beginning after the backup.
  4. Manually Archiving Siebel Upgrade Log Files.
  5. Back up the upgraded database.

Initialize and Extract Developers' Local Databases

  1. Install the new release of Siebel Tools on developer's machines.
  2. Initialize and extract the local database on development machines. For more information, see Developing and Deploying Siebel Business Applications.

Review the User Interface

  1. Reviewing Siebel Repository Object Property Conflicts
  2. Review the following topics on UI upgrade before proceeding:
  3. If you performed an ICL upgrade and chose Label on Top, revise the cascading style sheet. See Setting Label Alignment for Siebel Text Fields.
  4. Optional. Create a new SRF file to assist in UI testing. For information on creating an SRF file see Developing and Deploying Siebel Business Applications.
  5. Perform the tasks in Reviewing the Siebel User Interface.
  6. The postmerge utilities do not convert certain types of flow-based applets to grid-based applets. For example, they do not convert custom form applets to grid-based applets. See the "Editing Applet Layout" portion of Configuring Siebel Business Applications and convert remaining flow-based applets as desired.

Postmerge Development Tasks

  1. Perform the tasks in Siebel Postmerge Development Tasks.
  2. Resolve any business component and join conflicts.

Postupgrade Tasks for Database and File System

  1. Perform the tasks in Postupgrade Tasks for the Siebel Database and File System.
  2. Reset upgrade-specific database and database server parameters back to their recommended settings for production. See Siebel Installation Guide for the operating system you are using for recommended parameter settings.
  3. If you exported data from interface tables before the upgrade, review the database and import the data as desired.
  4. Upgrading to Siebel RC2 or AES Encryption.
  5. Generate a Siebel Remote database template file. See Siebel Remote and Replication Manager Administration Guide.
  6. (Oracle database 9i and later). Set Optimizer Mode to CBO.
  7. Run database statistics.

NOTE:  The upgrade is complete. The remaining sections deal with configuration and validation tasks.

Postupgrade Tasks for Applications Configuration

  1. If applicable, review the results of the Person and Organization merge. Make configuration changes as required. To determine applicability or obtain more information, see About the Siebel Party Model.
  2. Perform the tasks in Postupgrade Tasks for Siebel Applications.
  3. Verify the function of interfaces in integrated applications.
  4. Activate and deploy workflows.
  5. If you have set up integrations for transferring data to or from third-party applications using Siebel EAI, verify the integrations are configured correctly. For information on EAI, see Overview: Siebel eBusiness Application Integration Volume I.
  6. If you have used EIM to set up batch processing jobs, verify EIM is configured correctly. For information on EIM, see Siebel Enterprise Integration Manager Administration Guide.

System Tests

  1. Use available test data to perform unit testing. Validate application function in the following areas:
    • User interface
    • Data interfaces
    • Integrity of migrated data
    • Workflow function

Prepare for Transition to Production Test Environment

  1. Create a new SRF file. For information on creating an SRF file see Developing and Deploying Siebel Business Applications.
  2. Regenerate the custrep.dat and schema.ddl files. See Regenerating the Siebel Repository Definition Files.
Upgrade Guide Copyright © 2006, Oracle. All rights reserved.