PreviousNext JavaScript must be enabled to correctly display this content
  • Title and Copyright Information
  • Preface
  • 1 What’s New in This Release
    • What’s New in This Release
  • 2 About This Guide
    • About This Guide
    • How to Use This Guide
    • How the Upgrade Topics Are Organized
    • About the Applicability of Siebel Database Upgrade Topics
    • Naming Conventions Used in This Guide
    • About File Paths and Commands in Upgrade Topics
      • Windows Paths
      • UNIX Paths
      • Commands
  • 3 How the Siebel Database Upgrade Works
    • How the Siebel Database Upgrade Works
    • About Supported Siebel Upgrade Paths
    • Supported Upgrade Paths for Siebel CRM
    • Types of Siebel Database Upgrades
      • Single-Step and Two-Step Siebel Repository Upgrades
      • Patch Releases and Incremental Repository Merge
    • About Using Oracle’s Advanced Customer Services
    • About Unicode Support
    • About Siebel Upgrade Environments
      • Mapping Your Environments
      • Development Environment
      • Production Test Environment
      • Production Environment
    • About the z/OS Upgrade
    • About the Staging Database
    • About Siebel Additive Schema Upgrade Changes
      • Types of Changes
      • About Index Creation During the Additive Upgrade Process
      • Implementation of Additive Changes
    • About the Siebel Database Upgrade Process
      • Environment Upgrade Order
      • Flow of the Upgrade Within an Environment
      • Upgrade the Infrastructure
      • Perform Preupgrade Tasks
      • Perform Upgrade Tasks (Development Environment)
      • Perform Upgrade Tasks (Production Test Environment)
      • Perform Upgrade Tasks (Production Environment)
      • Perform Postupgrade Tasks
    • About the Siebel Database Configuration Utilities and Database Configuration Wizard
      • About Running the Upgrade Database Option
      • How the Upgrade Configuration File and SQL Files Are Created
      • How to Locate Master Configuration Files
    • About the Siebel Upgrade Wizard and Driver Files
      • Driver Files
      • How to Locate Upgrade Driver Files and SQL Scripts
    • Job Flow of a Production Database Upgrade
      • Key Members in the DSNHLQ.SIEBEL.EXEC
    • About the JCL Upgrade Jobs
    • About the Override File
  • 4 Planning a Siebel Database Upgrade
    • Planning a Siebel Database Upgrade
    • Planning Resources for Upgrading to Siebel CRM on z/OS
      • Documentation
      • About Oracle’s Advanced Customer Services
    • Planning Changes to the Physical Layout of the Schema
      • New Database Schema Structure Since Siebel CRM Release 7.7.x
      • Preparing a Storage Control File
      • About Moving Table Spaces
    • Testing Before a Production Upgrade
    • Considering Code Page Support
      • About Code Page Conversion
      • EBCDICCodePage Configuration for EBCDIC Database
    • Executing Jobs Using Siebel-Scheduled Mode or Vendor-Scheduled Mode
    • Staging and Target Database Planning
      • DB2 DSNZPARM Settings For the Target Database
    • Obtaining Required Software and Hardware
    • Obtaining Required IBM Utilities
    • About Using the DSNTIAUL Utility
      • About Applying the DSNTIAUL Patch
      • The @@TIAUL USERMOD Patch
      • About DSNTIAUL CCSID Conversion Errors
    • Obtaining Required Security Privileges
    • Planning Backup and Recovery Stages
    • About Creating a Schedule for the Upgrade
    • About Estimating Database Size
    • Upgrading Your DB2 Software
    • Java 21 Update Planning
  • 5 Basic Database Preparations for a Siebel Upgrade
    • Basic Database Preparations for a Siebel Upgrade
    • Verifying Database Configuration
    • Creating Storage Groups
    • Updating Table Space Group Names
    • Process of Preparing the Storage Layout of the Schema
      • Methods of Modifying the Storage Control File
      • Options for Extracting the Storage Control File
      • Extract from Catalog
      • Extract from Catalog and Merge with Template
      • Extracting the Storage Control File
      • Information Required for the Database Configuration Wizard Extract Option
      • Validating the Extracted Storage Control File
      • About Validation Errors
      • Reviewing the Extracted Storage Control File
    • Reviewing EIM Table Partitioning
    • Converting LONG VARCHAR Columns to CLOB Columns
    • Rebuilding Target Tables Containing LONG VARCHAR Columns
      • Sample Code for Generating a List of Tables to Rebuild
    • Backing Up the Database
    • Granting a Siebel User Upgrade Authorization
  • 6 Preparing a Development Environment for a Siebel Upgrade
    • Preparing a Development Environment for a Siebel Upgrade
    • Requirements for Upgrading the Development Environment
    • About Moving Tables
    • Checking In Development Repository Projects
    • Determining Which Template File Was Used During an Extract or Merge
  • 7 Preparing a Production Environment for a Siebel Upgrade
    • Preparing a Production Environment for a Siebel Upgrade
    • Requirements for Upgrading the Production Environment
    • About Moving the Customized Repository and Schema Definition Files
    • Preparing for a Siebel Upgrade Without a Development Environment
  • 8 Performing a Siebel Database Upgrade
    • Performing a Siebel Database Upgrade
    • Modifying siebel.cfg Before Upgrading Siebel Database
    • Creating a New ODBC Data Source Before Upgrading Siebel Database
    • Roadmap for Performing a Siebel Database Upgrade
      • Roadmap for Upgrading from Siebel 7.8.2, 8.0.x or 8.1.1.x
      • Roadmap for Upgrading from Siebel 7.x, 8.0.x or 8.1.1.x Without a Development Environment
    • Process of Planning a Siebel Database Upgrade
    • Process of Upgrading a Siebel Development Environment
      • Searching for Bulletins and Alerts on My Oracle Support
      • Upgrade Third-Party Software
      • Upgrade the Servers
      • Upgrade the RDBMS
      • Preupgrade Tasks for the Siebel Database
      • Preupgrade Tasks for a Development Environment Upgrade
      • Preupgrade Tasks for Application Data
      • Preparing Developers for the Upgrade
      • Upgrade Siebel Database Schema (upgrep)
      • Prepare for Repository Merge
      • Perform Repository Merge
      • Upgrade Custom Database Schema (upgphys)
      • Review the User Interface
      • Postmerge Development Tasks
      • Postupgrade Tasks for Database and File System
      • Postupgrade Tasks for Applications Configuration
      • Perform System Tests
      • Prepare for Transition to Production Test Environment
    • Process of Upgrading a Production Test Environment
      • Searching for Bulletins and Alerts on My Oracle Support
      • Upgrade Third-Party Software
      • Upgrade the Servers
      • Upgrade the RDBMS
      • Preupgrade Tasks for the Siebel Database
      • Preupgrade Tasks for Application Data
      • Preupgrade Tasks for a Production Test Environment Upgrade
      • Prepare for Production
      • Upgrade the Siebel Database Schema (upgrep + upgphys)
      • Postupgrade Tasks for Database and File System
      • Postupgrade Tasks for Siebel Application Configuration
      • Perform System Tests
    • Process of Tuning the Upgrade Performance
      • Set Up the Target Database
      • Upgrade the Target Database Schema (upgrep + upgphys)
      • Tune the Upgrade Files
      • Restore the Target Database
    • Process of Upgrading a Siebel Production Environment
      • Searching for Bulletins and Alerts on My Oracle Support
      • Upgrade Third-Party Software
      • Upgrade the Servers
      • Upgrade the RDBMS
      • Preupgrade Tasks for the Siebel Database
      • Preupgrade Tasks for Application Data
      • Preupgrade Tasks for a Production Environment Upgrade
      • Upgrade the Siebel Database Schema (upgrep + upgphys)
      • Postupgrade Tasks for Database and File System
      • Postupgrade Tasks for Applications Configuration
      • Perform System Tests
      • Deploy to Users
    • Siebel Database Update Process
      • Post Installation Database Update
      • Values Required by Post Installation Database Update
      • Database Configuration in Siebel Enterprise Server Installer
      • Troubleshooting Database Configuration
      • Postpone Running Post Installation Database Update
      • Skip Post Installation Database Update
      • Post Installation Database Update Report
      • Post Installation Database Update Exit Codes
      • Logging and Diagnostics
      • Rerunning Post Installation Database Update
      • How PostInstallDBSetup Fully Workspace Enables List of Values
    • RepositoryUpgrade Utility
      • Running RepositoryUpgrade Utility
      • Independently Apply RepositoryUpgrade Schema Changes
      • Siebel Repository and Workspace Version Tracking
  • 9 Running the Database Configuration Wizard
    • Running the Database Configuration Wizard
    • Example of a Siebel Development Environment Upgrade Flow
    • Information Required by the Database Configuration Wizard
      • Additional Information Required for Production Upgrades
    • About Running the Database Configuration Wizard on Windows
      • Running the Database Configuration Wizard Under Windows
    • About Running the Database Configuration Wizard Under UNIX
      • Running the Database Configuration Wizard Under UNIX
    • Starting the Siebel Upgrade Wizard
      • Requirements for Starting the Siebel Upgrade Wizard After Errors
      • Starting the Siebel Upgrade Wizard
      • Restarting the Siebel Upgrade Wizard After Pauses
      • Stopping the Siebel Upgrade Wizard
    • Upgrading the Repository and Importing Seed Data
      • Restarting the Seed Data Import and Repository Upgrade
    • Fixing Column Alignment for Custom Objects
    • Inactivating Unreferenced Repository Objects
    • Converting Siebel Web Templates with the SWT to OD Conversion Utility
  • 10 Creating the Siebel Staging Database
    • Creating the Siebel Staging Database
    • Process of Creating the Staging Database
    • Required Tasks before Creating the Staging Database
    • Creating the Staging Database Schema DDL Files
    • Transferring the Staging DDL to the z/OS Host
    • Preparing the z/OS Upgrade Environment and Creating the Staging Database
      • Authorization Requirements for Performing Upgrade Procedures on the z/OS Host
      • Customizing the JCL UNIT Parameter Value
      • Creating the z/OS Setup Data Sets
      • Preparing the Upgrade Environment and Building the Staging Database
      • Verifying JCL Upgrade Jobs
    • Removing Interface Tables and Triggers
  • 11 Generating the Siebel Upgrade Files
    • Generating the Siebel Upgrade Files
    • About Generating the Upgrade Files
    • Process of Generating the Upgrade Files
    • Required Tasks for Generating the Upgrade Files
    • Preparing the Additive Schema and JCL Files on the z/OS Host
      • Transferring the Additive Schema, PRET, and Data Migration Files to the z/OS Host
      • Preparing the z/OS Data Sets
      • Preparing the Additive Schema SQL and JCL Templates
    • Applying the Additive Schema Changes to the Production Staging Database
    • Preparing for Table Creation on the Staging Database
    • Preparing and Executing the Nonadditive Schema and JCL Files on the z/OS Host
      • Transferring the Nonadditive Schema, Temp Table, and Load and Unload Files to the z/OS Host
      • Preparing the Nonadditive Schema SQL and JCL Templates and Executing the DDL
      • Applying the Nonadditive Schema Changes
      • Creating the Data Migration Indexes
    • Processing the Index Schema File
      • Transferring the SCINDX.SQL File to the z/OS Host
      • Restructuring the Index DDL
    • Building JCL Templates for the Target Database
  • 12 Upgrading the Target Database
    • Upgrading the Target Database
    • Process of Upgrading the Target Database
    • Dropping Partitioned EIM Tables
      • Sample Code for Generating a List of Table Spaces to Drop
    • Creating and Loading Siebel Log Tables
    • Applying Additive Upgrade Changes to the Target Database
      • Applying Additive Changes Individually
      • Applying the Additive Changes in One Job
    • Renaming the Production Environment Repository
    • Performing the In-Place Target Database Upgrade
      • Accessing the Target Database In-Place Upgrade Menu
      • Preparing the Target Database for the Upgrade
      • Running the PRET Jobs for the Target Database
      • Applying Nonadditive Schema Upgrade Changes to the Target Database
        • Removing Target Database Views
        • Running Unload Jobs on the Target Database
        • Creating the Schema on the Target Database
        • Loading the Schema on the Target Database
        • Executing Index DDL and Rebuilding Indexes
        • Creating and Rebuilding Obsolete Indexes
      • Creating and Deploying Stored Procedures on the Target Database
      • Migrating Data on the Target Database
        • About Migrating Preschm Data
      • Creating Schema Indexes
      • Running the Gen_Primary SQL to Update Data in Target Database Tables
      • Generating RUNSTATS Jobs
    • Restarting Upgrade Jobs That Fail
  • 13 Performing Postupgrade Tasks on the Target Database
    • Performing Postupgrade Tasks on the Target Database
    • Transferring the Development Environment Upgrade Output Files to the z/OS Host
    • Synchronizing the Schema
    • Activating New License Keys After an Upgrade
    • Deleting Redundant Upgrade Files
      • Removing the Staging Database
      • Deleting Unload Data Sets
      • Deleting Stored Procedures
  • 14 Reviewing the Siebel Upgrade Log Files
    • Reviewing the Siebel Upgrade Log Files
    • About the Siebel Upgrade Log Files
      • About the State Log File
      • About Process Log Files
      • How to Determine if the Upgrade Process Completed Successfully
      • Log Files That Can Be Ignored
    • Reviewing Siebel Upgrade Log Files for Errors
    • Manually Archiving Upgrade Log Files
    • Viewing the Siebel Job Log Status
    • Running SQL in Siebel Logs
  • 15 Performing the Siebel Repository Merge
    • Performing the Siebel Repository Merge
    • About Backing Up the New Customer Repository or Database Schema
    • About Reorganizing Tables Before the Repository Merge
    • Performing a Siebel Repository Merge
      • About the Repository Merge
      • Optimizing Performance of the Repository Merge
      • Optimizing Foreground Performance of the Repository Merge
      • Merging the Repositories for an ASCII Database
      • Merging Repositories for an EBCDIC Database
    • Regenerating the Siebel Repository Definition Files
      • Regenerating the schema.ddl File
      • Regenerating the custrep.dat File
    • Generating the Runtime Repository Data
  • 16 Performing the Siebel Incremental Repository Merge
    • Performing the Siebel Incremental Repository Merge
    • About the Siebel Incremental Repository Merge
    • Process of Performing Incremental Upgrade of Siebel Database from Siebel CRM 8.1.1.x
    • Before You Begin
      • About the Siebel Server and Siebel Tools on Windows
    • Performing the Incremental Repository Merge
      • Executing the Incremental Repository Merge Under UNIX
    • Editing the Siebel Tools Configuration File After the Development Environment Merge
  • 17 Postupgrade Tasks for Siebel Database and File System
    • Postupgrade Tasks for Siebel Database and File System
    • Updating File System Attachments
    • Reapplying Schema Customizations to the Siebel Database
      • Reviewing Obsolete Tables
    • Regenerating the Database Template File
  • 18 Postupgrade Tasks for Siebel Business Applications
    • Postupgrade Tasks for Siebel Business Applications
    • Performing Postupgrade Tasks for the Siebel Application
    • Upgrading Siebel Seeded Workflows
  • 19 Tuning the Siebel Production Upgrade Scripts
    • Tuning the Siebel Production Upgrade Scripts
    • About Tuning the Upgrade Scripts
      • Contacting Oracle’s Advanced Customer Services
    • Optimizing Unload and Load Job Performance
    • Adding the Statistics Clause to Load Cards
  • 20 Migration Planning Using Siebel Migration
    • Migration Planning Using Siebel Migration
    • About Migrating with Siebel Migration
    • Roadmap for Planning a Migration with Siebel Migration
    • About Migration Process Orchestration During the Siebel Migration Process
    • About the Process Flow for Migration Resources
    • About the Siebel Migration Log Files
      • How to Locate Siebel Migration Resource Log Files
      • Enabling SQL Tracing for Siebel Database Utilities
    • About REST API Used for Migration Discovery and Execution
  • 21 Data Preparation for Siebel Migration
    • Data Preparation for Siebel Migration
    • Process of Preparing Siebel Application Data for Migration
    • Process of Transforming Data with Siebel Application Deployment Manager
      • Creating an ADM Data Map
      • Associating a Data Map to a Project Item
    • Customizing Siebel Migration Execution and Resource Sequencing
    • Setting Up File Prepare and Deploy
  • 22 Data Migration Using Siebel Migration
    • Data Migration Using Siebel Migration
    • Before You Begin Migrating with Siebel Migration
      • Configure User Access to Siebel Migration Application
    • Process of Using Siebel Migration to Migrate Data
      • Creating a Connection
      • Generating a Watermark
        • Scenario for Using a Watermark
        • Types of Watermarks
      • Creating a Migration Plan
        • Siebel Migration Plan Dependencies
      • Executing a Siebel Migration Plan
        • Renaming Repositories After Full Migration
        • Preprocessing and PostProcessing for Migration Execution
      • Aborting a Running Migration Plan
      • Viewing Migration Log Files
      • Viewing Migration History
        • Query Migration History
        • Cleanup Migration History
    • Asynchronous Migration Using Siebel Migration
    • Incremental Migration from Development to Production Environment Without Using Siebel Migration
    • Full Runtime Repository Migration Without Using Siebel Migration
    • Migrating Repository Changes from Development to Production Environment (Siebel CRM 18.8 or Later)
      • Adding Seed Data to the Target Environment
      • Setting the Seed Migration Priority System Preference
      • Setting the RepVer Column Compatibility System Preference for DB2 Database
      • Migrating User Preferences
    • Migrating Configuration Data and Incremental Changes
    • Managing Cross Version Migration
    • Troubleshooting Data Migration Using Siebel Migration
  • 23 Siebel Upgrade Planning Worksheet
    • Siebel Upgrade Planning Worksheet
    • Team Lead Summary
    • DB2 Connect Information
    • Siebel Development Environment Information
    • Siebel Production Environment Information
    • z/OS Host System Variables Information
  • 24 Columns Denormalized During the Upgrade to Siebel CRM
    • Columns Denormalized During the Upgrade to Siebel CRM
    • Denormalized Columns for Siebel Industry Applications Version 7.5.3
  • 25 Upgrade Files for Siebel Business Applications
    • Upgrade Files for Siebel Business Applications
    • Siebel CRM z/OS Upgrade Files
    • Tables Amended During PRET Unload Processing
    • PRET Members Generated By Pretedit.txt
    • Target Tables Amended During PRET Processing
  • 26 REST API References for Migration Services
    • REST API References for Migration Services
    • Using REST API with the Migration Schema Service
      • Exporting with the Migration Schema Service
      • Getting Status with the Migration Schema Service
      • Importing with the Migration Schema Service
      • Verifying If a Schema Changed with the Migration Schema Service
      • Getting a Watermark with the Migration Schema Service
    • Using REST API with the Migration Incremental Runtime Repository Data Service
      • Getting a Watermark with the Migration Incremental Runtime Repository Data Service
      • Exporting with the Migration Incremental Runtime Repository Data Service
      • Getting Status with the Migration Incremental Runtime Repository Data Service
      • Importing with the Migration Incremental Runtime Repository Data Service
      • Checking a Database with the Migration Incremental Runtime Repository Data Service
    • Using REST API with the Migration Runtime Repository Data Service
      • Getting Runtime Repository Information with the Migration Runtime Repository Data Service
      • Getting a Watermark with the Migration Runtime Repository Data Service
      • Exporting with the Migration Runtime Repository Data Service
      • Getting Status with the Migration Runtime Repository Data Service
      • Importing with the Migration Runtime Repository Data Service
      • Checking a Database with the Migration Runtime Repository Data Service
    • Using REST API with the Migration Incremental Application Workspace Data Service
      • Getting Status with the Migration Incremental Application Workspace Data Service
      • Getting a Watermark with the Migration Incremental Application Workspace Data Service
      • Exporting with the Migration Incremental Application Workspace Data Service
      • Importing with the Migration Incremental Application Workspace Data Service
      • Invalidating Seed Caches with the Migration Incremental Application Workspace Data service
    • Using REST API with Migration Application Workspace Data Service
      • Getting a Seed Copy Watermark with the Migration Application Workspace Data Service
      • Getting the Full Seed Watermark with the Migration Application Workspace Data Service
      • Getting Status with the Migration Application Workspace Data Service
      • Getting a Seed Copy Export with the Migration Application Workspace Data Service
      • Getting a Seed Copy Import with the Migration Application Workspace Data Service
      • Getting the Full Seed Export with the Migration Application Workspace Data Service
      • Getting the Full Seed Import with the Migration Application Workspace Data Service
      • Invalidating the Seed Caches with the Migration Application Workspace Data Service
    • Using REST API with the Migration File Prepare and Deploy Service
      • Exporting with the Migration File Prepare and Deploy Service
      • Getting Status with the Migration File Prepare and Deploy Service
      • Importing with the Migration File Prepare and Deploy Service
      • Generating a Watermark with the Migration File Prepare and Deploy Service
      • Reading the Watermark with the Migration File Prepare and Deploy Service
      • Writing the Watermark with the Migration File Prepare and Deploy Service
    • Using REST API with Siebel Migration Application
      • Using REST API to Configure Siebel Migration Application Connections
        • Getting All Connections
        • Getting a Connection by Name
        • Creating a New Connection
        • Updating the Connection
        • Refreshing a Connection
        • Creating a Watermark for a Connection
        • Deleting a Connection
      • Using REST API to Configure Siebel Migration Application Migration Plans
        • Getting All Migration Plans
        • Getting a Migration Plan by Name
        • Creating a New Migration Plan
        • Updating a Migration Plan
        • Refreshing a Migration Plan
        • Deleting a Migration Plan
      • Using REST API to Execute Siebel Migration Plans
        • Executing a Migration Plan
        • Getting Status for a Running Migration Plan by Name
        • Getting Status for a Running Migration Plan by Plan Name and Resource Name
        • Getting Execution Status by Migration Plan Name, Resource Name, and Operation
        • Getting the Migration Execution Operation Log
      • Using REST API to Get Siebel Migration Plan History
        • Getting All Migration History
        • Getting Migration History by Migration Plan Name
        • Getting Migration History by ID Number
        • Getting Migration History by ID and Resource Name
        • Getting Migration History by ID, Resource Name, and Operation
        • Getting the Migration History Operation Log