Oracle® Business Intelligence Applications Upgrade Guide for Informatica PowerCenter Users Release 7.9.6.4 Part Number E35270-01 |
|
|
PDF · Mobi · ePub |
This chapter contains instructions for upgrading Oracle's Siebel Analytics release 7.5.x.
This chapter contains the following topics:
Section 3.1, "Prerequisites for Upgrading Oracle BI Applications"
Section 3.2, "Upgrading Oracle BI Infrastructure to Version 11g"
Section 3.4, "Upgrading to Informatica PowerCenter Version 9.0.1 Hotfix 2"
Section 3.9, "Overview of Upgrading the Data Warehouse Schema and Migrating Data"
Section 3.10, "Upgrading the Data Warehouse Schema to Version 7.7 and Migrating Data"
Section 3.11, "Upgrading the Data Warehouse Schema to Version 7.9.0"
Section 3.12, "Importing New Schema Definitions into the Siebel Transactional Database"
Section 3.13, "Migrating Data into the Data Warehouse Upgraded to Version 7.9.0"
Section 3.14, "Upgrading the Data Warehouse Schema to Version 7.9.4 and Migrating Data"
Section 3.15, "Upgrading the Data Warehouse Schema to Version 7.9.5 and Migrating Data"
Section 3.16, "Upgrading the Data Warehouse Schema to Version 7.9.5.1"
Section 3.18, "Upgrading the Data Warehouse Schema From Version 7.9.6 to 7.9.6.1"
Section 3.25, "Merging Oracle BI Applications Version 7.9.6.4 Repository With Customer Repository"
Section 3.27, "Regression Testing the Oracle BI Repository Merge"
Complete the following prerequisites before upgrading to Oracle BI Applications release 7.9.6.4:
The DAC Client requires an ODBC connection to the Oracle Business Analytics Warehouse when the database type is Oracle, SQL Server, DB2, and DB2-390 in order to upgrade the data warehouse schema using the DDL Import Utility.
Additionally, Siebel CRM source systems require an ODBC connection to the OLTP (source) database on the machine where Oracle BI Applications software is installed. This ODBC connection will be used by the DDLIMP utility.
Before you upgrade to Oracle BI Applications verify whether you have the appropriate ODBC connections set. If you do not, see Appendix F, "Creating ODBC Database Connections for DAC."
You must upgrade Oracle BI Infrastructure to version 11g. For the specific release of Oracle BI Infrastructure 11g that is supported for this release of Oracle BI Applications, see the System Requirements and Supported Platforms for Oracle Business Intelligence Applications. For information on installing the supported version of Oracle BI Infrastructure, see the Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence.
Run the Oracle BI Applications installer to upgrade your Oracle BI Applications environment to the current version. For instructions on running the installer, see Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users.
Note the following points:
Review "Chapter 3: Preinstallation and Predeployment Requirements for Oracle BI Applications," in the Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users. You must satisfy these requirements in order to upgrade to the current version of Oracle BI Applications.
Perform only the step that addresses the running of the installer. Do not perform the configuration instructions that follow the running of the installer.
If you have a previous release of Oracle BI Applications installed, you must uninstall it before you run the installer for the current release. If you do not uninstall the old release, some folders from the current release will not be correctly installed. (Make a back-up of your DAC folder before you uninstall the old release. This will be the backup of your DAC Client and Server and the DAC metadata files.)
You must install Informatica PowerCenter 9.0.1 Hotfix 2 to run the current version of Oracle BI Applications. See the System Requirements and Supported Platforms for Oracle Business Intelligence Applications for information about additional hotfixes or emergency bug fixes that may be required to support the current version of Informatica.
Note:
Oracle BI Applications release 7.9.6.4 is also certified to run with Informatica PowerCenter version 9.1 Hotfix 2. For instructions on upgrading the Informatica Repository if you have previously upgraded to Informatica PowerCenter 9.1 Hotfix 2, see Section 3.6, "Upgrading the Informatica Repository When You Are Already Running Informatica PowerCenter 9.1."
The components and architecture for Informatica PowerCenter 9.x differ significantly from Informatica PowerCenter 7.x and 8.x. Oracle recommends that you carefully review the Informatica PowerCenter 9.0.1 documentation.
For a summary of installation instructions for installing Informatica PowerCenter 9.0.1 on a single machine in an Oracle BI Applications deployment, see the Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users.
For detailed information about deploying Informatica PowerCenter 9.0.1, refer to the Informatica PowerCenter Installation and Configuration Guide, Informatica Upgrade Guide for PowerCenter 8.1.x, Informatica Upgrade Guide for PowerCenter 8.5.x and 8.6.x, Informatica Administrator Guide, and related documentation. See the Oracle Business Intelligence Applications Release Notes, available on the Oracle Technology Network, for information about how to locate the Informatica documentation.
To upgrade to Informatica PowerCenter 9.0.1 Hotfix 2:
Perform the pre-upgrade, upgrade, and post-upgrade steps documented in Informatica Upgrade Guide for PowerCenter 8.1.x or Informatica Upgrade Guide for PowerCenter 8.5.x and 8.6.x, depending on which version of Informatica PowerCenter you are upgrading from.
Note the following points:
The Informatica PowerCenter 9.0.1 installation process includes upgrading your current Informatica Repository to the version 9.0.1 format. This process is necessary so that you will be able to access your current repository using the version 9.0.1 client tools and so that you can perform the procedure Section 3.5, "Upgrading the Informatica Repository."
In Section 3.5, "Upgrading the Informatica Repository," you back up and rename your current repository and then restore the Informatica Repository that is installed during the Oracle BI Applications installation (for example, Oracle_BI_DW_Base.rep). You then copy the folders containing the Oracle BI Applications content for release 7.9.6.4 to your existing repository.
If you install Informatica PowerCenter 9.0.1 using the installer Upgrade option rather than the Install option, the property $PMRootDir is not updated to the upgraded service version installation directory. You need to configure this property to specify the upgraded service installation directory in order for DAC to be able to locate the Informatica source files.
To configure the $PMRootDir property: launch Informatica Administrator, select the Integration Service from the Navigator, click the Processes tab, and click Edit. Then, enter the appropriate value for $PMRootDir.
Follow this procedure to upgrade the Informatica Repository when you are upgrading the Informatica PowerCenter platform from version 7.x or 8.x to 9.0.1 Hotfix 2. If you have already upgraded to Informatica PowerCenter 9.1, follow the procedure in Section 3.6, "Upgrading the Informatica Repository When You Are Already Running Informatica PowerCenter 9.1."
In this procedure, you will copy the folders containing the Oracle BI Applications 7.9.6.4 content into your current, existing Informatica Repository. The result of this action is an Informatica Repository that contains your customizations along with the new Oracle BI Applications 7.9.6.4 content.
For detailed instructions on backing up and restoring the Informatica Repository, see the topic titled, "Backing Up and Restoring the PowerCenter Repository," in "Chapter 15: PowerCenter Repository Management," in the Informatica PowerCenter Administrator Guide. See the Oracle Business Intelligence Applications Release Notes, available on the Oracle Technology Network, for information about how to locate the Informatica documentation.
To upgrade the Informatica Repository:
Make sure you have backed up and renamed your current, existing Informatica Repository.
Copy the Oracle_BI_DW_Base.rep file (or Oracle_BI_DW_Teradata.rep for repositories on Teradata databases) from the folder OracleBI\dwrep\Informatica\Repository into the folder <INFA_HOME>\server\infa_shared\Backup.
Note:
The Oracle_BI_DW_Base.rep file is installed in the OracleBI root directory when you run the Oracle BI Applications installer, as described in Section 3.3, "Upgrading Oracle BI Applications."
Using Informatica PowerCenter Administrator, create a new Repository Service for the Oracle_BI_DW_Base.rep repository. See "Setup Step: Creating the Informatica Repository Service," in Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users for instructions.
Using the Repository Service you created in the step above, restore the Oracle_BI_DW_Base.rep repository into an empty schema. See "Restoring the Prebuilt Informatica Repository for Environments in English" or "Restoring the Prebuilt Informatica Repository on a Non-English Operating System" in Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users for instructions.
This step gives you the Oracle BI Applications 7.9.6.4 Informatica Repository in the Informatica 9.0.1 format.
Launch the Informatica PowerCenter Repository Manager, and connect to the repository you restored in step 4 (for example, Oracle_BI_DW_Base.rep), and connect to your current, existing Informatica Repository.
Note: Your current, existing repository should have been updated to the version 9.0.1 format during the Informatica PowerCenter 9.0.1 installation process.
In your current, existing repository, make sure all of your customizations are in a "Custom" folder.
In your current, existing repository, delete the following folders:
PLP
All folders with the prefix SDE_
SILOS
SIL_VERT
UA_SDE
UA_SIL
Make sure you do not delete the "Custom" folder.
Copy the following folders containing the Oracle BI Applications content for release 7.9.6.4 from the newly restored repository (Oracle_BI_DW_Base.rep) into your current, existing repository.
PLP
All folders with the prefix SDE_
SILOS
SIL_VERT
UA_SDE
UA_SIL
This action updates your current, existing repository with the Oracle BI Applications 7.9.6.4 content; this is the repository you will use to run ETL in Oracle BI Applications 7.9.6.4.
The version 7.9.6.4 repository (Oracle_BI_DW_Base.rep) and the Repository Service for this repository are no longer needed.
If you are upgrading to Oracle BI Applications 7.9.6.4 and previously upgraded Informatica PowerCenter to version 9.1 Hotfix 2, you must first restore the Oracle BI Applications version 7.9.6.4 Informatica Repository using Informatica PowerCenter 9.0.1 Hotfix 2. Then, you can upgrade this repository to the Informatica 9.1 format by pointing to it using Informatica 9.1 client tools. After the Oracle BI Applications 7.9.6.4 Informatica Repository has been upgraded to the Informatica 9.1 format, you can then copy the folders containing the Oracle BI Applications 7.9.6.4 content into your current, existing Informatica Repository. The result of this action is an Informatica Repository that contains your customizations along with the new Oracle BI Applications 7.9.6.4 content.
For detailed instructions on backing up and restoring the Informatica Repository, see the topic titled, "Backing Up and Restoring the PowerCenter Repository," in "Chapter 15: PowerCenter Repository Management," in the Informatica PowerCenter Administrator Guide. See the Oracle Business Intelligence Applications Release Notes, available on the Oracle Technology Network, for information about how to locate the Informatica documentation.
To upgrade the Informatica Repository when already running Informatica PowerCenter 9.1:
Make sure you have backed up and renamed your current, existing Informatica Repository.
Install Informatica PowerCenter Services version 9.0.1 Hotfix 2. You do not need to install the Informatica PowerCenter Client Tools. See Section 3.4, "Upgrading to Informatica PowerCenter Version 9.0.1 Hotfix 2" for instructions.
Copy the Oracle_BI_DW_Base.rep file (or Oracle_BI_DW_Teradata.rep for repositories on Teradata databases) from the folder OracleBI\dwrep\Informatica\Repository into the Informatica PowerCenter 9.0.1 folder <INFA_HOME>\server\infa_shared\Backup.
Note:
The Oracle_BI_DW_Base.rep file is installed in the OracleBI root directory when you run the Oracle BI Applications installer, as described in Section 3.3, "Upgrading Oracle BI Applications."
Using Informatica PowerCenter Administrator, create a new Repository Service for the Oracle_BI_DW_Base.rep repository. See "Setup Step: Creating the Informatica Repository Service," in Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users for instructions.
Using the Repository Service you created in the step above, restore the Oracle_BI_DW_Base.rep repository into an empty schema. See "Restoring the Prebuilt Informatica Repository for Environments in English" or "Restoring the Prebuilt Informatica Repository on a Non-English Operating System" in Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users for instructions.
This step gives you the Oracle BI Applications 7.9.6.4 Informatica Repository in Informatica 9.0.1 format.
Launch the Informatica PowerCenter Repository Manager, and connect to the repository you restored in step 5. When prompted to upgrade the repository to the 9.1 format, do so.
In Repository Manger, connect to your current, existing Informatica Repository.
In your current, existing repository, make sure all of your customizations are in a "Custom" folder.
In your current, existing repository, delete the following folders:
PLP
All folders with the prefix SDE_
SILOS
SIL_VERT
UA_SDE
UA_SIL
Make sure you do not delete the "Custom" folder.
Copy the following folders containing the Oracle BI Applications content for release 7.9.6.4 from the newly restored repository (Oracle_BI_DW_Base.rep) into your current, existing repository.
PLP
All folders with the prefix SDE_
SILOS
SIL_VERT
UA_SDE
UA_SIL
This action updates your current, existing repository with the Oracle BI Applications 7.9.6.4 content; this is the repository you will use to run ETL in Oracle BI Applications 7.9.6.4.
The version 7.9.6.4 repository (Oracle_BI_DW_Base.rep) and the Repository Service for this repository are no longer needed.
Informatica PowerCenter version 9.0.1 Hotfix 2 requires configuration for it to work with Oracle BI Applications and DAC. The configuration settings from your earlier Informatica environment may have been retained when you upgraded to Version 9.0.1 Hotfix 2. Verify or perform the procedures listed below, as documented in the Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users:
Copying Source Files and Lookup Files
Setting PowerCenter Integration Services Relaxed Code Page Validation
Setting PowerCenter Integration Services Custom Properties
Creating the Repository Administrator User in the Native Security Domain
Siebel Analytics release 7.5.x does not include the Data Warehouse Administration Console (DAC). In the current release of Oracle BI Applications, you will use the 11g version of the DAC Client and Server and the DAC Repository. For information about the specific release of the DAC platform supported with the current release of Oracle BI Applications, see System Requirements and Supported Platforms for Oracle Business Intelligence Applications.
To install and configure DAC 11g, follow the instructions in the Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users. Make sure you perform the tasks in the following sections of the Oracle Business Intelligence Applications Installation Guide for Informatica PowerCenter Users:
Preinstallation Tasks
Installing and Setting Up the DAC Platform
Installing DAC Metadata Files
Logging into DAC for the First Time and Importing Metadata into the DAC Repository
Note: After you complete this procedure, you will have the default DAC Repository for Oracle BI Applications release 7.9.6.4.
Configuring the DAC Server
Configuring DAC Integration Settings
Configuring Relational Connections in Informatica Workflow Manager
Configuring the SiebelUnicodeDB Custom Property
Setting Up DAC to Receive Email Notification
Additional Configuration Tasks
In this section, perform only the tasks that apply to your environment.
The process for upgrading the data warehouse schema and migrating data for Siebel Business Analytics releases 7.5.x involves multiple phases, as described below.
Note:
The Oracle BI Applications upgrade logic is coded such that you must complete each of the phases listed below. To upgrade to the current release of Oracle BI Applications, you cannot skip any of the phases.
Phase 1
In phase 1, you will upgrade the data warehouse schema to version 7.7 and migrate data into the upgraded data warehouse. For instructions, see Section 3.10.
Phase 2
In phase 2, you will perform the following steps:
Upgrade the data warehouse schema to version 7.9.0. For instructions, see Section 3.11.
Import new schema definitions into the Siebel transactional database. For instructions, see Section 3.12.
Migrate data into the data warehouse upgraded to version 7.9.0. For instructions, see Section 3.13.
Phase 3
In phase 3, you will upgrade your data warehouse schema to version 7.9.4 and migrate data into the upgraded data warehouse. For instructions, see Section 3.14.
Phase 4
In phase 4, you will upgrade your data warehouse schema to version 7.9.5 and migrate data into the upgraded data warehouse. For instructions, see Section 3.15.
Phase 5
In phase 5, you will upgrade your data warehouse schema to version 7.9.5.1. For instructions, see Section 3.16.
Phase 6
In phase 6, you will do one of the following:
Upgrade your data warehouse schema from version 7.9.5.1 to version 7.9.6.1 and migrate data. For instructions, see Section 3.17.
If you are currently running Oracle BI Applications version 7.9.6 and using an Oracle database, you can upgrade your data warehouse schema to version 7.9.6.1 and migrate data. For instructions, see Section 3.18.
Phase 7
In phase 7, you will upgrade your data warehouse schema to version 7.9.6.2 and migrate data into the upgraded data warehouse. For instructions, see Section 3.19.
Phase 8
In phase 8, you will upgrade your data warehouse schema to version 7.9.6.3 and migrate data into the upgraded data warehouse. For instructions, see Section 3.20.
Phase 9
In phase 9, you will upgrade your data warehouse schema to version 7.9.6.4 and migrate data into the upgraded data warehouse. For instructions, see Section 3.21.
Follow this procedure to upgrade the data warehouse schema to version 7.7 and migrate data.
To upgrade the data warehouse schema:
Run the schema upgrade script.
This script adds new tables, columns, and indexes to the existing data warehouse schema. It also modifies the existing data warehouse schema objects.
Navigate to the folder OracleBI\dwrep\Upgrade\CTLFiles, and locate the ddlsme_HOR_77.ctl file (Horizontal) or ddlsme_SIA_77.ctl file (Vertical).
If you changed any of the preconfigured column definitions in the CTL file for your implementation, you need to edit the CTL file to reflect the change. For example, if you renamed or resized an existing column in W_DAY_D, you need to make the same change in the CTL file. If you do not make the change in the CTL file, when the CTL file is run, the column definition will revert to the preconfigured definition. (As a customization, if a column size was changed from VARCHAR(50) to VARCHAR(100), and the same change was not made in the CTL file before running, the column will revert to the preconfigured value of VARCHAR(50), which could cause data to be truncated in some databases.)
Use the DDLimp utility to run one of the following scripts:
For Siebel Applications (Horizontal), run ddlsme_HOR_77.ctl.
For Siebel Industry Applications (Vertical), run ddlsme_SIA_77.ctl.
Use the following command, substituting the correct script name where appropriate.
..\OracleBI\dwrep\bin\DDLIMP /U <USER> /P <PASSWORD> /C <ODBC connect string> /G SSE_ROLE /I N /R Y /F <..\OracleBI\dwrep\Upgrade\CTLFiles\ddlsme_HOR_77.ctl> /L <..\oracleBI\dwrep\ddlsme_HOR_77.log>
For example:
DDLIMP /U SADMIN /P SADMIN /C SIEBEL_OLTP /G SSE_ROLE /I N /R Y /F C:\OracleBI\dwrep\Upgrade\CTLFiles\ddlsme_HOR_77.ctl /L C:\OracleBI\dwrep\ddlsme_HOR_77.log
Notes:
/P <PASSWORD> - The password for the data warehouse.
/C <ODBC connect string> - The name of the ODBC connect string.
/I N - Tells DDLimp to ignore the indexes DDL defined in the CTL file if any exist. It does not change existing indexes. (The default is /I Y, which tells DDLimp to create and merge indexes from the CTL file with the indexes in the database.
For Oracle databases, use the Data Direct drivers.
In addition, you can use the following commands:
/W Y - If the OLAP database is Oracle and Unicode.
/Z Y - If the OLAP database is DB2 or SQL Server and Unicode.
/B <TABLE_SPACE_NAME> - If you want to create these tables in a separate table space. For DB2, This must be specified as 32K tablespace.
/X <INDEX_TABLE_SPACE_NAME> - If you want to create the indexes in a separate tablespace. For DB2, This must be specified as 32K tablespace.
/Y - Storage File for DB2/390.
/R - Regrant tables.
Copy the file Upgrade.rep from the folder OracleBI\dwrep\Upgrade\Informatica\Repository into the folder <INFA_HOME>\server\infa_shared\Backup.
Launch the Informatica Administrator and restore Upgrade.rep (located in <INFA_HOME>\server\infa_shared\Backup) into a database other than the database in which you restored Oracle_BI_DW_Base.rep.
Navigate to the folder OracleBI\dwrep\Upgrade\Informatica\ParameterFiles and copy the file 753_TENERIFE_UPG_PARAMS.txt into the SrcFiles folder on the Informatica Server machine, for example, <INFA_HOME>\server\infa_shared\SrcFiles.
Rename 753_TENERIFE_UPG_PARAMS.txt to TENERIFE_UPG_PARAMS.txt.
In the Informatica Workflow Manager, open the Relational Connection Browser (in the menu bar, select Connections, and then select Relational), and edit the connect string, user and password for the relational connections as follows:
Edit the PARAM_OLTP_SIEBEL connection to point to the Siebel transactional database.
Edit the DataWarehouse connection to point to the newly upgraded data warehouse database.
Create or edit the PARAM_DAC_OLD connection to point to the previous DAC Repository database (the version from which you are upgrading).
Create or edit the PARAM_DAC_NEW connection to point to the DAC Repository database.
Note:
If you are connected to an Oracle database, use the Oracle Native driver instead of ODBC.
If you are connected to a SQL Server database, use the ODBC driver rather than the native SQL Server driver.
For Siebel Applications (Horizontal), in Informatica Workflow Manager, navigate to the folder UPGRADE_753_to_770_HOR, and execute the following workflows in the order indicated:
Upgrade_R_Image
Upgrade_Unspecifieds
Upgrade_Agree
Upgrade_Asset
Upgrade_Opty
Upgrade_Order
Upgrade_Quote
Upgrade_Response
Upgrade_ServiceRequest
Upgrade_Others
Upgrade_Visibility
UpgradeSlowlyChangingDimensionStartDates
DAC_Metadata_Upgrade_Workflow
For Siebel Industry Applications (Vertical), in Informatica Workflow Manager, navigate to the folder UPGRADE_753_to_770_SIA, and execute the following workflows in the order indicated
Upgrade_R_Image
Upgrade_Unspecifieds
Upgrade_Agree
Upgrade_Asset
Upgrade_Opty
Upgrade_Order
Upgrade_Quote
Upgrade_Response
Upgrade_ServiceRequest
Upgrade_Others
Upgrade_Visibility
UpgradeSlowlyChangingDimensionStartDates
Upgrade_Industry_R_Image
Upgrade_Industry_Unspecified
Upgrade_LS_ActivityProduct
Upgrade_LS_Others
Upgrade_Industry_Household
Upgrade_FINS_Visibility
UpgradeSlowlyChangingDimensionStartDates_Industry
DAC_Metadata_Upgrade_Workflow
This procedure adds new tables, columns, and indexes to the existing data warehouse schema. It also modifies the existing data warehouse schema objects.
To upgrade the data warehouse schema:
Run the UPGRADE.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 790_UPGRADE_PRE_CTL_SCRIPT.sql script.
Open the SQL client for your database type.
Navigate to the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Open the 790_UPGRADE_PRE_CTL_SCRIPT.sql file, and copy the contents into the SQL client.
Execute the script.
Run the DW.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 790_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
This procedure upgrades transactional database objects that relate to Oracle Business Intelligence Applications. It does not upgrade transactional database objects for Siebel CRM applications.
To import new schema definitions into the Siebel transactional database:
Import schema definitions for non-image tables:
Access the DDLimp utility.
Run the DDL_OLTP.ctl script that is located in the OracleBI\dwrep\Upgrade\CTLFiles folder.
Note: If you receive an error message stating a particular object already exists in the database, use the DDLimp Merge argument (/M Y) in the DDLimp command to resolve the error.
Import schema definitions for image tables:
In DAC, go to the Design view, and select your custom container from the drop-down list to the right of the Execute button.
Click the Tables tab.
Query for all tables for which the image suffix is not null.
Right-click in the list of tables returned by the query, and select Change Capture Scripts, and then Generate Image and Trigger Scripts.
In the Triggers and Image Tables dialog box, do the following:
- Select the option All Tables in the List.
- Select the option Generate Image Table Scripts.
- Select the appropriate database type for the source system.
- Click OK.
Open the SQL client for the source system database type, for example, SQL Plus for Oracle, Query Analyzer for SQL Server, or a command window for DB2.
The script may contain many lines; therefore, you can save the script file as a SQL file and execute it in a SQL client.
Copy the scripts generated by DAC into the SQL client and execute them.
Follow this procedure to verify the following tables were created in the Siebel transactional database.
To verify the transactional database upgrade:
For all upgrade paths, verify the following tables were created in the Siebel transactional database:
S_ETL_R_IMG_xxx
S_ETL_I_IMG_xxx
S_ETL_D_IMG_xxx
S_ETL_PARAM
S_ETL_PRD_ATTR
S_ETL_PRD_REL
Follow this procedure to migrate data into the data warehouse upgraded to version 7.9.0.
To migrate data into the upgraded data warehouse:
Navigate to the folder OracleBI\dwrep\Upgrade\Informatica\SrcFiles and copy the *.csv files into the SrcFiles folder on the Informatica Server machine, for example, <INFA_HOME>\server\infa_shared\SrcFiles.
Navigate to the folder OracleBI\dwrep\Upgrade\Informatica\ParameterFiles and copy the file 770_TENERIFE_UPG_PARAMS.txt into the SrcFiles folder on the Informatica Server machine, for example, <INFA_HOME>\server\infa_shared\SrcFiles.
Rename 770_TENERIFE_UPG_PARAMS.txt to TENERIFE_UPG_PARAMS.txt.
In the file TENERIFE_UPG_PARAMS.txt:
Search for the parameter $$SourceConnection.
Set the value to one of the following options, based on your Siebel applications (OLTP) version:
SEBL_63
SEBL_753
SEBL_771
SEBL_78
SEBL_80 (use this value for OLTP versions 8.x and 8.1.1)
SEBL_VERT_753
SEBL_VERT_771
SEBL_VERT_78
SEBL_VERT_80 (use this value for OLTP versions 8.x and 8.1.1)
For example, if your Siebel applications (OLTP) version is Siebel Industry Applications 7.5.x, the parameter should appear as:
$$SourceConnection=SEBL_VERT_753
In the file TENERIFE_UPG_PARAMS.txt:
Search for the parameter $$Source_Container.
Set the value to one of the following options, based on your Siebel applications (OLTP) version:
Siebel 6.3
Siebel 7.5.3
Siebel 7.5.3 Vertical
Siebel 7.7.1
Siebel 7.7.1 Vertical
Siebel 7.8
Siebel 7.8 Vertical
Siebel 8.0 (use this value for OLTP versions 8.x and 8.1.1)
Siebel 8.0 Vertical (use this value for OLTP versions 8.x and 8.1.1)
For example, if your Siebel applications (OLTP) version is Siebel Industry Applications 7.5.x, the parameter should appear as:
$$Source_Container=Siebel 7.5.3 Vertical
In the file TENERIFE_UPG_PARAMS.txt, edit the ETL_PROC_WID parameter as follows:
MPLT_GET_ETL_PROC_WID.$$ETL_PROC_WID=<latest ETL_PROC_WID value from your database>
You can get this value from W_PARAM_G.ETL_PROC_WID.
If you are running Siebel Industry Applications (Vertical), in the file TENERIFE_UPG_PARAMS.txt, set the VERTICAL_UPGRADE parameter to 1. For example:
$$VERTICAL_UPGRADE=1
For Siebel Industry Applications (Vertical), define the alignment rule to be used for ETL loads.
Navigate to the folder OracleBI\dwrep\Upgrade\Informatica\SrcFiles and copy the file AlignmentType_LS_782.csv into the SrcFiles folder on the Informatica Server machine, for example, <INFA_HOME>\server\infa_shared\SrcFiles.
Rename the file AlignmentType_LS_782.csv to AlignmentType.csv.
Open the file AlignmentType.csv, and enter one of the following alignment item types under the ALIGN_TYPE field:
Zipcode
Account/Contact
Brick
Save the file.
The Oracle Business Analytics Warehouse allows only one alignment type to be used for ETL loads during upgrade.
In Informatica Workflow Manager, navigate to the folder UPGRADE_770_to_79, and execute the following workflows in the order indicated:
MARKETING_LOAD
Upgrade_Dimensions_Industry
Update_Dimensions
Update_Dimension_Unspecified
Update_Facts
(For Siebel Industry Applications only) Upgrade_LS_Dimensions
(For Siebel Industry Applications only) Upgrade_LS_Facts
SIL_PositionDimensionHierarchy_Full
Load_INT_ORG_DH
DIMENSION_LOAD
Note:
If you are using the SCD version of the dimension, replace the corresponding TENN_UPG_W_XXX_D_784_To_W_XXX_D session with TENN_UPG_W_XXX_D_784_SCD_To_W_XXX_D. This will upgrade the data from the W_XXX_SCD version of the dimension to the new SCD-enabled W_XXX_D dimension.
DIMENSION_UNSPECIFIED_UPDATE
FACT_UPDATE
DAC_Metadata_Upgrade_Workflow
Note:
You need to run this workflow for upgrading to the data warehouse schema version 7.9.0 even though you ran a workflow with the same name during the upgrade to version 7.7.
If you upgraded your transactional database to Siebel Applications 8.x or 8.1.1, navigate to the folder UPGRADE_790_to_791_SBL80UPG and run the following workflows in the order indicated:
UPGRADE_DIMENSIONS
UPGRADE_FACTS
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
To verify the data migrated successfully:
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the directory \Informatica PowerCenter 9.0.1\Server\SessLogs indicates errors or failures.
Check whether the SQL scripts (790_UPGRADE_PRE_CTL_SCRIPT.sql and 790_UPGRADE_PRE_DIMENSION_SCRIPT.sql) that you ran in the SQL client of the database failed or errored out while executing.
Check the log files for the CTL files (Upgrade.ctl and DW.ctl) that you ran using the DDLimp command to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables.
If the data migration was successful, drop the tables that were created during the upgrade process, such as, W_xxxx_x_784 tables, LKP_xxxx_x, and W_ASSET_D_TMP.
This step frees the space occupied by these backup tables.
Follow this procedure to upgrade the data warehouse schema to version 7.9.4 and migrate data.
This procedure adds new tables, columns, and indexes to the existing data warehouse schema. It also modifies the existing data warehouse schema objects.
To upgrade the data warehouse schema to version 7.9.4 and migrate data:
Run the 792_UPGRADE_PRE_CTL_SCRIPT.sql script.
Open the SQL client for your database type, for example, SQLPLUS for Oracle, Query Analyzer for SQL Server, or a command window for DB2.
Navigate to the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Open the 792_UPGRADE_PRE_CTL_SCRIPT.sql file, and copy the contents into the SQL client.
Execute the script.
Run the ddl_794.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 792_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
If you upgraded your transactional database to Siebel Applications 8.x or 8.1.1, run the workflows to migrate your data into the upgraded data warehouse.
In Informatica Workflow Manager, navigate to the folder UPGRADE_790_TO_791_SBL80UPG.
Run the following workflows in the order indicated:
UPGRADE_DIMENSIONS
UPGRADE_FACTS
Verify the data migrated successfully by checking whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\SessLogs directory indicate errors or failures. Also, validate the data in the upgraded data warehouse.
If the data migration was successful, drop the tables that were created during the upgrade process, such as, W_xxxx_x_79x tables, LKP_xxxx_x and 79x_XXXX_TMP.
This step frees the space occupied by these backup tables.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Follow this procedure to upgrade the data warehouse schema to version 7.9.5 and migrate data.
This procedure adds new tables, columns, and indexes to the existing data warehouse schema. It also modifies the existing data warehouse schema objects.
To upgrade the data warehouse schema to version 7.9.5 and migrate data:
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade repository. For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Run the 795_UPGRADE_PRE_CTL_SCRIPT.sql script. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the UPGRADE_795.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the ddl_795.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 795_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Copy all of the domain value files in the folder \OracleBI\dwrep\Informatica\LkpFiles into the folder <INFA_HOME>\server\infa_shared\LkpFiles.
Migrate data into the upgraded data warehouse.
Copy the file Upgrade.rep from the folder OracleBI\dwrep\Upgrade\Informatica\Repository into the folder <INFA_HOME>\server\infa_shared\Backup.
Launch the Informatica Administrator and restore Upgrade.rep (located in <INFA_HOME>\server\infa_shared\Backup).
Configure the Informatica parameter file 795_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 795_UPG_PARAMS.txt."
In Informatica Workflow Manager, open the Relational Connection Browser (in the menu bar, select Connections, and then select Relational), and edit the connect string, user and password for the relational connections as follows: create one relational connection based on the appropriate database platform for your OLTP database. Create the connection with the name PARAM_OLTP.
Edit the PARAM_OLTP connection to match your OLTP environment.
Edit the PARAM_OLAP connection to match your OLAP environment.
Note:
If you are connected to an Oracle database, use the Oracle Native driver instead of ODBC.
If you are connected to a SQL Server database, use the ODBC driver rather than the native SQL Server driver.
In Informatica Workflow Manager, navigate to the folder UPGRADE_794_to_795_SBL and execute the UPGRADE_DIMENSIONS workflow.
Verify the data migrated successfully.
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\Sesslogs directory indicates errors or failures.
Check whether the script 795_UPGRADE_PRE_DIMENSION_SCRIPT.sql that you ran in the SQL client of the database failed or errored out while executing.
Check the log file for the ddl_795.ctl. and Upgrade_795.ctl, which you ran using the DDLimp command, to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables
If the data migration was successful, drop the tables that were created during the upgrade process, such as W_xxxx_x_79x, LKP_xxxx_x and 79x_xxxx_TMP.
This step frees the space occupied by these backup tables.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Follow this procedure to upgrade the data warehouse schema to version 7.9.5.1.
To upgrade the data warehouse schema:
Use the DDLimp utility to run the ddl_7951.ctl script, which is located in the OracleBI\dwrep\Upgrade\CTLFiles folder. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
You need to perform this procedure if you are upgrading from Oracle BI Applications releases 7.9.0, 7.9.1, 7.9.2, 7.9.3, 7.9.4, 7.9.5, or 7.9.5.1.
This procedure adds new tables, columns, and indexes to the existing data warehouse schema. It also modifies the existing data warehouse schema objects.
This section includes the following procedures:
Section 3.17.1, "Upgrading the Data Warehouse Schema From Version 7.9.5.1 to 7.9.6.1"
Section 3.17.2, "Migrating Data Into the Upgraded Data Warehouse"
Follow this procedure to upgrade the data warehouse schema to version 7.9.6.1.
Note: Upgrading to version 7.9.6.1 may involve running scripts that have a "796_" prefix.
To upgrade the data warehouse schema to version 7.9.6.1 and migrate data:
If you are using an Oracle database, run the 796_UPGRADE_DROP_INDEXES.sql script.
Open the SQL client for your database type.
Navigate to the folder OracleBI\dwrep\Upgrade\DbScripts\Oracle.
Open the 796_UPGRADE_DROP_INDEXES. sql file, and copy the contents into the SQL client.
Execute the script.
If you are using a SQL Server or DB2 database, run the 7961_UPGRADE_DROP_INDEXES.sql script.
Open the SQL client for your database type.
Navigate to the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Open the 7961_UPGRADE_DROP_INDEXES. sql file, and copy the contents into the SQL client.
Execute the script.
If you are using a SQL Server database, run the 7961_UPGRADE_PRE_UPG_CTL_SCRIPT.sql file. This file is located in OracleBI\dwrep\Upgrade\DbScripts\SQLServer.
Run the UPGRADE_796.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 7961_UPGRADE_PRE_CTL_SCRIPT.sql:
Go to OracleBI\dwrep\Upgrade\DbScripts\<database type> folder, and open the 7961_UPGRADE_PRE_CTL_SCRIPT.sql file.
Search for the Datasource_Num_ID parameter, and make sure the value is correct for your existing implementation.
If you are using a DB2 database, search for the text "TBS_32K," and replace it with the appropriate 32K table space name that you have configured.
Execute the script.
Run the ddl_7961.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 796_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade Informatica Repository. For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Copy all of the domain value files in the folder \OracleBI\dwrep\Informatica\LkpFiles into the folder <INFA_HOME>\server\infa_shared\LkpFiles.
Follow this procedure to migrate data into the upgraded data warehouse.
To migrate data into the upgraded data warehouse:
Copy the file Upgrade.rep from the folder OracleBI\dwrep\Upgrade\Informatica\Repository into the folder <INFA_HOME>\server\infa_shared\Backup.
Launch the Informatica Administrator and restore Upgrade.rep (located in <INFA_HOME>\server\infa_shared\Backup).
Configure the Informatica parameter file 796_UPG_PARAMS.txt file. For instructions, see Appendix A, "Setting Parameters in 796_UPG_PARAMS.txt."
Configure parameters specific to Siebel source systems. For instructions, see Appendix A, "Setting Parameters in 796_UPG_PARAMS.txt for Siebel Source Systems."
In Informatica Workflow Manager, open the Relational Connection Browser (in the menu bar, select Connections, and then select Relational), and edit the connect string, user and password for the relational connections as follows:
Edit the connection PARAM_OLTP_SIEBEL to match your OLTP environment.
Edit the connection PARAM_OLAP to match your OLAP environment.
Edit the connection PARAM_DAC to match your DAC database.
Note:
If you are connected to an Oracle database, use the Oracle Native driver instead of ODBC.
If you are connected to a SQL Server database, use the ODBC driver rather than the native SQL Server driver.
Back up and truncate the table W_POSITION_DH.
In Informatica Workflow Manager, navigate to the folder UPGRADE_7951_to_796_SBL and execute the following workflows in the order indicated:
UPGRADE_DIMENSIONS
UPGRADE_FACTS
RESET_DAC_REFRESH_DATES
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Run the 7961_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade Informatica Repository. For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Configure the Informatica parameter file 7961_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 7961_UPG_PARAMS.txt."
In Informatica Workflow Manager, navigate to the folder UPGRADE_796_to_7961_SBL and execute the first the UPGRADE_DIMENSIONS workflow and then the UPGRADE_FACTS workflow.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Run the 7961_UPGRADE_POST_SCRIPT.sql. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Follow this procedure to verify that the data was migrated successfully into the upgraded data warehouse.
To verify the data migrated successfully:
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\Sesslogs directory indicates errors or failures.
Check whether the following scripts that you ran in the SQL client of the database failed or errored out while executing:
7961_UPGRADE_DROP_INDEXES.sql
7961_UPGRADE_PRE_CTL_SCRIPT.sql
7961_UPGRADE_PRE_DIMENSION.sql
7961_UPGRADE_POST_SCRIPT.sql
Check the log files for the ddl_7961.ctl and Upgrade_7961.ctl scripts that you ran using the DDLimp command to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables
If the data migration was successful, drop the tables that were created during the upgrade process, such as W_xxxx_x_79x, LKP_xxxx_x, 79x_xxxx_TMP, and TMP_xxxx_79x.
This step frees the space occupied by these backup tables.
Perform the procedures in this section if you are upgrading from Oracle BI Applications release 7.9.6 to release 7.9.6.1.
Note:
This procedure is applicable only if you are using an Oracle database for your data warehouse database.
This section includes the following procedures:
Section 3.18.1, "Upgrading the Data Warehouse Schema to Version 7.9.6.1"
Section 3.18.2, "Migrating Data into the Upgraded Data Warehouse"
Follow this procedure to upgrade the data warehouse schema to version 7.9.6.1.
To upgrade the data warehouse schema to version 7.9.6.1:
Run the UPGRADE_7961.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 796ORA_TO_7961ORA_UPGRADE_PRE_CTL_SCRIPT.sql. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\Oracle.
Run the ddl_7961.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Follow this procedure to migrate data into the upgraded data warehouse.
To migrate data into the upgraded data warehouse:
Run the 7961_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\Oracle.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade repository. For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Configure the Informatica parameter file 7961_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 7961_UPG_PARAMS.txt."
In Informatica Workflow Manager, navigate to the folder UPGRADE_796_to_7961_SBL and execute the first the UPGRADE_DIMENSIONS workflow and then the UPGRADE_FACTS workflow.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Run the 7961_UPGRADE_POST_SCRIPT.sql. This file is located in OracleBI\dwrep\Upgrade\DbScripts\Oracle.
Follow this procedure to verify that the data was migrated successfully into the upgraded data warehouse.
To verify the data migrated successfully:
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\Sesslogs directory indicates errors or failures.
Check whether the following scripts that you ran in the SQL client of the database failed or errored out while executing:
7961_UPGRADE_DROP_INDEXES.sql
7961_UPGRADE_PRE_CTL_SCRIPT.sql
7961_UPGRADE_PRE_DIMENSION.sql
7961_UPGRADE_POST_SCRIPT.sql
Check the log files for the ddl_7961.ctl and Upgrade_7961.ctl scripts, which you ran using the DDLimp command, to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables
This section contains the following procedures:
Section 3.19.1, "Upgrading the Data Warehouse Schema to Version 7.9.6.2"
Section 3.19.2, "Migrating Data into the Upgraded Data Warehouse"
Follow this procedure to upgrade the data warehouse schema to version 7.9.6.2.
To upgrade the data warehouse schema to version 7.9.6.2:
Generate the scripts to drop and create indexes. For instructions, see Section B.1, "Generating Scripts to Drop and Create Indexes for Upgrading to Release 7.9.6.2."
Run the script to drop all indexes. For instructions, see Section B.2, "Running the Script to Drop All Indexes for Upgrading to Release 7.9.6.2."
If you are using a SQL Server database, run the 7962_UPGRADE_PRE_UPG_CTL_SCRIPT.sql file. This file is located in OracleBI\dwrep\Upgrade\DbScripts\SQLServer.
Run the UPGRADE_7962.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 7962_UPGRADE_PRE_CTL_SCRIPT.sql. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the ddl_7962.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Follow this procedure to migrate data into the upgraded data warehouse.
To migrate data into the upgraded data warehouse:
Run the 7962_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade repository. For instructions, see Section D.4, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Configure the Informatica parameter file 7962_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 7962_UPG_PARAMS.txt."
Run the script to create ETL indexes. For instructions, see Section B.3, "Running the Scripts to Create ETL and Query Indexes for Upgrading to Release 7.9.6.2."
In Informatica Workflow Manager, navigate to the folder UPGRADE_7961_to_7962_SBL and execute the UPGRADE_DIMENSIONS workflow.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Section D.1, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Run the script to create Query indexes. For instructions, see Section B.3, "Running the Scripts to Create ETL and Query Indexes for Upgrading to Release 7.9.6.2."
Follow this procedure to verify that the data was migrated successfully into the upgraded data warehouse.
To verify the data migrated successfully:
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\Sesslogs directory indicates errors or failures.
Check whether the following scripts that you ran in the SQL client of the database failed or errored out while executing:
dropallindexes.sql
7962_UPGRADE_PRE_CTL_SCRIPT.sql
7962_UPGRADE_PRE_DIMENSION.sql
createETLIndexes.sql
createQueryIndexes.sql
Check the log files for the ddl_7962.ctl and Upgrade_7962.ctl scripts, which you ran using the DDLimp command, to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables.
If the data migration was successful, drop the tables that were created during the upgrade process, such as W_xxxx_x_79x, LKP_xxxx_x and 79x_xxxx_TMP.
This step frees the space occupied by these backup tables.
Once the data migration steps above are complete, you can delete the Upgrade repository to avoid any accidental use or confusion.
In the Informatica Administrator, select the Upgrade repository service.
In the General Properties area of the Properties tab, click Edit.
Make sure the operating mode of the repository service is set to Exclusive.
Click OK.
Choose Actions, and then click Delete Contents.
In the Delete contents for <repository name> dialog, enter the repository username and password, then click OK.
Perform the procedures in this section to upgrade from Oracle BI Applications release 7.9.6.2 to 7.9.6.3.
This section contains the following procedures:
Section 3.20.1, "Upgrading the Data Warehouse Schema to Version 7.9.6.3"
Section 3.20.2, "Migrating Data Into the Upgraded Data Warehouse"
Follow this procedure to upgrade the data warehouse schema to version 7.9.6.3.
To upgrade the data warehouse schema to version 7.9.6.3:
Generate the scripts to drop and create query indexes. For instructions, see Section B.4, "Generating Scripts to Drop and Create Query Indexes for Upgrading to Release 7.9.6.3."
Run the script to drop query indexes. For instructions, see Section B.5, "Running the Scripts to Drop and Create Query Indexes for Upgrading to Release 7.9.6.3."
If you are using a SQL Server database, run the 7963_UPGRADE_PRE_UPG_CTL_SCRIPT.sql file. This file is located in OracleBI\dwrep\Upgrade\DbScripts\SQLServer.
Run the UPGRADE_7963.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 7963_UPGRADE_PRE_CTL_SCRIPT.sql. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the DDL_7963.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files.".
Follow this procedure to migrate data into the upgraded data warehouse.
To migrate data into the upgraded data warehouse:
Run the 7963_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the 7963_UPGRADE_DROP_ETLINDICES.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade repository. For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Configure the Informatica parameter file 7963_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 7963_UPG_PARAMS.txt."
If you are using Siebel Industry Applications, you need to set an additional parameter in 7963_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 7963_UPG_PARAMS.txt for Siebel Industry Applications Source Systems."
In Informatica Workflow Manager, navigate to the folder UPGRADE_7962_to_7963_SBL and execute the first the UPGRADE_DIMENSIONS workflow and then the UPGRADE_FACTS workflow.
Upgrade geography-related attributes if necessary for your environment:
Determine whether a geography-related upgrade is necessary by executing the following query:
SELECT COUNT(1) as row_count,'0' as X_CUSTOM FROM W_GEO_D_7963 WHERE COUNTRY LIKE '% 'OR COUNTRY LIKE ' %'OR STATE_PROV LIKE '% 'OR STATE_PROV LIKE ' %'OR CITY LIKE '% 'OR CITY LIKE ' %'OR ZIPCODE LIKE '% 'OR ZIPCODE LIKE ' %'
If the query returns a count greater than zero, run the 7963_UPGRADE_POST_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
If the query returns a count of zero, you do not need to run the 7963_UPGRADE_POST_SCRIPT.sql script.
Run the 7963_UPGRADE_CREATE_ETLINDICES.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Run the createQueryIndices.sql script. For instructions, see Section B.5, "Running the Scripts to Drop and Create Query Indexes for Upgrading to Release 7.9.6.3."
Follow this procedure to verify that the data was migrated successfully into the upgraded data warehouse.
To verify the data migrated successfully:
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\Sesslogs directory indicates errors or failures.
Check whether the following scripts that you ran in the SQL client of the database failed or errored out while executing:
7963_UPGRADE_PRE_CTL_SCRIPT.sql
7963_UPGRADE_PRE_DIMENSION.sql
7963_UPGRADE_DROP_ETLINDICES.sql
7963_UPGRADE CREATE_ETLINDICES.sql
dropQueryIndices.sql
createQueryIndices.sql
Check the log files for the ddl_7963.ctl and Upgrade_7963.ctl scripts, which you ran using the DDLimp command, to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables
If the data migration was successful, drop the tables that were created during the upgrade process, such as W_xxxx_x_79x, LKP_xxxx_x and 79x_xxxx_TMP.
This step frees the space occupied by these backup tables.
Once the data migration steps above are complete, you can delete the Upgrade repository to avoid any accidental use or confusion.
In the Informatica Administrator, select the Upgrade repository service.
In the General Properties area of the Properties tab, click Edit.
Make sure the operating mode of the repository service is set to Exclusive.
Click OK.
Choose Actions, and then click Delete Contents.
In the Delete contents for <repository name> dialog, enter the repository username and password, and then click OK.
Perform the procedures in this section to upgrade from Oracle BI Applications release 7.9.6.3 to 7.9.6.4.
This section contains the following procedures:
Section 3.21.1, "Upgrading the Data Warehouse Schema to Version 7.9.6.4"
Section 3.21.2, "Migrating Data into the Upgraded Data Warehouse"
Follow this procedure to upgrade the data warehouse schema to version 7.9.6.4.
To upgrade the data warehouse schema to version 7.9.6.4:
If you are using a DB2 database, run siebproc.sql. This file is located in OracleBI\dwrep\siebproc\db2udb.
Generate the scripts to drop and create query indexes. For instructions, see Section B.6, "Generating Scripts to Drop and Create Query and ETL Indexes for Upgrading to Release 7.9.6.4."
Run the script to drop query indexes. For instructions, see Section B.7, "Running the Scripts to Drop and Create Query Indexes for Upgrading to Release 7.9.6.4."
Note: You must drop the query indexes before running the scripts to upgrade the schema.
If you are using a SQL Server database, run the 7964_UPGRADE_PRE_UPG_CTL_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\SQLServer.
Run the UPGRADE_7964.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Run the 7964_UPGRADE_PRE_CTL_SCRIPT.sql script. This file is located in the folder OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the DDL_7964.ctl script. For instructions, see Appendix E, "Using the DDLimp Utility to Run CTL Files."
Follow this procedure to migrate data into the upgraded data warehouse.
To migrate data into the upgraded data warehouse:
Run the 7964_UPGRADE_PRE_DIMENSION_SCRIPT.sql script. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the script to drop ETL indexes. For instructions, see Section B.8, "Running the Scripts to Drop and Create ETL Indexes for Upgrading to Release 7.9.6.4."
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the Upgrade repository. For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Upgrade Informatica Repository."
Configure the Informatica parameter file 7964_UPG_PARAMS.txt. For instructions, see Appendix A, "Setting Parameters in 7964_UPG_PARAMS.txt."
In Informatica Workflow Manager, navigate to the folder UPGRADE_7963_to_7964_SBL and execute the first the UPGRADE_DIMENSIONS workflow and then the UPGRADE_FACTS workflow.
Run the 7964_UPGRADE_POST_SCRIPT.sql. This file is located in OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Run the script to create ETL indexes. For instructions, see Section B.8, "Running the Scripts to Drop and Create ETL Indexes for Upgrading to Release 7.9.6.4."
OracleBI\dwrep\Upgrade\DbScripts\<database type>.
Use the reset_infa_seq_gen.bat script to initialize the Informatica sequence generator for incremental runs on the base Informatica Repository (for example, Oracle_BI_DW_Base.rep). For instructions, see Appendix D, "Running reset_infa_seq_gen.bat on Base Informatica Repository."
Follow this procedure to verify that the data was migrated successfully into the upgraded data warehouse.
To verify the data migrated successfully:
Validate the data in the upgraded data warehouse.
Check whether any of the Informatica mapping log files stored in the <INFA_HOME>\server\infa_shared\Sesslogs directory indicates errors or failures.
Check whether the following scripts that you ran in the SQL client of the database failed or errored out while executing:
7964_UPGRADE_PRE_CTL_SCRIPT.sql
7964_UPGRADE_PRE_DIMENSION.sql
dropEtlIndices.sql
createEtlIndices.sql
dropQueryIndices.sql
createQueryIndices.sql
Check the log files for the ddl_7964.ctl and Upgrade_7964.ctl scripts, which you ran using the DDLimp command, to determine whether any of the runs failed.
If you did not detect any errors or failures in the steps above, then the data migration was successful.
Note:
Ignore any error messages that indicate tables or indexes could not be dropped from the database. These error messages are displayed when the specified objects do not exist in the database. This can occur because each source system container holds a subset of all data warehouse tables
If the data migration was successful, drop the tables that were created during the upgrade process, such as W_xxxx_x_79x, LKP_xxxx_x and 79x_xxxx_TMP.
This step frees the space occupied by these backup tables.
Once the data migration steps above are complete, you can delete the Upgrade repository to avoid any accidental use or confusion.
In the Informatica Administrator, select the Upgrade repository service.
In the General Properties area of the Properties tab, click Edit.
Make sure the operating mode of the repository service is set to Exclusive.
Click OK.
Choose Actions, and then click Delete Contents.
In the Delete contents for <repository name> dialog, enter the repository username and password, and then click OK.
The Oracle BI Applications 7.9.6.4 installer contains different policy stores for different languages. The default policy store that is deployed during the installation is in English. If you want to configure the policy store for any of the other available languages, perform the procedure below.
To configure the policy store for languages other than English:
Stop the Oracle BI Services.
Copy the system-jazn-data_<LN>.xml file from $ORACLE_BI_HOME\biapps\admin\provisioning\localization\ to $DOMAIN_HOME\config\fmwconfig\.
For example, to implement the policy store for French, you would copy the file system-jazn-data_fr.xml into the \fmwconfig directory.
Back up the existing system-jazn-data.xml file in $DOMAIN_HOME\config\fmwconfig\.
Rename $DOMAIN_HOME\config\fmwconfig\system-jazn-data_<LN>.xml to system-jazn-data.xml.
Start Oracle BI Services.
In this procedure, you will import the standard (out-of-the-box) Oracle BI Applications version 7.9.6.4 LDIF file into the WebLogic Server (embedded LDAP server).
To import the Oracle BI Applications version 7.9.6.4 LDIF file:
Log in to the WebLogic Server Administration Console using the URL http://<host name>:7001/console.
Select the name of the security realm into which the LDIF file is to be imported (for example, myrealm).
Select Providers and then the type of provider into which the LDIF file is to be imported (for example, Providers, and then Authentication).
Select the security provider in which the LDIF file is to be imported and select Migration, and then select Import.
Click Save.
Use the Oracle BI Enterprise Edition Upgrade Assistant to upgrade the following repositories and web catalog from the Oracle BI Enterprise Edition 10g format to the 11g format:
The standard (out-of-the-box) Siebel Analytics Repository version 7.5.x. This repository is the one that you originally received from Oracle as part of your current Siebel Analytics 7.5.x installation. Standard repositories from previous releases are available in the installation folder $ORACLE_BI_HOME\biapps\upgrade.
The Siebel Analytics Repository you are currently using (the repository deployed in production).
The Web Catalog you are currently using (the Web Catalog deployed in production).
For instructions on using the Upgrade Assistant, see Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence.
Note:
If your Siebel Analytics Repository and Web Catalog are in a Siebel Analytics format, you must first upgrade them to the Oracle BI Enterprise Edition 10g format before you can upgrade them to the 11g format. For more information, see the Oracle Business Intelligence Infrastructure Upgrade Guide Version 10.1.3.2, which is located on the Oracle Technology Network in the Oracle Business Intelligence Suite Enterprise Edition Documentation Library Version 10.1.3.4.1.
Note:
Your current policy store will be merged with the Oracle BI Applications release 7.9.6.4 policy store while upgrading the Oracle BI repository from the 10g format to the 11g format. The final policy store will be the super set of Oracle BI Applications release 7.9.6.4 policy store and the custom and current policy information from the 10g repository.
Also, your current users and groups from the repository will be merged with the Oracle BI Applications release 7.9.6.4 identity store while upgrading the Oracle BI repository from the 10g format to the 11g format. The final identity store will be the super set of the Oracle BI Applications release 7.9.6.4 identity store and the identity store information (users and groups) from the 10g repository.
If you require the policy store to be in a language other than English, perform the steps in Section 3.22, "Localizing the Policy Store."
Note:
Before you begin this procedure, you must have already upgraded your Siebel Analytics repository to the Oracle BI Enterprise Edition 11g format. For more information, see Section 3.24, "Upgrading the Siebel Analytics Repository and Web Catalog to the Oracle BI Enterprise Edition 11g Version."
This process merges your customizations of a prior release of the Siebel Analytics repository with the new version of the Oracle BI repository. Before you begin this process, make sure you have backed up and renamed your existing repository
To upgrade the repository, perform the following tasks:
The tasks in this section refer to multiple releases of the Oracle BI repository. Table 3-1 provides the names and descriptions of the repositories used in the examples in this section.
Table 3-1 Names of Analytics Repositories used in Examples
Name of Repository | Description |
---|---|
SiebelAnalytics_7x.rpd |
The standard Siebel Analytics repository for the version you are upgrading from. Note: Standard repositories from previous releases are available in the folder $ORACLE_BI_HOME\biapps\upgrade. |
OracleBIAnalyticsApps.rpd |
The standard Oracle BI repository for the version you are upgrading to. |
Customer_SiebelAnalyticsApps.rpd |
The Siebel Analytics repository that contains your customizations for the version you are upgrading from. |
Merged_Repository_OracleBI.rpd |
The Oracle BI repository that contains your customizations for the version you are upgrading to. |
Follow this procedure to prepare for the repository upgrade.
To prepare for the Analytics repository upgrade:
Set up a directory for the merge process, such as \OracleBIUpgrade, and create the following subfolders:
Original
AfterEqualize
AfterMerge
AfterManualWork
AfterRegressions
Copy the following repositories to the folder \OracleBIUpgrade\Original:
The standard (original) repository that you upgraded to the 11g format in Section 3.24, "Upgrading the Siebel Analytics Repository and Web Catalog to the Oracle BI Enterprise Edition 11g Version" (for example, SiebelAnalytics.rpd).
The production repository that you also upgraded to the 11g format in Section 3.24 (for example, Customer_SiebelAnalyticsApps.rpd.
The Oracle BI repository from the latest installation (for example, OracleBIAnalyticsApps.rpd)
If, in your current environment, you are running Siebel Analytics for one or more modules using a Siebel Analytics repository in which you extracted the corresponding projects for the modules from the standard Siebel Analytics repository file you received from the previous release, you need to extract the same projects from the SiebelAnalytics_7x.rpd file and use this as your original repository. (If you have the original repository that you extracted during the last upgrade, you can use it as the original repository file.) This will prevent you from losing any new metadata you would like to add in this upgrade.
Also, if you customized the Siebel Analytics repository by trimming a large number of objects and you would like to get those objects back during the current upgrade, you need to trim the original SiebelAnalytics_7x.rpd file in the same way and use the modified version as the original repository file. This will prevent you from losing any new metadata you would like to add in this upgrade.
The Merge feature in the Administration Tool relies on a change detection algorithm to determine the changes that need to be made to upgrade repositories correctly. For the algorithm to work correctly, it has to determine which objects in the three repositories (for example, siebelAnalyticsApps_79x.rpd, OracleBIAnalyticsApps.rpd, and Customer_SiebelAnalyticsApps.rpd) are equivalent.
The point of this step is to determine for every object in the OracleBIAnalyticsApps.rpd and the Customer_SiebelAnalyticsApps.rpd whether it is coming from the SiebelAnalyticsApps_79x.rpd.
Equivalence between objects is established using the Administration Tool's Equalize feature. The file that you specify in the Output option (-O)
is the only file that is modified during the equalization process.
The Equalize feature has several mechanisms for determining whether an object in two different repositories is semantically the same:
Fully Qualified Name. If an object in one repository has the same fully qualified name as another object of the same class in another repository, then the two objects are declared equal.
Simple String Substitution. Equivalence can be declared between two objects of the same class in two repositories whose only difference is that some key characters in their names differ. The equalizerpds executable file ignores those characters while checking fully qualified names. For example, "Core"."W_DAY_D" might be considered equivalent to "Core"."W DAY D" if the characters "_" and " " have been declared as equivalent.
Rename File. When none of the preceding rules are applicable, equivalence can be manually declared using a script as input to the equalizerpds executable file. Oracle ships the rename files (MAP) for the major releases. The files are located in the $ORACLE_BI_HOME\biapps\upgrade folder. You can also create your own rename files for customizations not covered in the files that Oracle ships. You can open and edit the rename files in Microsoft Excel.
Table 3-2 provides a list of the available MAP files and the Siebel Analytics or Oracle BI Applications release version associated with the file.
Table 3-2 Rename MAP Files to Be Used for Various Releases
Siebel Analytics / Oracle Business Intelligence Applications Release Version (Upgrading from DW Version) | Rename MAP File to Be Used |
---|---|
Siebel Business Analytics Applications 7.0.x |
Not available |
Siebel Business Analytics Applications 7.5.x |
Not available |
Siebel Business Analytics Applications 7.7.x (with Siebel CRM OLTP Pre-7.7.0) |
rename77-7964.map |
Siebel Business Analytics Applications 7.7.x (with Siebel CRM OLTP 7.7.0) |
rename771-7964.map |
Siebel Business Analytics Applications 7.8.2 and all 7.8.x versions before this release |
rename782-7964.map |
Siebel Business Analytics Applications 7.8.3 and all 7.8.x versions after this release |
rename783-7964.map |
Oracle BI Applications 7.9.0 |
rename79x-7964.map |
Oracle BI Applications 7.9.1 |
rename79x-7964.map |
Oracle BI Applications 7.9.2 |
rename79x-7964.map |
Oracle BI Applications 7.9.3 |
rename793to7964.map |
Oracle BI Applications 7.9.4 |
rename794to7964.map |
Oracle BI Applications 7.9.5 |
rename79x-7964.map |
Oracle BI Applications 7.9.5.1 |
rename7951to7964.map |
Oracle BI Applications 7.9.5.2 |
rename7951to7964.map |
Oracle BI Applications 7.9.6 |
rename79x-7964.map |
Oracle BI Applications 7.9.6.2 |
rename7963to7964.map Not required for upgrades from 7.9.6.2 to 7.9.6.3. |
Oracle BI Applications 7.9.6.3 |
rename7963to7964.map |
The syntax of the equalizerpds command is as follows:
equalizerpds.exe [-B [password1]] -C base_repository_name [-E [password2]] -F repository2_name [-J udml_utf8_file_name_equalization] [-O ouput_repository_name] [-Y equalStringSet] -Y Treat the characters as equals. /? Display this usage information and exit.
To equalize a repository:
Copy the appropriate MAP file from the $ORACLE_BI_HOME\biapps\upgrade folder into the folder where you will execute equalizerpds.exe, for example, \OracleBIUpgrade\Original.
Run equalizerpds.exe to equalize the repository from the latest installation (for example, OracleBIAnalyticsApps.rpd) with the original repository (for example, SiebelAnalyticsAppss_7x.rpd). An example of the equalizerpds command is as follows:
equalizerpds -B SADMIN -C \\OracleBIUpgrade\Original\SiebelAnalytics_7x.rpd -D Administrator -E SADMIN -F \\OracleBIUpgrade\Original\OracleBIAnalyticsApps.rpd -O \\OracleBIAnalyticsUpgrade\AfterEqualize\OracleBIAnalyticsApps.rpd -X -J rename7x-79.map
The MAP files are located in the $ORACLE_BI_HOME\biapps\upgrade folder.
If the equalizerpds.exe executable file runs correctly, no errors are returned.
Run equalizerpds.exe to equalize your customized repository (for example, Customer_SiebelAnalytics.rpd) with the original repository (for example, SiebelAnalytics_79x.rpd). An example of the equalizerpds command is as follows:
equalizerpds -B SADMIN -C \\OracleBIUpgrade\Original\SiebelAnalytics_7x.rpd -E SADMIN -F \\OracleBIUpgrade\Original\Customer_SiebelAnalytics.rpd -O \\OracleBIUpgrade\AfterEqualize\Customer_SiebelAnalytics.rpd
The execution of equalizerpds that equalizes the customer repository with the original repository does not use the rename file.
Make sure that the original repository is copied unchanged into its new location so that after running the script, all three repositories are contained within the \OracleBIUpgrade\AfterEqualize directory.
To verify the process completed successfully, compare the size of the repositories. The output repository (-O) should be close to the same size as the repository you equalized (-F).
Follow this procedure to compare your existing repository with the new version to which you are upgrading.
To compare the Oracle BI repositories:
Use the Administration Tool's Compare Repositories feature to analyze the differences between your existing repository and the new version of the repository to which you are upgrading. Note where elements have been created, removed, or changed in the new version. Consider whether you can use the new metadata and retire customizations you made in the existing repository.
For instructions on how to use the Administration Tool's Compare Repositories feature, see Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.
In this procedure, you execute the main algorithm to upgrade the repository. For more information on merging the repositories, see Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.
To merge versions of the Oracle BI repositories:
Copy the three repositories (for example, SiebelAnalytics_7x.rpd, OracleBIAnalyticsApps.rpd, and Customer_SiebelAnalytics.rpd) to the AfterMerge folder.
Open the repository from the latest installation (for example, OracleBIAnalyticsApps.rpd) in the \OracleBIUpgrade\AfterMerge folder.
From the Administration Tool menu bar, select File, then select Merge.
Select the Merge Type option Full Repository Merge.
In the Select Original Repository dialog box, select the original repository (for example, SiebelAnalytics_7x.rpd).
Enter the password for the original repository.
In the Select Modified Repository dialog box, select the repository that contains the customizations you made to the previous version of the Analytics repository.
Enter the password for the modified repository.
In the Saved Merged Repository as dialog box, enter the name for the merged repository, for example, Merged_Repository_OracleBIAnalyticsApps.rpd.
The new repository will contain the final results of the merge.
Select the Equalize during merge check box.
Click Next.
In the Decision drop-down list, select the action you want to take regarding the repository change, or accept the default action.
To locate subsequent rows with empty Decision fields, click the Decision header cell.
When all rows have a value in the Decision field, the Finish button is enabled.
Select the Check consistency of the merged RPD check box.
Click Finish.
This process can take up to 40 minutes, depending on the size of the repositories you are working with. A message will alert you when the merge is complete.
The number of errors returned by the consistency check is an indication of how successful the merge process was. If you receive many errors, for example, over 300, you should analyze the reason for the errors. If the merge process failed to recognize that two objects are the same, you may need to edit the rename file if the object is in the Current repository, or add your own rename file if you have renamed many of the objects and the upgrade engine failed to relate them to the original objects.
You also may need to change the actions you selected in the Decision drop-down list before rerunning the merge. This could save you time by reducing the number of errors that you will need to fix manually.
Once you are satisfied with the results of the merge, you should fix the remaining errors manually. It is important that you fix all errors before moving on to the next step. This repository serves as the input for the next stage.
You should also check that all of your customized objects are present and that no duplicate physical tables were introduced. To check for duplicate tables, search for physical tables using a query such as:
where name like '*#1'
Copy the repository to the folder \OracleBIUpgrade\AfterManualWork.
Note:
Before you begin this procedure, you must have already upgraded your current (custom) catalog to the Oracle BI Enterprise Edition 11g format. For more information, see Section 3.24, "Upgrading the Siebel Analytics Repository and Web Catalog to the Oracle BI Enterprise Edition 11g Version."
You need to perform the following tasks to complete the presentation merge process.
These procedures use the following terminology to identify the various presentation catalogs you will use in the merge process:
The original presentation catalog. This is the unmodified presentation catalog that you received with the Oracle BI Applications release that you are upgrading from.
The new presentation catalog. This is the standard Oracle BI Applications 7.9.6.4 presentation catalog that is installed with Oracle BI Applications.
The current presentation catalog. This is the presentation catalog currently in use at your organization.
Caution:
In releases of Oracle BI Applications previous to 7.9, the Oracle BI Presentation Catalog (formerly known as the Siebel Analytics Web Catalog) was stored in a single file rather than in a directory structure of individual files. If you have a previous version of the Presentation Catalog, you will need to convert it to the new format. For more information about how to convert the Presentation Catalog to the new format, see the Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence
Before you upgrade and merge your current Presentation Catalog with the new Presentation Catalog, determine which of the existing content you want to keep and which new content you want to incorporate. Review your existing Presentation Catalog and determine the usage patterns of reports and dashboards. Note that some of the preconfigured content in the existing catalog may appear in the new version in a redesigned format. In addition, the new version includes completely new content. After you have decided the content that is to make up your enterprise Presentation Catalog, trim the input catalogs using the Catalog Manager. For information on trimming catalogs, see Oracle Business Intelligence Presentation Services Administration Guide.
Note:
Before you begin this procedure, you must have already upgraded your current (custom) catalog to the Oracle BI Enterprise Edition 11g format. For more information, see Section 3.24, "Upgrading the Siebel Analytics Repository and Web Catalog to the Oracle BI Enterprise Edition 11g Version."
Follow the instructions in this section to merge the Oracle BI Applications version 7.9.6.4 presentation catalog with the catalog you are currently using. This procedure uses the Oracle BI Enterprise Edition Catalog Manager. High-level steps for the merge process are provided in this section. For detailed instructions on using the Catalog Manager, see the chapter "Configuring and Managing the Oracle BI Presentation Catalog," in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition 11g Release 1 (11.1.1).
To merge the Oracle BI Applications version 7.9.6.4 presentation catalog with the current (custom) catalog:
Start the Catalog Manager, and open your current (custom) presentation catalog in offline mode.
For instructions, see "Starting Catalog Manager and Opening Catalogs," in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition 11g Release 1 (11.1.1).
Start another instance of the Catalog Manager, and open the Oracle BI Applications version 7.9.6.4 (out-of-the-box) presentation catalog in offline mode.
Copy and paste the custom objects from your current presentation catalog into the Oracle BI Applications version 7.9.6.4 (out-of-the-box) presentation catalog.
For instructions, see "Working with Objects in Catalog Manager," in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition 11g Release 1 (11.1.1).
If you created custom catalog groups that are not in the version 7.9.6.4 presentation catalog, you need to convert the custom catalog groups to application roles in order to maintain consistency with the version 7.9.6.4 presentation catalog.
To convert custom catalog groups to application roles, run the following command:
runcat.cmd/runcat.sh -cmd replaceAccountInPermissions -old <Catalog Group Name> -oldType group -new <App Role Name> -newType role -offline <catalog path>
For example:
runcat.cmd -cmd replaceAccountInPermissions -old "AP Analyst" -oldType group -new "AP Analyst" -newType role -offline c:/SampleWebcat
This command replaces a specified account with another in all catalog object ACLs and privileges in the presentation catalog, entirely in the offline mode. If an entirely new application role is specified as the replacement account, then it is necessary to refresh the GUIDs in the presentation catalog before it can be used.
Note: If the specified replacement user or group is not already present in the presentation catalog 11g Release 1 (11.1.1) already, then this operation will fail.
For more information, see the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition 11g Release 1 (11.1.1).
Note:
Before you perform this step, you must first migrate the data into the upgraded data warehouse.
The Presentation Catalog upgrade functionality does not automatically carry over object permissions; therefore, you should review the Presentation Catalog object permissions before you perform this step.
This step ensures that the upgraded reports and the new preconfigured reports are functional and render correct results within the new, merged Presentation Catalog. This step is typically performed by visually inspecting the final results of the complete end-to-end upgrade process.
For upgraded reports, the preferred approach for comparison purposes is to have side-by-side environments, and have users review specific dashboard content between the two environments. Examine not only the look and feel of the application but also the data contained in the reports to make sure the content remains the same. It is recommended that you request users to use various elements of the user interface to validate results, such as global prompts, column selectors, report filters, drills, and navigations, as they normally do on a day-to-day basis.
Also review the overall visibility and administrative settings in the new Presentation Catalog to ensure they are correct. Pay careful attention to the visibility rules that are established for any content that was migrated during the upgrade. You might have to manually adjust these settings.
In performing a regression test for the repository merge, the objective is to collect a set of logical SQL statements that are used for reports and to verify that they continue to work with the new metadata. For this purpose, it is recommended that you perform the following procedure.
To perform regression testing:
Run the reports that are necessary to include in the regression suite. These reports might be a subset of the reports in the presentation catalog.
Collect the logical SQL generated in the previous step. You can do this using Usage Tracking or by parsing the query log file.
For information about Usage Tracking, see Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.
Execute the logical SQL against the old repository using the command line utility nQCmd.exe located in $ORACLE_BI_HOME\bifoundation\server\bin, and save the results to a file.
For information about the nQCmd.exe utility, see Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition.
Edit the logical SQL test scripts to account for the name changes or modifications resulting from the upgrade.
Execute the edited logical SQL against the merged repository, and save the results.
Compare the results from the steps above and try to explain the differences. If it is determined that these differences are due to the upgrade process, then you have to correct them manually.
This repository now contains the merged content from the new OracleBIAnalyticsApps.rpd and the production repository.