Front cover Acrobat bookmark Migrating Siebel Database from DB2/Oracle for NT to DB2 for OS/390 DB2 for NT to DB2 for OS/390 Oracle for NT to DB2 for NT Oracle for NT to DB2 for OS/390 Viviane Anavi-Chaput Miguel de Andrade Henry Horst Glenn Lacco Jeffrey Wiese Marion Wilmot Alex Yuen ibm.com/redbooks International Technical Support Organization Migrating Siebel Database from DB2/Oracle for NT to DB2 for OS/390 November 2001 SG24-6236-00 Take Note! Before using this information and the product it supports, be sure to read the general information in “Special notices” on page209. First Edition (November 2001) This edition applies to Siebel 2000 Version 6.2.1 for use with Oracle for NT V8.1.6, DB2 for NT V6 and DB2 for OS/390 V6. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. HYJ Mail Station P099 2455 South Road Poughkeepsie, NY 12601-5400 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 2001. All rights reserved. Note to U.S Government Users – Documentation related to restricted rights – Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .ix The team that wrote this redbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .ix Special notice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xi IBM Trademarks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii Chapter 1. Introducing Siebel database migration. . . . . . . . . . . . . . . . . . . . 1 1.1 Siebel architecture and configurations . . . . . . . . . . . . . . . . . . . . . . . . .2 1.2 When should you migrate the Siebel database. . . . . . . . . . . . . . . . . . .2 1.3 Siebel database migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 1.4 Siebel database structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 1.4.1 The repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.4.2 The data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.5 Which tool should you use to move data . . . . . . . . . . . . . . . . . . . . . . .6 1.5.1 Siebel database utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1.5.2 RDBMS-specific database utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.5.3 Data warehousing tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.6 Methodology for migrating to DB2 for OS/390 . . . . . . . . . . . . . . . . . . .7 1.7 Migration scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 Chapter 2. Implementing the target Siebel environment on OS/390. . . . . 11 2.1 Preparing the OS/390 environment for the Siebel database . . . . . . . .13 2.1.1 Checking the maintenance level. . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.1.2 Creating RACF user IDs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.1.3 Creating a large VTOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.1.4 Creating DB2 storage groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.1.5 Customizing DB2 buffer pools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.1.6 Customizing the EDM pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.1.7 Customizing DSNZPARM parameters . . . . . . . . . . . . . . . . . . . . . . . 14 2.1.8 Enabling DB2 stored procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.2 Enabling database connections to DB2 for OS/390 . . . . . . . . . . . . . .16 2.2.1 DDF setup on OS/390. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.2.2 DB2 Connect EE setup on NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.2.3 Client setup on a PC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 2.3 Installing Siebel 2000 on the NT server . . . . . . . . . . . . . . . . . . . . . . .18 2.3.1 Creating required NT user accounts. . . . . . . . . . . . . . . . . . . . . . . . . 18 2.3.2 Creating the Siebel File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.3.3 Installing the Siebel Gateway Server . . . . . . . . . . . . . . . . . . . . . . . . 18 © Copyright IBM Corp. 2001 iii 2.3.4 Installing the Siebel Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.4 Installing the Siebel Database Server on OS/390. . . . . . . . . . . . . . . .18 2.4.1 Installing the database server scripts . . . . . . . . . . . . . . . . . . . . . . . . 18 2.4.2 Creating the Siebel physical schema on OS/390 . . . . . . . . . . . . . . . 19 2.4.3 Importing seed data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.4.4 Importing the Siebel repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 2.5 Populating the File System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 2.6 Installing the Siebel connected client . . . . . . . . . . . . . . . . . . . . . . . . .28 2.7 Testing the installation using Siebel Call Center. . . . . . . . . . . . . . . . .29 Chapter 3. Migrating Siebel data from DB2 for NT to DB2 for OS/390 . . . 31 3.1 Preparing for data migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33 3.1.1 Generating a list of tables to migrate . . . . . . . . . . . . . . . . . . . . . . . . 33 3.1.2 Cleaning up target tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 3.2 Moving data from DB2 for NT to DB2 for OS/390 . . . . . . . . . . . . . . . .35 3.3 Siebel Dataexp/Dataimp - no schema changes . . . . . . . . . . . . . . . . .36 3.3.1 Exporting data with Dataexp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 3.3.2 Importing data with Dataimp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 3.3.3 Validating the migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 3.4 Siebel EIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 3.4.1 EIM export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 3.4.2 Dataexp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 3.4.3 Dataimp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 3.4.4 EIM Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 3.5 DB2 for NT Import/Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46 3.6 DB2 for OS/390 DSNTIAUL and LOAD . . . . . . . . . . . . . . . . . . . . . . .47 3.7 DB2 family cross-loader function . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 Chapter 4. Migrating Siebel data from Oracle for NT to DB2 for NT. . . . . 53 4.1 Test configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54 4.2 Migrating Siebel data from Oracle for NT to DB2 for NT. . . . . . . . . . .55 4.2.1 Siebel Dataexp/Dataimp - with schema changes . . . . . . . . . . . . . . . 55 4.2.2 Siebel Dataexp/Dataimp - no schema changes . . . . . . . . . . . . . . . . 67 4.2.3 Siebel EIM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Chapter 5. Migrating Siebel data from Oracle for NT to DB2 for OS/390 . 73 5.1 Two-phase migration - Oracle for NT to DB2 for OS/390 . . . . . . . . . .74 5.2 One-phase migration - Oracle for NT to DB2 for OS/390 . . . . . . . . . .75 5.3 Dataexp/Dataimp - no schema changes. . . . . . . . . . . . . . . . . . . . . . .76 5.4 Dataexp/Dataimp - with schema changes. . . . . . . . . . . . . . . . . . . . . .76 5.4.1 Verifying object names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 5.4.2 Consolidating object names before the migration. . . . . . . . . . . . . . . 77 5.4.3 Consolidating object names during the migration. . . . . . . . . . . . . . . 78 5.5 Dataexp/FTP/DB2 Load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80 iv Migrating Siebel Database from DB2/Oracle for NT to DB2 for OS/390 5.6 Relational Connect/DB2 LOAD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83 Appendix A. Implementing the Siebel source environment on NT. . . . . . 89 Setting up a source environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90 Installing the base NT software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Installing Microsoft Windows NT 4.0 server . . . . . . . . . . . . . . . . . . . . . . . . 91 Installing Microsoft Office 2000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Installing Adobe Acrobat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Installing Internet Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Installing DB2 for NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Creating the DB2 startup account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Installing the DB2 server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Installing the Siebel 2000 DB2 for NT Fix Pack . . . . . . . . . . . . . . . . . . . . . 94 Verifying the DB2 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Configuring DB2 for Siebel 2000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 DB2 Database Manager configuration parameters. . . . . . . . . . . . . . . . . . . 96 Setting the DB2 environment parameters. . . . . . . . . . . . . . . . . . . . . . . . . . 97 Creating the initial DB2 database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Creating the skeleton Siebel database. . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Creating the initial buffer pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Verifying the buffer pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Creating the regular and temporary table spaces. . . . . . . . . . . . . . . . . . . . 99 Verifying the table spaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Configuring the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Creating required NT user accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Creating the Siebel File System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Installing the Siebel Gateway Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Installing the Siebel Gateway Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Starting the Siebel Gateway Server NT service . . . . . . . . . . . . . . . . . . . . 103 Inspecting the Gateway Server directory . . . . . . . . . . . . . . . . . . . . . . . . . 103 Installing the Siebel Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Installing the Siebel Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Inspecting the Siebel Server directory . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Starting the Siebel Server NT service. . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Verifying the Siebel Server ODBC data source . . . . . . . . . . . . . . . . . . . . 106 Installing the Siebel Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Installing the Siebel Database Server scripts . . . . . . . . . . . . . . . . . . . . . . 107 Granting database privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Configuring the Siebel DB2 instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Installing the stored procedures code. . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Initializing the Siebel database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Creating the Siebel schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Verifying the results of install.ksh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Contents v Importing the Siebel object definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Verifying the results of imprep.ksh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Populating the Siebel File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Verifying the install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Installing the Siebel client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Testing the installation using the Siebel Call Center. . . . . . . . . . . . . . . . . 114 Installing Siebel Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Detailed instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Testing Siebel Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Creating sample data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Appendix B. The .bat files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 db2_db_mgr_cfg.bat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 db2_db2set.bat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 db2_db_cfg.bat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 tablespace.bat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 forceit.bat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 bufferpool.bat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Appendix C. Creating sample data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Entering data using Siebel Call Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Migrating the Siebel sample database. . . . . . . . . . . . . . . . . . . . . . . . . . .124 Appendix D. DB2 customization jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 DSNZPARM parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128 Creating STOGROUPs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Creating the Siebel databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Creating the Siebel table spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Creating Siebel tables and indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Creating stored procedure objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 Appendix E. DB2 DSNTIAUL and LOAD jobs . . . . . . . . . . . . . . . . . . . . . . 159 REXX EXEC to generate DSNTIAUL unload jobs . . . . . . . . . . . . . . . . . .162 REXX EXEC to generate DB2 LOAD jobs. . . . . . . . . . . . . . . . . . . . . . . .165 Appendix F. Validating object names . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Table names > 18 characters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Index names > 18 characters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Column names > 18 characters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 Index key > 255 bytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 The .dat file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 Appendix G. Dataexp/FTP/DB2 Load programs and jobs. . . . . . . . . . . . 175 REXX procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 vi Migrating Siebel Database from DB2/Oracle for NT to DB2 for OS/390 JCL to run the REXX procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178 PLFSIEBL COBOL program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179 JCL to run the PLFSIEBL program . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204 JCL to run the DB2 LOAD utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205 Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 Other resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 Referenced Web sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 How to get IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 IBM Redbooks collections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 Special notices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 Contents vii viii Migrating Siebel Database from DB2/Oracle for NT to DB2 for OS/390
Description: