Oracle BI Applications 11.1.1.8.1 Upgrade Guide (Doc ID 1673221.1) Contents Contents............................................................. 1 Overview............................................................. 3 Pre-requisites....................................................... 4 Part 1 - BI Applications Infrastructure, Metadata and Schema Upgrades 4 Downloading BI Applications 11.1.1.8.1 software and files...........4 Upgrading the BI Applications binaries to version 11.1.1.8.1........4 Applying Fusion Middleware Platform Patches for BI Applications 11.1.1.8.1..........................................................6 Upgrading the JAZN file.............................................8 Upgrading BIACOMP and BIACM_IO schemas..............................9 Upgrading ATG, FSM and BIACM.....................................10 Upgrading the BIACM_IO Schema....................................14 Granting Privileges to <prefix>_BIACM_IO schema..................16 Enabling Deployment Changes to ATG and FSM in the BI Domain........16 Upgrading the RPD and Presentation Catalog.........................17 Correcting the Directory Name for Code Grants......................19 Applying Additional Patches........................................20
83
Embed
Oracle BI Applications 11.1.1.8.1 Upgrade Guide Doc ID 1673221.1
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Oracle BI Applications 111181 Upgrade Guide (Doc ID 16732211)
ContentsContents1
Overview3
Pre-requisites4
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades4
Downloading BI Applications 111181 software and files4
Upgrading the BI Applications binaries to version 1111814
Applying Fusion Middleware Platform Patches for BI Applications 1111816
Upgrading the JAZN file8
Upgrading BIACOMP and BIACM_IO schemas9
Upgrading ATG FSM and BIACM10
Upgrading the BIACM_IO Schema14
Granting Privileges to ltprefixgt_BIACM_IO schema16
Enabling Deployment Changes to ATG and FSM in the BI Domain16
Upgrading the RPD and Presentation Catalog17
Correcting the Directory Name for Code Grants19
Applying Additional Patches20
Applying the Dynamic Monitoring Service Patch20
Applying the ODI Patch to ODI Studio20
Applying Patches to BI Administration Tool20
Upgrading the ODI Repository21
Creating a Back up of the 111171 ODI Repository22
Exporting Content from the 111171 ODI Repository22
Noting the ID of the 111171 ODI Repository28
Dropping the 111171 ODI Repository Schema30
Creating the ODI Repository for BI Applications 11118131
Connecting to the ODI Repository for 11118133
Changing the ID of the 111181 ODI Repository33
Importing Content into the 111181 ODI Repository36
Regenerating Load Plans49
Part II - Business Analytics Warehouse Schema and Data Upgrades49
Granting New Required Privileges to ltprefixgt_DW50
Identifying the Upgrade Load Plans to Execute51
Modifying the Upgrade Load Plans51
Upgrading the Business Analytics Warehouse Schema54
Running Domains-Only Load Plan(s)55
Performing Domain Member Mappings56
Upgrading Data in the Business Analytics Warehouse (Data Migration)56
Synchronizing the Data Model56
Performing Pre-Upgrade Tasks57
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse62
Post-Upgrade Tasks64
ltEnd Statementsgt66
Appendix66
Creating a Connection in ODI to the 111171 Back-up ODI Repository66
Post-Upgrade SQL Statements67
This document describes the steps to upgrade BI Applications 111171 to version 111181
Overview
The Upgrade of BI Applications 111171 to version 111181 consists of the upgrade of the following components repositories (schema and content) and data
1 Platform components
2 BI Applications binaries
3 JAZN RPD and Presentation Catalog
4 BI Applications Component Repository (BIACOMP)
5 ODI Repository content (BIA_ODIREPO)
6 Business Analytics Warehouse (DW) - schema
7 Data Migration of existing data in the Business Analytics Warehouse
NOTE The upgrade from BI Applications 796x to BI Applications 111181 is not supported
Sequence of Steps
The sequence of the steps in the upgrade of BI Applications 1111171 to 111181 is outlined below
1 Complete Upgrade Pre-requsites
2 Run the BI Applications 111181 installer to upgrade the BI Application binaries from version 111171 to 111181
3 Apply the FMW Middleware Patches for BI Applications 111181
4 Use the BI Update Metadata Tool to upgrade the JAZN
5 Use the BI Applications Upgrade Tool to upgrade the BIACOMP schema (ATGLite FSM and BIACM component upgrades)
6 Run scripts to enable deployment changes in BI Applications 111181
7 Upgrade the RPD and Presentation Catalog
8 Upgrade the ODI Repository metadata (content)
9 Upgrade Business Analytics Warehouse schema and Migrate Data in Data Warehouse
Instructions for each step of the upgrade process are provided below
Pre-requisites
Complete the following pre-requisites before performing the upgrade from BI Applications 111171 to BI Applications 111181
Before upgrading your BI Applications 111171 environment to version 111181 you must have at minimum applied Patch 17546336 ODI Cumulative Patch 1 The ODI Cumulative Patch for BI Applications 111171 is available on My Oracle Support gt Patches amp Updates
Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
Review the Certification Matrix for BI Applications version 111181 The Certification Matrix is available on the Fusion Middleware Certification Page on Oracle Technology Network (OTN)
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Download the BI Applications 111181 installer the BI Applications Repository Creation Utility (RCU) 111181 and the FMW Platform Patch zip files from the Oracle Business Intelligence Applications 111181 Media Pack available on Oracle Software Delivery Cloud
Upgrading the BI Applications binaries to version 111181
1 Shut down the WebLogic Administration Server BI and ODI Managed Servers and Node Manager Shut down BI processes using Oracle Process Manager and Notification Server (OPMN)
2 On the machine which hosts the Middleware Home and BI Oracle Home for the BI Applications 111171 environment run the BI Applications 111181 installer
On Windows
setupexe ndashjreLoc ltJDK or JRockit locationgt
On Linux or UNIX
runInstaller -jreLoc ltjdk or jrockit locationgt
The Installer displays the Welcome screen Click Next
3 The Prerequisites Check screen is displayed Click Next
4 The Specify Installation Location screen displays the MW_HOME and BI_ORACLE_HOME for your existing BI Applications 111171 environment Verify the locations and click Next
5 A Warning dialog is received asking if you wish to upgrade the existing BI_ORACLE_HOME Click Yes
6 On the Summary screen review the installation details and click the Install button to proceed
7 Click Next on the Installation Progress screen when the installation is complete
8 Click Finish on the Complete screen to complete the installation
Do not start Weblogic servers and BI processes at this time
Applying Fusion Middleware Platform Patches for BI Applications 111181
You must apply Fusion Middleware platform patches for BI Applications 111181 The patches are available for download as part of the Oracle Business Intelligence Applications 111181 media pack
The minimum version of Oracle BI EE supported for BI Applications 111181 is BI EE 111170 with Bundle Patch 131017 The patches from Bundle Patch 131017 are included and will be applied to BI EE 111170 If you have already applied BI EE Bundle Patch 131017 or higher to your BI EE environment for BI Applications 111171 then the BI EE patches will not be applied as part of this step
The version of ODI used by BI Applications has not change between BI Applications 111171 and 111181 The version of ODI supported for BI Applications 111181 is 111170 An ODI patch is applied to 111170 as part of this FMW patch application step
To apply platform patches
NOTE You will run a script to apply the patches The script is a Perl script and is available in ltBI_Oracle_HomegtbiappstoolsbinAPPLY_PATCHESpl
The Perl script you will run to apply the patches requires a parameter input file (apply_patches_importtxt) In this procedure before you run the Perl script you will update the parameter input file to reflect the appropriate directory pathss
1 Ensure that the WebLogic Administration Server BI and ODI Managed Servers Node Manager and BI processes are shut down
2 Download Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications and Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications for ltOSgt from the Oracle Business Intelligence Applications 111181 media pack on Oracle Software Delivery Cloud Download all parts
3 Extract all zip files into the same Patch Home directory as follows
Extract the contents of the downloaded zip files containing the patches into the same directory for example Cpatches or PATCH_HOMEpatches
Note The directory structure of the extracted contents is not patches4fadistps6rc3 The patches are contained in folders biappsshiphome odi weblogic and oracle_common You do not have to unzip the individual patches
4 Update the parameter input file (apply_patches_importtxt) to reflect the paths as specified in the text file
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Creating a Back up of the 111171 ODI Repository22
Exporting Content from the 111171 ODI Repository22
Noting the ID of the 111171 ODI Repository28
Dropping the 111171 ODI Repository Schema30
Creating the ODI Repository for BI Applications 11118131
Connecting to the ODI Repository for 11118133
Changing the ID of the 111181 ODI Repository33
Importing Content into the 111181 ODI Repository36
Regenerating Load Plans49
Part II - Business Analytics Warehouse Schema and Data Upgrades49
Granting New Required Privileges to ltprefixgt_DW50
Identifying the Upgrade Load Plans to Execute51
Modifying the Upgrade Load Plans51
Upgrading the Business Analytics Warehouse Schema54
Running Domains-Only Load Plan(s)55
Performing Domain Member Mappings56
Upgrading Data in the Business Analytics Warehouse (Data Migration)56
Synchronizing the Data Model56
Performing Pre-Upgrade Tasks57
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse62
Post-Upgrade Tasks64
ltEnd Statementsgt66
Appendix66
Creating a Connection in ODI to the 111171 Back-up ODI Repository66
Post-Upgrade SQL Statements67
This document describes the steps to upgrade BI Applications 111171 to version 111181
Overview
The Upgrade of BI Applications 111171 to version 111181 consists of the upgrade of the following components repositories (schema and content) and data
1 Platform components
2 BI Applications binaries
3 JAZN RPD and Presentation Catalog
4 BI Applications Component Repository (BIACOMP)
5 ODI Repository content (BIA_ODIREPO)
6 Business Analytics Warehouse (DW) - schema
7 Data Migration of existing data in the Business Analytics Warehouse
NOTE The upgrade from BI Applications 796x to BI Applications 111181 is not supported
Sequence of Steps
The sequence of the steps in the upgrade of BI Applications 1111171 to 111181 is outlined below
1 Complete Upgrade Pre-requsites
2 Run the BI Applications 111181 installer to upgrade the BI Application binaries from version 111171 to 111181
3 Apply the FMW Middleware Patches for BI Applications 111181
4 Use the BI Update Metadata Tool to upgrade the JAZN
5 Use the BI Applications Upgrade Tool to upgrade the BIACOMP schema (ATGLite FSM and BIACM component upgrades)
6 Run scripts to enable deployment changes in BI Applications 111181
7 Upgrade the RPD and Presentation Catalog
8 Upgrade the ODI Repository metadata (content)
9 Upgrade Business Analytics Warehouse schema and Migrate Data in Data Warehouse
Instructions for each step of the upgrade process are provided below
Pre-requisites
Complete the following pre-requisites before performing the upgrade from BI Applications 111171 to BI Applications 111181
Before upgrading your BI Applications 111171 environment to version 111181 you must have at minimum applied Patch 17546336 ODI Cumulative Patch 1 The ODI Cumulative Patch for BI Applications 111171 is available on My Oracle Support gt Patches amp Updates
Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
Review the Certification Matrix for BI Applications version 111181 The Certification Matrix is available on the Fusion Middleware Certification Page on Oracle Technology Network (OTN)
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Download the BI Applications 111181 installer the BI Applications Repository Creation Utility (RCU) 111181 and the FMW Platform Patch zip files from the Oracle Business Intelligence Applications 111181 Media Pack available on Oracle Software Delivery Cloud
Upgrading the BI Applications binaries to version 111181
1 Shut down the WebLogic Administration Server BI and ODI Managed Servers and Node Manager Shut down BI processes using Oracle Process Manager and Notification Server (OPMN)
2 On the machine which hosts the Middleware Home and BI Oracle Home for the BI Applications 111171 environment run the BI Applications 111181 installer
On Windows
setupexe ndashjreLoc ltJDK or JRockit locationgt
On Linux or UNIX
runInstaller -jreLoc ltjdk or jrockit locationgt
The Installer displays the Welcome screen Click Next
3 The Prerequisites Check screen is displayed Click Next
4 The Specify Installation Location screen displays the MW_HOME and BI_ORACLE_HOME for your existing BI Applications 111171 environment Verify the locations and click Next
5 A Warning dialog is received asking if you wish to upgrade the existing BI_ORACLE_HOME Click Yes
6 On the Summary screen review the installation details and click the Install button to proceed
7 Click Next on the Installation Progress screen when the installation is complete
8 Click Finish on the Complete screen to complete the installation
Do not start Weblogic servers and BI processes at this time
Applying Fusion Middleware Platform Patches for BI Applications 111181
You must apply Fusion Middleware platform patches for BI Applications 111181 The patches are available for download as part of the Oracle Business Intelligence Applications 111181 media pack
The minimum version of Oracle BI EE supported for BI Applications 111181 is BI EE 111170 with Bundle Patch 131017 The patches from Bundle Patch 131017 are included and will be applied to BI EE 111170 If you have already applied BI EE Bundle Patch 131017 or higher to your BI EE environment for BI Applications 111171 then the BI EE patches will not be applied as part of this step
The version of ODI used by BI Applications has not change between BI Applications 111171 and 111181 The version of ODI supported for BI Applications 111181 is 111170 An ODI patch is applied to 111170 as part of this FMW patch application step
To apply platform patches
NOTE You will run a script to apply the patches The script is a Perl script and is available in ltBI_Oracle_HomegtbiappstoolsbinAPPLY_PATCHESpl
The Perl script you will run to apply the patches requires a parameter input file (apply_patches_importtxt) In this procedure before you run the Perl script you will update the parameter input file to reflect the appropriate directory pathss
1 Ensure that the WebLogic Administration Server BI and ODI Managed Servers Node Manager and BI processes are shut down
2 Download Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications and Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications for ltOSgt from the Oracle Business Intelligence Applications 111181 media pack on Oracle Software Delivery Cloud Download all parts
3 Extract all zip files into the same Patch Home directory as follows
Extract the contents of the downloaded zip files containing the patches into the same directory for example Cpatches or PATCH_HOMEpatches
Note The directory structure of the extracted contents is not patches4fadistps6rc3 The patches are contained in folders biappsshiphome odi weblogic and oracle_common You do not have to unzip the individual patches
4 Update the parameter input file (apply_patches_importtxt) to reflect the paths as specified in the text file
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
This document describes the steps to upgrade BI Applications 111171 to version 111181
Overview
The Upgrade of BI Applications 111171 to version 111181 consists of the upgrade of the following components repositories (schema and content) and data
1 Platform components
2 BI Applications binaries
3 JAZN RPD and Presentation Catalog
4 BI Applications Component Repository (BIACOMP)
5 ODI Repository content (BIA_ODIREPO)
6 Business Analytics Warehouse (DW) - schema
7 Data Migration of existing data in the Business Analytics Warehouse
NOTE The upgrade from BI Applications 796x to BI Applications 111181 is not supported
Sequence of Steps
The sequence of the steps in the upgrade of BI Applications 1111171 to 111181 is outlined below
1 Complete Upgrade Pre-requsites
2 Run the BI Applications 111181 installer to upgrade the BI Application binaries from version 111171 to 111181
3 Apply the FMW Middleware Patches for BI Applications 111181
4 Use the BI Update Metadata Tool to upgrade the JAZN
5 Use the BI Applications Upgrade Tool to upgrade the BIACOMP schema (ATGLite FSM and BIACM component upgrades)
6 Run scripts to enable deployment changes in BI Applications 111181
7 Upgrade the RPD and Presentation Catalog
8 Upgrade the ODI Repository metadata (content)
9 Upgrade Business Analytics Warehouse schema and Migrate Data in Data Warehouse
Instructions for each step of the upgrade process are provided below
Pre-requisites
Complete the following pre-requisites before performing the upgrade from BI Applications 111171 to BI Applications 111181
Before upgrading your BI Applications 111171 environment to version 111181 you must have at minimum applied Patch 17546336 ODI Cumulative Patch 1 The ODI Cumulative Patch for BI Applications 111171 is available on My Oracle Support gt Patches amp Updates
Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
Review the Certification Matrix for BI Applications version 111181 The Certification Matrix is available on the Fusion Middleware Certification Page on Oracle Technology Network (OTN)
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Download the BI Applications 111181 installer the BI Applications Repository Creation Utility (RCU) 111181 and the FMW Platform Patch zip files from the Oracle Business Intelligence Applications 111181 Media Pack available on Oracle Software Delivery Cloud
Upgrading the BI Applications binaries to version 111181
1 Shut down the WebLogic Administration Server BI and ODI Managed Servers and Node Manager Shut down BI processes using Oracle Process Manager and Notification Server (OPMN)
2 On the machine which hosts the Middleware Home and BI Oracle Home for the BI Applications 111171 environment run the BI Applications 111181 installer
On Windows
setupexe ndashjreLoc ltJDK or JRockit locationgt
On Linux or UNIX
runInstaller -jreLoc ltjdk or jrockit locationgt
The Installer displays the Welcome screen Click Next
3 The Prerequisites Check screen is displayed Click Next
4 The Specify Installation Location screen displays the MW_HOME and BI_ORACLE_HOME for your existing BI Applications 111171 environment Verify the locations and click Next
5 A Warning dialog is received asking if you wish to upgrade the existing BI_ORACLE_HOME Click Yes
6 On the Summary screen review the installation details and click the Install button to proceed
7 Click Next on the Installation Progress screen when the installation is complete
8 Click Finish on the Complete screen to complete the installation
Do not start Weblogic servers and BI processes at this time
Applying Fusion Middleware Platform Patches for BI Applications 111181
You must apply Fusion Middleware platform patches for BI Applications 111181 The patches are available for download as part of the Oracle Business Intelligence Applications 111181 media pack
The minimum version of Oracle BI EE supported for BI Applications 111181 is BI EE 111170 with Bundle Patch 131017 The patches from Bundle Patch 131017 are included and will be applied to BI EE 111170 If you have already applied BI EE Bundle Patch 131017 or higher to your BI EE environment for BI Applications 111171 then the BI EE patches will not be applied as part of this step
The version of ODI used by BI Applications has not change between BI Applications 111171 and 111181 The version of ODI supported for BI Applications 111181 is 111170 An ODI patch is applied to 111170 as part of this FMW patch application step
To apply platform patches
NOTE You will run a script to apply the patches The script is a Perl script and is available in ltBI_Oracle_HomegtbiappstoolsbinAPPLY_PATCHESpl
The Perl script you will run to apply the patches requires a parameter input file (apply_patches_importtxt) In this procedure before you run the Perl script you will update the parameter input file to reflect the appropriate directory pathss
1 Ensure that the WebLogic Administration Server BI and ODI Managed Servers Node Manager and BI processes are shut down
2 Download Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications and Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications for ltOSgt from the Oracle Business Intelligence Applications 111181 media pack on Oracle Software Delivery Cloud Download all parts
3 Extract all zip files into the same Patch Home directory as follows
Extract the contents of the downloaded zip files containing the patches into the same directory for example Cpatches or PATCH_HOMEpatches
Note The directory structure of the extracted contents is not patches4fadistps6rc3 The patches are contained in folders biappsshiphome odi weblogic and oracle_common You do not have to unzip the individual patches
4 Update the parameter input file (apply_patches_importtxt) to reflect the paths as specified in the text file
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
7 Upgrade the RPD and Presentation Catalog
8 Upgrade the ODI Repository metadata (content)
9 Upgrade Business Analytics Warehouse schema and Migrate Data in Data Warehouse
Instructions for each step of the upgrade process are provided below
Pre-requisites
Complete the following pre-requisites before performing the upgrade from BI Applications 111171 to BI Applications 111181
Before upgrading your BI Applications 111171 environment to version 111181 you must have at minimum applied Patch 17546336 ODI Cumulative Patch 1 The ODI Cumulative Patch for BI Applications 111171 is available on My Oracle Support gt Patches amp Updates
Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
Review the Certification Matrix for BI Applications version 111181 The Certification Matrix is available on the Fusion Middleware Certification Page on Oracle Technology Network (OTN)
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Download the BI Applications 111181 installer the BI Applications Repository Creation Utility (RCU) 111181 and the FMW Platform Patch zip files from the Oracle Business Intelligence Applications 111181 Media Pack available on Oracle Software Delivery Cloud
Upgrading the BI Applications binaries to version 111181
1 Shut down the WebLogic Administration Server BI and ODI Managed Servers and Node Manager Shut down BI processes using Oracle Process Manager and Notification Server (OPMN)
2 On the machine which hosts the Middleware Home and BI Oracle Home for the BI Applications 111171 environment run the BI Applications 111181 installer
On Windows
setupexe ndashjreLoc ltJDK or JRockit locationgt
On Linux or UNIX
runInstaller -jreLoc ltjdk or jrockit locationgt
The Installer displays the Welcome screen Click Next
3 The Prerequisites Check screen is displayed Click Next
4 The Specify Installation Location screen displays the MW_HOME and BI_ORACLE_HOME for your existing BI Applications 111171 environment Verify the locations and click Next
5 A Warning dialog is received asking if you wish to upgrade the existing BI_ORACLE_HOME Click Yes
6 On the Summary screen review the installation details and click the Install button to proceed
7 Click Next on the Installation Progress screen when the installation is complete
8 Click Finish on the Complete screen to complete the installation
Do not start Weblogic servers and BI processes at this time
Applying Fusion Middleware Platform Patches for BI Applications 111181
You must apply Fusion Middleware platform patches for BI Applications 111181 The patches are available for download as part of the Oracle Business Intelligence Applications 111181 media pack
The minimum version of Oracle BI EE supported for BI Applications 111181 is BI EE 111170 with Bundle Patch 131017 The patches from Bundle Patch 131017 are included and will be applied to BI EE 111170 If you have already applied BI EE Bundle Patch 131017 or higher to your BI EE environment for BI Applications 111171 then the BI EE patches will not be applied as part of this step
The version of ODI used by BI Applications has not change between BI Applications 111171 and 111181 The version of ODI supported for BI Applications 111181 is 111170 An ODI patch is applied to 111170 as part of this FMW patch application step
To apply platform patches
NOTE You will run a script to apply the patches The script is a Perl script and is available in ltBI_Oracle_HomegtbiappstoolsbinAPPLY_PATCHESpl
The Perl script you will run to apply the patches requires a parameter input file (apply_patches_importtxt) In this procedure before you run the Perl script you will update the parameter input file to reflect the appropriate directory pathss
1 Ensure that the WebLogic Administration Server BI and ODI Managed Servers Node Manager and BI processes are shut down
2 Download Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications and Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications for ltOSgt from the Oracle Business Intelligence Applications 111181 media pack on Oracle Software Delivery Cloud Download all parts
3 Extract all zip files into the same Patch Home directory as follows
Extract the contents of the downloaded zip files containing the patches into the same directory for example Cpatches or PATCH_HOMEpatches
Note The directory structure of the extracted contents is not patches4fadistps6rc3 The patches are contained in folders biappsshiphome odi weblogic and oracle_common You do not have to unzip the individual patches
4 Update the parameter input file (apply_patches_importtxt) to reflect the paths as specified in the text file
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
2 On the machine which hosts the Middleware Home and BI Oracle Home for the BI Applications 111171 environment run the BI Applications 111181 installer
On Windows
setupexe ndashjreLoc ltJDK or JRockit locationgt
On Linux or UNIX
runInstaller -jreLoc ltjdk or jrockit locationgt
The Installer displays the Welcome screen Click Next
3 The Prerequisites Check screen is displayed Click Next
4 The Specify Installation Location screen displays the MW_HOME and BI_ORACLE_HOME for your existing BI Applications 111171 environment Verify the locations and click Next
5 A Warning dialog is received asking if you wish to upgrade the existing BI_ORACLE_HOME Click Yes
6 On the Summary screen review the installation details and click the Install button to proceed
7 Click Next on the Installation Progress screen when the installation is complete
8 Click Finish on the Complete screen to complete the installation
Do not start Weblogic servers and BI processes at this time
Applying Fusion Middleware Platform Patches for BI Applications 111181
You must apply Fusion Middleware platform patches for BI Applications 111181 The patches are available for download as part of the Oracle Business Intelligence Applications 111181 media pack
The minimum version of Oracle BI EE supported for BI Applications 111181 is BI EE 111170 with Bundle Patch 131017 The patches from Bundle Patch 131017 are included and will be applied to BI EE 111170 If you have already applied BI EE Bundle Patch 131017 or higher to your BI EE environment for BI Applications 111171 then the BI EE patches will not be applied as part of this step
The version of ODI used by BI Applications has not change between BI Applications 111171 and 111181 The version of ODI supported for BI Applications 111181 is 111170 An ODI patch is applied to 111170 as part of this FMW patch application step
To apply platform patches
NOTE You will run a script to apply the patches The script is a Perl script and is available in ltBI_Oracle_HomegtbiappstoolsbinAPPLY_PATCHESpl
The Perl script you will run to apply the patches requires a parameter input file (apply_patches_importtxt) In this procedure before you run the Perl script you will update the parameter input file to reflect the appropriate directory pathss
1 Ensure that the WebLogic Administration Server BI and ODI Managed Servers Node Manager and BI processes are shut down
2 Download Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications and Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications for ltOSgt from the Oracle Business Intelligence Applications 111181 media pack on Oracle Software Delivery Cloud Download all parts
3 Extract all zip files into the same Patch Home directory as follows
Extract the contents of the downloaded zip files containing the patches into the same directory for example Cpatches or PATCH_HOMEpatches
Note The directory structure of the extracted contents is not patches4fadistps6rc3 The patches are contained in folders biappsshiphome odi weblogic and oracle_common You do not have to unzip the individual patches
4 Update the parameter input file (apply_patches_importtxt) to reflect the paths as specified in the text file
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Applying Fusion Middleware Platform Patches for BI Applications 111181
You must apply Fusion Middleware platform patches for BI Applications 111181 The patches are available for download as part of the Oracle Business Intelligence Applications 111181 media pack
The minimum version of Oracle BI EE supported for BI Applications 111181 is BI EE 111170 with Bundle Patch 131017 The patches from Bundle Patch 131017 are included and will be applied to BI EE 111170 If you have already applied BI EE Bundle Patch 131017 or higher to your BI EE environment for BI Applications 111171 then the BI EE patches will not be applied as part of this step
The version of ODI used by BI Applications has not change between BI Applications 111171 and 111181 The version of ODI supported for BI Applications 111181 is 111170 An ODI patch is applied to 111170 as part of this FMW patch application step
To apply platform patches
NOTE You will run a script to apply the patches The script is a Perl script and is available in ltBI_Oracle_HomegtbiappstoolsbinAPPLY_PATCHESpl
The Perl script you will run to apply the patches requires a parameter input file (apply_patches_importtxt) In this procedure before you run the Perl script you will update the parameter input file to reflect the appropriate directory pathss
1 Ensure that the WebLogic Administration Server BI and ODI Managed Servers Node Manager and BI processes are shut down
2 Download Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications and Oracle Fusion Middleware Platform Patches for Oracle Business Intelligence Applications for ltOSgt from the Oracle Business Intelligence Applications 111181 media pack on Oracle Software Delivery Cloud Download all parts
3 Extract all zip files into the same Patch Home directory as follows
Extract the contents of the downloaded zip files containing the patches into the same directory for example Cpatches or PATCH_HOMEpatches
Note The directory structure of the extracted contents is not patches4fadistps6rc3 The patches are contained in folders biappsshiphome odi weblogic and oracle_common You do not have to unzip the individual patches
4 Update the parameter input file (apply_patches_importtxt) to reflect the paths as specified in the text file
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
1 Create a writable directory where logs and temporary patch files will be stored In the apply_patches_importtxt file you will set the WORKDIR parameter to point to the path for this directory
2 Open apply_patches_importtxt which is located in the ltBI_Oracle_Homegtbiappstoolsbin directory
3 Specify the following directory paths
Directory Path
JAVA_HOME Path of the JDK Example
INVENTORY_LOC Path of the OracleInventory directory
For example
CProgram FilesOracleInventory
ORACLE_HOME Path of the BI Oracle Home
MW_HOME Path of the Oracle Middleware Home directory
COMMON_ORACLE_HOME Path of the oracle_common directory which is under the Middleware Home directory
WL_HOME Path of the Oracle WebLogic Server Home directory
ODI_HOME Path of the ODI Home directory
WINDOWS_UNZIP_TOOL_EXE If the platform is Windows specify the complete path to the executable file of the unzip tool For example CProgram Files7-Zip7zFMexe
WORKDIR Path of a writable directory where logs and temporary patch files are stored
PATCH_ROOT_DIR Path of the patch directory
For example
Cpatches
Directory Path
or
PATCH_HOMEpatches
5 To apply the patch run the following command from ltBI_Oracle_Homegtperlbin
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
6 Confirm that all patches have been applied successfully by reviewing the following log files in the directory specified by WORDIR
o final_patching_reportlog (summary of patch application)
o biappshiphome_generic_patcheslog
o biappshiphome_ltOS specificgt_patcheslog
o odi_generic_patcheslog
o oracle_common_generic_patcheslog
o weblogic_patchinglog
Do not start the Weblogic servers and BI processes at this time
Upgrading the JAZN file
1 Create a writable directory where logs will be stored For example CJAZN_UPGRADE_WORKDIR or WORKDIR_HOME JAZN_UPGRADE_WORKDIR
2 Perform the JAZN upgrade by running the following command
BI_ORACLE_HOMEjdkbinjava -d64 -cp BI_ORACLE_HOMEbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsJAZNMetadata bioraclehome=ltPath of the BI Oracle Homegt bidomainhome=ltPath of the BI Domain Home directorygt logfile=ltPath of the work directorygtbi_jazn_patchlog workdir=ltPath of the work directorygt
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
The ltprefixgt_BIACOMP schema contains tables for ATG FSM and BIACM (Configuration Manager) The ltprefixgt_BIACOMP schema is upgraded by updating these component schemas to version 111181 individually The ltprefixgt_BIACM_IO schema must also be upgraded to version 111181 Details to upgrade the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas are described in this section
Before performing the upgrades first verify the versions of ATG FSM and BIACM and BIACM_IO by running the following command in the database hosting the ltprefixgt_BIACOMP and ltprefixgt_BIACM_IO schemas
SQLgt select version statuscomp_id from schema_version_registry
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Upgrading ATG FSM and BIACM
The ATG FSM and BIACM component schemas are upgraded using the BI Applications Repository Upgrade Tool which is a command line utility You must upgrade these component schemas in the order described ndash that is ATG first then FSM and finally BIACM
The BI Applications Repository Upgrade Tool (biappsrepositoryutiljar) is located in ltBI_Oracle_Homegtbiappstoolslib
1 Create a writable directory where logs will be stored For example CWorkRepoUtil or WORKDIR_HOME workRepoUtil
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is atgUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Parameter Description
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
Log files will be created for each run and saved in this directory The naming convention for the SQL log file is fsmUpgradeSQLYYYY-MM_DD_HH_MMlog Log files will be available only if they are not empty
dbconnsidurl Connection to the database that hosts the ltprefixgt_BIACOMP schema The format is hostportSID
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
These scripts are located in ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
To upgrade the BIACM_IO schema
1 Connect to ltprefixgt _BIACOMP schema using SQL Plus
Example
sqlplus DEV_BIACOMPpassword
2 Run the upgrade_grant_sysnonym_iosql file with the input of ltprefixgt_BIACM_IO user name The ltprefixgt value is the same as the prefix for your BIACOMP schema
Example
SQLgt ltpath to scriptgtupgrade_grant_sysnonym_iosql DEV_BIACM_IO
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Disconnect from the SQL Plus session once the script completes
3 Connect to ltprefixgt_BIACM_IO schema using SQL Plus or an equivalent tool
Example
sqlplus DEV_BIACM_IOpassword
4 Execute the upgrade_synonym_iosql file with the input ltprefixgt_BIACOMP
Example
SQLgt ltpath to scriptgt upgrade_synonym_iosql DEV_BIACOMP
Where the path to the script is ltBI_Oracle_Homegtbiappsadminprovisioningupdate111181from111171schemaoracleobiacm
Disconnect from the SQL Plus session once the script completes
5 If above two scripts ran successfully then perform the following step
Log in as the System user to the database hosting the ltprefixgtBIACOMP schema using SQL Plus or equivalent tool Execute the command
update schema_version_registry
set version = 111181
upgraded = Y
start_time = sysdate
status = VALID
modified = sysdate
where owner = ltprefixgt_BIACM_IO
NOTE The value of ltprefixgt for the ltprefixgt_BIACM_IO schema is the same prefix as that for the ltprefixgt_BIACOMP schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Using SQL Plus or an equivalent tool log in as ltprefixgt_BIACOMP and execute the following command
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
grant select references on C_PARAMETER_VALUE_FORMATTER_V to ltprefixgt_BIACM_IO
Enabling Deployment Changes to ATG and FSM in the BI Domain
1 Start the Weblogic Administration Server and Node Manager Start the BI processes using Oracle Process Manager and Notification Server (OPMN)
2 Run the PS1_REL8_Upgrade_EnableATGAndFSMChangespy script which is available in the ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
This script removes the TopologyManagerService application and renames the ATG JNDI names
3 Run the PS1_REL8_Upgrade_EnableODIDeployChangespy script which is available under ltBI_ORACLE_HOMEgtdwtoolsscript directory using the Weblogic Scripting Tool (wlst) from the ltBI_ORACLE_HOMEgtcommonbin location as follows
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
The script checks whether High Availability is configured or not If an ODI cluster is configured already then the script starts all the managed servers which were stopped in the previous script execution
If High Availability is not configured then the script deploy the required ODI templates configures an ODI cluster redeploys the oraclediagent using with new deployment plan and starts all the managed servers
4 Start BI and ODI Managed Servers using Weblogic Administration Console
Upgrading the RPD and Presentation Catalog
1 To upgrade the RPD using the Upgrade Metatdata Tool a Take a back-up of the RPD
b Create a writable directory where logs will be stored For example CRPD_Upgrade or WORKDIR_HOME RPD_Upgrade
c Run the following command to upgrade the RPD
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=rpd logfile=ltWork dirgtrpdlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default is INFO Valid values are FINEST FINE NFO WARNING SEVERE
2 To upgrade the Presentation Catalog using the Upgrade Metatdata Tool a Take a back-up of the Presentation Catalog
b Create a writable directory where logs will be stored For example CWebcat_Upgrade or WORKDIR_HOME Webcat_Upgrade
c Run the following command to upgrade the Presentation Catalog
ltBI_Oracle_Homegtjdkjrebinjava -cp ltBI_Oracle_Homegtbiappspatchbiappspatchjar oracleasbiappspatchupdateUpdateBIAppsMetadata bioraclehome=ltBI Oracle Homegt biadminurl=ltBI EM Admin URLgt biadminusername=ltbi EM Admin Usergt biadminpassword=ltBI EM Admin User Passwordgt onlyapply=webcat logfile=ltWork dirgtwebcatlog loglevel=INFO workdir=ltwritable work dir pathgt
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
The biadminpassword is a required parameter but it should not be included on the command line Instead it should be passed to StdIn followed by a line break after the process is started This is so that the password does not appear when the current processes are listed
Optional Parameters
applyupdate ndash Optional parameter Default is true set to false if you want to detect conflicts without doing the actual apply or any orchestration tasksloglevel - default isINFO Valid values are FINEST FINE NFO WARNING SEVEREupgrademode - Used by webcat update system to decide whether to FailOnConflict or Overwrite the content on conflict (default is Overwrite)
3 Restart all BI processes using Oracle Process Manager and Notification Server (OPMN)
Correcting the Directory Name for Code Grants
In the BI Applications 111171 environment the Middleware_Homeuser_projectsdomainsbifoundation_domainserversbi_server1tmp_WL_user folder has a sub folder with name oraclebiacm_111171 Code grants also have the same path
During the upgrade to BI Applications 11181 the code grant changes to a path oraclebiacm_111181 This path doesnrsquot exit The code grant path has to be changed
1 Log in to Enterprise Manager
httphostportem
Example httpBIDomainHost7001em
2 Navigate to Weblogic_Domain -gt bifoundation_domain Right Click and select Security gt System Policies
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
BI EE Bundle Patch 131017 requires the application of the Dynamic Monitoring Service patch 16569379 to your BI system
This patch is available on My Oracle Support gt Patches amp Updates Download the patch for your operating system and apply the Dynamic Monitoring Service patch 16569379 to your BI system following the instructions in the patch readme file
Applying the ODI Patch to ODI Studio
The ODI patch is available in PATCH_ROOT_DIRodigeneric or PATCH_ROOT_DIRodigeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide this patch to developers who have installed ODI Studio on their machines
Follow the instructions in the Patch Readme to apply the patch on all instances of ODI Studio
Note If you installed ODI Studio on the BI Domain host machine you do not have to apply the patch as the patch is applied as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181
Applying Patches to BI Administration Tool
If you have applied the BI EE Bundle Patch 131017 as part of the procedure Applying Fusion Middleware Platform Patches for BI Applications 111181 or if you had applied Bundle Patch 13107 earlier but had not applied the patch to your BI Administration Tool instances then you must patch BI Administration Tool as part of this procedure
NOTE If you have applied a Bundle Patch version higher than 131017 then ensure that BI Administration Tool has been appropriately patched
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
The BI EE Client Installer executable is delivered in patch p17463403_111170_Generic This patch is available in PATCH_ROOT_DIRbiappsshiphomegeneric or PATCH_ROOT_DIRbiappsshiphomegeneric For the location of your PATCH_ROOT_DIR see Section Applying Fusion Middleware Platform Patches for BI Applications 111181 above
System administrators must provide the BI EE Client Installer executable to developers who have installed BI Administration Tool on Windows machines
On Windows machines where BI Administration Tool has been installed
Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Modify an existing instance
Note If BI Clients have not been installed then provide the biee_client_install_x64exe executable file in the patch to developers to install the BI Clients Run biee_client_install_x64exe obtained on unzip of the patch zip file Select Install a new instance
Upgrading the ODI Repository
This section describes the steps to upgrade an existing BI Applications ODI Repository from version 111171 to 111181
In order to retain the existing topology and security configuration in ODI while at the same time minimizing the impact on other tools that interact with ODI (that is BI Applications Configuration Manager and the BI Applications instance of Weblogic Server) the upgrade process has you export the existing or pre-upgrade configurations from the ODI Master Repository drop the existing pre-upgrade ODI Work and Master Repositories import the new upgrade ODI Work and Master Repositories into the same schema then import the pre-upgrade ODI Repository configurations
This effectively replaces all content (interfaces packages models knowledge modules load plans etc) while retaining the configuration definitions
The process also allows you to retain any customizations performed by exporting the customizations from the pre-upgrade repository and importing them back in after the repository has been upgraded
Creating a Back up of the 111171 ODI Repository
Use the Oracle Database Export and Import utility of your choice to export the ODI Repository for BI Applications 111171 from the existing schema and import it into another schema This will allow you to connect to the 111171 ODI repository in case you need to reference it Refer to Appendix gt Creating a Connection in ODI to the 111171 Back-up ODI Repository for information how to create a
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema
Exporting Content from the 111171 ODI Repository
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111171 (Do not connect to the back-up of the ODI Repository)
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Export As part of the procedures described below you will export files to a local directory
Exporting Connections
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 Launch the Smart Export wizard from the Export selection dialog
4 Drag the lsquoGlobalrsquo context into the lsquoObjects to be Exportedrsquo window Provide a meaningful name for the export file Click Export This will export the logical and physical topology including assigned Datasource Num ID values and database connect details
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Exporting Security
1 Navigate to Topology gt Export and select the lsquoExport Security Settingsrsquo action
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
2 Choose to export to a local file (directory) This action exports your user configurations
Exporting Customizations
If you have introduced any customizations in your ODI repository you will need to export these as well The BI Apps Customization methodology has you place all custom interfaces in separate lsquoCustomrsquo adaptor folders You will export these folders using the ODI Smart Export option This option exports the object itself and any used objects that the exported object depends on Note any non-custom objects that may be included in the export as these will need to be merged with the code in the upgrade repository
1 Navigate to the Designer tab From the Connect Navigator (Designer icon dropdown on the top right side of the navigator pane) select Export
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
2 Select Smart Export from the Export selection dialog
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 Export your custom folders
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Noting the ID of the 111171 ODI Repository
ODI requires the ID of the repository you import objects into be different from the ID of the repository that objects were exported from The ID of the 111171 ODI Repository will need to be noted and after the repository is replaced with the 111181 repository the repository ID will be updated to a non-conflicting number
The default value 500 is assigned to all repositories that are shipped by Oracle If you have migrated the repository across environments the value could be different from this default value
To note the ID of the ODI Repository for BI Applications 111171
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
1 Navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoOpenrsquo -gt Version -gt Information -gt Internal ID
2 Note the ID
3 Do the same for the Work Repository The Repository ID should have the same value
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Dropping the 111171 ODI Repository Schema
Use the BI Applications RCU to drop the existing 111171 ODI Repository schema You can use either the BI Applications 111171 RCU or the 111181 RCU You will be prompted with a list of schemas that have already been installed ndash select the schema where the ODI Repository for 111171 exists
Important ndash ONLY drop the ltprefixgt_BIA_ODIREPO Do not drop any other schema
1 Launch the BI Applications RCU Select the Drop radio button
2 In the Database Connection Details screen provide the connection details to the database which hosts the ODI Repository for BI Applications 111171
3 From the Prefix All Schema Owners dropdown select the prefix for your BI Applications 111171 schemas
4 Select only the Oracle Data Integration Master and Work Repository from the Select Components screen Do NOT select any of the other schema components
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
5 Click Drop to drop the ODI Repository schema for 111171
The following steps are the same as when installing a refresh ODI repository The only difference is that we select the option to restore the ODI Master and Work repositories only
Creating the ODI Repository for BI Applications 111181
You must run the BI Applications 111181RCU to create the schema for the ODI Repository for 111181 This schema will use the same name as the 111171 ODI Repository schema that was just dropped
Important ndash You must select the option to use an existing prefix and re-use the same prefix that was used by the schema that was previously dropped
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
1 Unzip the BI Applications 111181 RCU downloaded from the BI Applications 111181 media pack
2 If you are not running RCU on the database host machine then you must copy the obia_odidmp file to a directory with global write access on the appropriate database server machine (RCU writes log files to this directory) The dmp file is located in BIA_RCU_HOMErcuintegrationbiappsschema
3 Launch the BI Applications RCU for 111181 from BIAPPS_RCU_HOMEbin
UNIX rcuWindows rcubat
4 Select the Create radio button
5 In the Database Connection Details screen provide the connection details to the database which previously hosted the ODI Repository for BI Applications 111171 which you dropped in the previous procedure
6 In the Select Components screen from the Select an existing Prefix dropdown select the same prefix as that of your ODI Repository for 111171 If you do not see the prefix as an existing prefix then choose the Create a new Prefix radio button and enter the same prefix as you had used before for the ODI Repository for 111171
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
7 Select the Oracle Data Integration Master and Work Repository Do not select any other component
8 In the Value field in the Custom Variables screen for the ltprefixgt_BIA_ODIREPO schema enter the directory path of the folder on the database server that contains the obia_odidmp file See step 1 above
Note Do not include the name of the dmp file in the directory path
9 Complete the ODI Repository creation
Connecting to the ODI Repository for 111181
Create a connection in ODI Studio to the ODI Repository for 111181 which you created in the previous step The repository is set to Internal Authentication The user and password you use to connect to the repository
User SUPERVISORPassword welcome
Changing the ID of the 111181 ODI Repository
The ID of the repository has to be changed from the default to avoid conflicts when importing the configurations objects and customizations from the ODI Repository for 111171 In the section ldquoNoting the ID of the 111171 ODI Repositoryrdquo above you made a note of the Repository ID for the
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Master and Work repositories (default value is 500) In this procedure you will update the value in the ODI Repository for 111181to a different value
1 In ODI Studio navigate to Topology -gt Repositories -gt Master Repository -gt Right Click and select lsquoRenumberrsquo
2 On the Renumbering the repository ndash Step 1 dialog click Yes
3 On the Renumbering the repository ndash Step 2 dialog enter a new ID that has not been used for any of your existing ODI Repositories Oracle suggests incrementing the value you noted in section ldquoNoting the ID of the 111171 ODI Repositoryrdquo by 1 Click OK
Note that this incremented value should not be same number as the Repository ID of any existing ODI Repository The value you enter must be a numeric ID between 501 and 899
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
4 Verify the new number by selecting the Master Repository Right click and select Open to view the Internal Id value that was set in the previous step
5 Repeat for steps 1-4 to renumber the Work repository to the same value as the renumbered Master repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Importing Content into the 111181 ODI Repository
Importing Connection Details
1 Launch the ODI Studio client and connect to the ODI repository for BI Applications 111181
2 Navigate to the Topology tab From the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import As part of the procedures described below you will import the file created by exporting the rsquoGlobalrsquo context in step Exporting Connections above
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 In the Import Selection dialog select Smart Import
4 In the File Selection screen specify the export file created in step Exporting Connections above
5 The default behavior of Smart Import is to Merge details in the target repository Ensure that no issues are reported ndash if issues are reported resolve them to ensure the existing details are replaced by the details being imported Select the BIAPPS_DW and BIAPPS_BIACOMP Data Servers and select the lsquoOverwritersquo option and continue
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Verifying the Imported Details
As part of this procedure you will verify that the Physical Servers have the correct details and the Physical Schemas have the correct Datasource Num ID value set in the DATASOURCE_NUM_ID flexfield
1 In ODI Studio navigate to Topology gt Physical Architecture Open the BIAPPS_DW physical server
2 Verify the User and Password are correctly populated under the Definition tab
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 On the JDBC tab verify that the JDBC URL is correctly set If you used the default lsquoMergersquo action during the Smart Import the User and Password will be updated but the JDBC URL will remain unchanged
4 Repeat steps 1-4 for the BIAPPS_BIACOMP physical server
5 Verify the source connection destails For example if you need to extract from an instance of eBusiness Suite 11510 open the corresponding physical server (here named EBS11510_DEFAULT) and verify the UserPassword and JDBC
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
6 Also verify the associated physical schema Navigate to the Flexfields tab and verify the DATASOURCE_NUM_ID flexfield is set to the value you originally assigned This value of the DATASOURCE_NUM_ID must match the value in BI Applications Configuration Manager for this source connection
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
7 Open the corresponding logical schema and verify the DATASOURCE_NUM_ID flexfield is also set with the same value
Importing Security
As part of this procedure you will import the Security settings that you exported in step Exporting Security above The import of Security settings is done using the InsertUpdate option
1 In the Topology tab from the Connect Navigator (Topology icon dropdown on the top right side of the navigator pane) select Import
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
2 In the Import Selection dialog select Import Security Settings
3 In the Import Security Settings dialog select Synonym Mode INSERT_UPDATE for the Import Mode Select the Import from a Folder radio button Enter the directory location to which you had exported the Security settings in step Exporting Security above
4 Click Yes in the Confirmation dialog
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
After the import is complete the SUPERVISOR user will no longer be enabled
Once logged out of ODI Studio you will have to log in with the administrative user configured in the prior ODI repository In order to do so the ODI Repository for BI Applications 111181 has to be configured for External Authentication as described below
Reconfiguring External Authentication
1 Disconnect from the ODI Repository by selecting the ODI menu and then the Disconnect ldquoltUsergtrdquo menu item
2 From the ODI menu select the Switch Authentication Mode menu item
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 Enter the database connection details on the Login screen Click Next4 On the Credentials screen click Finish
The following Information dialog is displayed to indicate that the repository was successfully switched to External Authentication You should see at least two users are matched Note that the SUPERVISOR user defined in ODI will not be matched to anything in the security store
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
You can now connect to ODI using externally authenticated users for example the BI Applications Administrator User
If you receive the following error when switching to External Authentication then you have not configured the security files required for external authentication on the instance of ODI Studio you are using
To configure user access see section 3392 Configuring User Access for ODI Studio in the BI Applications Installation Guide for 111181
5 If required create a connection in ODI Studio to the ODI Repository for 11118 The repository is set to External Authentication The credentials you use to connect to the repository are those of the BI Applications Administrator user
Importing Customizations
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
The ODI Smart Import will be leveraged to import the customizations which were exported from the ODI Repository for 111171 as part of step Exporting Customizations above into the ODI Repository for 111181
The types of customization that can be imported are as follows
Changes to an Interface that has been copied into a separate Custom Adaptor folder per the Customization methodology with the following limitations
o Interfaces where neither the datastore extracted from or populated have been customized may be imported
o Interfaces that extract from or populate customized datastores where the datastore has NOT changed in the post-upgrade repository may be imported
o Interfaces that extract from or populate customized datastores where the datastore has changed in the post-upgrade repository may not be imported as the custom datastore cannot be imported
Changes to a Package that that has been copied into a separate Custom Adaptor folder per the Customization methodology
Changes to the Custom Fact and Dimension Load Plan Components Changes to a Datastore where the Datastore has NOT changed in the post-upgrade repository
(due to limitations with 3-way merge) Interfaces that extract from andor populate these datastores may be imported
The following types of customizations cannot be imported and must be manually reapplied in the post-upgrade repository
Customized datastore where the datastore has changed in the post-upgrade repository For example the original pre-upgrade datastore has 10 columns an 11th column was introduced as a customization and an 11th column was introduced in the post-upgrade datastore
Interfaces that extract from or populate such a customized datastore cannot be imported
If you have custom content that was exported as part of step Exporting Customizations above then this content needs to be imported in the ODI Repository for 111181
As per the customization methodology the Oracle BI Applications model folder is initially versioned to reflect the pre-customized model and versioned again for the customizations With these two versions it is possible to compare the two to see what changes have been introduced
To import the customizations
1 Launch the ODI Studio client and connect to the ODI Repository for BI Applications 111181
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
2 Navigate to Designer -gt Models -gt Oracle BI Applications (folder) -gt Oracle BI Applications (Model)
3 Right click select Version -gt Create Version Create an initial version Perform the steps again to create the version with customizations
4 Perform a Smart Import of the file you created previously in step Exporting Customizations above Resolve any conflicts Note that ODIrsquos default behavior is to perform an Overwrite operation so the custom content being imported will overwrite the upgrade content Select the appropriate options to ensure upgrade content is retained
Validating Connections
After completing the import of connections security and customizations into the ODI Repository for the Physical schema for BIACOMP and DW are set as defaults If they are not set as defaults Load Plans will fail
1 In ODI Studio navigate to Topology gt Physical Architecture
2 Open the physical schema under the BIAPPS_BIACOMP physical server
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 Verify that the Default check box is checked on the Definition tab
4 Check the Default check box if it is not checked Save changes
5 Repeat steps 2 to 4 for the physical schema under the BIAPPS_DW physical server
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Regenerating Load Plans
Load Plans that were originally generated in the ODI Repository for 111171 do not exist in the ODI Repository for 111181 The steps to transfer content from the 111171 Repository to the 111181 Repository do not include transferring the original load plans The load plans will not reflect any changes introduced as part of the upgrade so a new load plan must be generated
Configuration Manager retains the Load Plan definitions on upgrade even though any metadata associated with this load plan that was stored in ODI is no longer available Use these existing definitions in Configuration Manager to regenerate load plans including Domains Only Load Plans Note that any tasks that had previously executed pre-upgrade will execute in incremental mode post-upgrade while any new tasks that may be introduced in the generated load plan will initially execute in full mode
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user2 Navigate to Manage Load Plans3 Regenerate all Load Plans including the Domains-Only Load Plans
Refer to the Configuration Manager online help for the Manage Load Plans screen and the BI Applications ETL Guide for 111181 for more details on how to regenerate the load plan with the existing load plan definition
Part II - Business Analytics Warehouse Schema and Data Upgrades
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
This section outlines the steps to perform a warehouse schema and data upgrade from 111171 to 111181 Before performing the steps outlined in this section of the document you must have completed all steps described in section Before starting the Upgrade process from BI Applications 111171 to 111181 you must have executed at least one incremental run in addition to a full data load in your BI Applications 111171 environment
The upgrade of the Business Analytics Warehouse schema and data upgrade are achieved by executing predefined Upgrade Load Plans in ODI Studio You need to select the appropriate Load Plan based on the source version deployed
NOTE The Upgrade Load Plans can only be executed from ODI Studio
Granting New Required Privileges to ltprefixgt_DW
BI Applications 111181 requires that the ltprefixgt _DW schemauser be granted the CREATE JOB privilege
Work with your Database Administrator to grant the CREATE JOB privilege to the ltprefixgt _DW schemauser
This privilege must be granted before you can execute the Upgrade Load Plans described later in this section
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Identifying the Upgrade Load Plans to Execute
You will run an Upgrade Load Plan for each source you have registered in your BI Applications You must first identify which Upgrade Load Plans you need to execute
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans determine and note which Upgrade Load Plans you will run based on the transactional systems from which you are sourcing data into BI Applications
You will later run an Upgrade Load Plan for each source registered in your BI Applications
Modifying the Upgrade Load Plans
As part of this procedure you will modify the Upgrade Load Plans which you have identified in section Identifying the Upgrade Load Plans to Execute above
In preparation for executing the Upgrade Load Plans you must
1 In ODI Studio gt Designer tab gt Load Plans and Scenarios gt Predefined Load Plans gt Upgrade select an Upgrade Load Plan which you will be executing Double-click the Load Plan to open for editing
2 Navigate to the Steps tab and select the highest level node (example EBS_1150 as shown in the screenshot) Open the Property Inspector which displays in the lower pane
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
3 In the Properties Inspector select the variable named BIAPPSDATASOURCE_NUM_ID Uncheck the Overwrite option for this variable
4 If you are modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then perform the action documented in this step If you are not modifying the BIApps 111171 to 111180 EBS 11510 Load Plan then move to step 5 below
On the Upgrade BIApps 111171 to 111180 EBS 11510 Load Plan gt Steps tab
a Navigate to the Upgrade_DW step Expand this nodeb Expand the Upgrade_DW_Copy nodec Select the GENERATE_UPGRADE_DDL_COPY_TABLES scenario under the
Upgrade_DW_Copy noded Open the Property Inspector if not open e Navigate to the Scenario Variables panef For the variable BIAPPSUTIL_GENDDL_SCRIPT_LOCATION uncheck the checkbox for the
Overwrite column
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
5 If you are modifying any of the following Upgrade Load Plans then perform the actions documented in this step If you are not modifying any of these Load Plans then move to step 6 below
Upgrade BIApps 111171 to 111180 EBS 11510 Upgrade BIApps 111171 to 111180 EBS 120 Upgrade BIApps 111171 to 111180 EBS 1211 Upgrade BIApps 111171 to 111180 EBS 1212 Upgrade BIApps 111171 to 111180 EBS 1213
On the Upgrade Load Plan (noted above) gt Steps tab
a Navigate to the UPGRADE_DIMENSIONS step Expand this nodeb Select the lsquoIs PROJECTS enabledrsquo case statement Check the check box in the Enabled
column
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
6 Save all changes made to the Upgrade Load Plan being modified
7 Repeat steps 1 through 10 for each Upgrade Load Plan you will execute
Upgrading the Business Analytics Warehouse Schema
In this procedure you will make a copy of each Upgrade Load Plan you will run based on the transactional systems from which you are sourcing data into BI Applications The copied Load Plans will then be modified to include only the step that upgrades the Business Analytics Warehouse schema You will run a copied and modified Upgrade Load Plan for each source registered in your BI Applications
To upgrade the Business Analytics Warehouse schema
1 In ODI Studio select an Upgrade Load Plan you modified in section above
2 Right-click and select Duplicate Selection
3 In the Confirmation dialog click Yes
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
4 A copy of the Upgrade Load Plan is created with prefix ldquoCopy ofrdquo added to the name of the original Upgrade Load Plan
5 Select the copied Upgrade Load Plan and double-click to open for editing
6 Navigate to the Steps tab and disable all steps below the Upgrade_DW step by unchecking the check box in the Enabled column
7 Save the changes made to the copied Load Plan
8 Execute the copied Load Plan
9 Repeat steps 1 through 8 for each Upgrade Load Plan you modified in section above
Running Domains-Only Load Plan(s)
Before you run the Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse you must first execute the Domains-Only Load Plans This loads any new source domains into Configuration Manager
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the Tasks pane of Oracle BI Applications Configuration Manager select Manage Load Plans which appears under the Load Plans Administration heading
3 The Manage Load Plans page displays the list of generated Load Plans including the Domains-Only Load Plans
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
NOTE If you have not regenerated the Load Plans as described in section Regenerating Load Plans above then you must do so before you can execute the Domains-Only Load Plans
4 Execute the Domains-Only Load Plans If you have more than one Domain-Only Load Plan then you must execute all of them
Performing Domain Member Mappings
Perform domain member mappings for any new conformed domains that have been introduced in BI Applications Configuration Manager See the BI Applications Configuration Guide for 111181
Also map externally conformed domains as described in section 47 Mapping Externally Conformed Domains of the BI Applications Installation Guide
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
In this step you execute SQL statements (DML and DDL) in order to synchronize the Business Analytics Warehouse
Execute the SQL statements listed below against the Business Analytics Warehouse (ltprefix_DW) These statements must be executed before you run the Upgrade Load Plans to upgrade the data in warehouse
execute the following SQL statements prior to executing the upgrade load plan
ALTER TABLE W_APPL_EVENT_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
ALTER TABLE W_APPL_ACC_SNP_F MODIFY HIRING_MGR_HR_ASSG_WID NUMBER(10) NULL
create table c0w_hr_person_leg_d
as select from w_hr_person_leg_d
update w_hr_person_leg_d
set integration_id = integration_id || ~ || legislation_code
where integration_id ltgt 0
and exists
(select 1 from w_ora_wevt_asg_ps x
where xdatasource_num_id = w_hr_person_leg_ddatasource_num_id)
commit
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Run before upgrade or when error is encountered upgrading W_WRKFC_SNP_F
CREATE TABLE W0WRKFC_SNP_F AS SELECT FROM W_WRKFC_SNP_F
TRUNCATE TABLE W_WRKFC_SNP_F
ALTER TABLE W_FLEX_COLUMN_G ADD (COLUMN_CONTEXT_CASE VARCHAR2(4000 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (ATTRIBUTE_CATEGORY VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (COMPONENT_VALUE VARCHAR2(30 CHAR))
ALTER TABLE W_FLEX_COLUMN_G ADD (DISPLAY_SEQUENCE NUMBER(10))
delete from w_domain_member_map_g
where trg_domain_code = W_UOM and src_domain_member_code IN (Miles HOURS)
commit
DELETE FROM W_QA_RESULTS_F
WHERE CHAR_WID =0
COMMIT
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
When executing the Upgrade Load Plan in a later step you will need to provide the Data Source Number for the source During the set up of BI Applications 111171 you provided a Data Source Number for each registered source in BI Applications Configuration Manager As part of this step you will identify the Data Source Number for each source
1 Log into BI Applications Configuration Manager as the BI Applications Administrator user
2 In the navigation pane select the Define Business Intelligence Applications Instance link
3 In the Source Systems tab in the Source Systems table for each enabled registered source note the Data Source Number
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
You must perform the tasks described in this section if you have deployed Supply Chain and Order Management Analytics If you have not deployed Supply Chain and Order Management Analytics then
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Skip to section Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) below if are sourcing data from PeopleSoft version 90 91 or 92
Skip to section below if you are not sourcing data from PeopleSoft version 90 91 or 92
If you have deployed Supply chain and Order Management Analytics in BI Applications 111171 and have enabled the Customer Status History Fact Group (OM_CUSTSTATHISTFG) then you must update the certain ETL parameters prior to executing the Upgrade Load Plans to upgrade data in the warehouse
To update the ETL parameters
1 In ODI Studio open the Upgrade Load Plan
2 Navigate to the UPGRADE_FACTS step Expand this node
3 Navigate to Is ORDER MANAGEMENT enabled gt When Value = Y gt ORDER MANGEMENT gt OM_SERIAL gt OMCUSTSTATIST_FG
4 Open the Property Inspector
You will update the following variables as described in the next steps
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
5 The value of the CURRENT_DATE variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT TO_CHAR(CALENDAR_DATE YYYY-MM-DD HHMMSS) FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE variable to the value returned by the above query
6 The value of the CURRENT_DATE_WID variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_DW schema
SELECT ROW_WID FROM W_DAY_D WHERE W_CURRENT_CAL_DAY_CODE=Current
b In ODI Studio update the value of the BIAPPSCURRENT_DATE_WID variable to the value returned by the above query
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
7 The value of the PERIOD variable depends on the last incremental run To obtain the value that this variable should be set to and to update the variable
a Run the following query against the ltprefixgt_BIACOMP schema
SELECT PARAM_VALUE FROM C_PARAMETER_VALUE_FORMATTER_V WHEREPARAM_CODE = PERIOD AND GROUP_CODE = OMCUSTSTATHIST_FG AND DATASOURCE_NUM_ID=999
b In ODI Studio update the value of the BIAPPSPERIOD variable to the value for PARAM_VALUE returned by the above query
8 Save the changes to the Upgrade Load Plan
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
You must perform the tasks described in this section if you are sourcing data from PeopleSoft version 90 91 or 92 If you are not sourcing data from PeopleSoft version 90 91 or 92 then skip to section below
If you are sourcing data from PeopleSoft version 90 91 or 92 then you must complete the tasks described in this section
When upgrading BI Applications sourcing from PSFT 90 91 92 the W_INT_ORG_D dimension requires a special set of parameters to be passed while starting the Upgrade Load Plans These parameters will take values depending on your configuration
Determine the values for these parameters by running queries against the BI Applications Components schema (ltprefixgt_BIACOMP) as described below The query to obtain the values for these parameters is of the format
select from C_PARAMETER_VALUE_FORMATTER_V where param_code = ltVariable name from the above listgt and group_code = INTORG_DIM
1 For each variable noted column A in the table below run the SQL Query noted in column B against the ltprefixgt_BIACOMP schema
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
2 In the query results select the value for the row with the correct DATASOURCE_NUM_ID value The DATASOURCE_NUM_ID should match DSN value you identified for your PeopleSoft source in step Identifying Data Source Number for a Registered Source above
3 Note the value Column C shows the format of the value
A
Variable
B
SQL Query (against ltprefixgt_BIACOMP and for the DATASOURCE_NUM_ID for
the source)
C
Value (returned from query run in your environment
TREE_CURRENT_VERSION_ONLY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_CURRENT_VERSION_ONLY and group_code = INTORG_DIM
(Value is Y or N without quotes)
TREE_SETID_NAME_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_DEPT and group_code = INTORG_DIM
(Value should of the format A~A1B~B1 )
TREE_STRUCT_ID_LIST_DEPT select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_DEPT and group_code = INTORG_DIM
(Value should be of the format AB format)
TREE_SETID_NAME_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_SETID_NAME_LIST_COMPANY and group_code = INTORG_DIM
(Value should be like A~A1B~B1 format)
TREE_STRUCT_ID_LIST_COMPANY select from C_PARAMETER_VALUE_FORMATTER_V where param_code = TREE_STRUCT_ID_LIST_COMPANYrsquo and group_code = INTORG_DIM
(Value should be like AB format)
The screen shot below shows the result from the ltprefixgt_BIACOMP for the lsquoTREE_SETID_NAME_LIST_DEPT variable
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
As part of this procedure you will execute Upgrade Load Plans to upgrade the data in the Business Analytics Warehouse
You will execute the Upgrade Load Plans based on the transactional systems and versions that are sources of data for your BI Applications You identified the Upgrade Load Plans you need to run in section Identifying the Upgrade Load Plans to Execute above
To execute the Upgrade Load Plans
1 Log into ODI Studio using the connection for the BI Applications Administrator user
2 Navigate to Designer tab gt Load Plans and Scenarios
3 Expand the Predefined Load Plans folder and then the Upgrade folder
4 From the list of Upgrade Load Plans select the Upgrade Load Plan which you will run
NOTE You must have completed the modifications described in section Modifying the Upgrade Load Plans above to the Upgrade Load Plan you will execute
5 Double-click the selected Load Plan to open
6 Click on the Execute icon
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
When the execute button is clicked a Start Load Plan dialog window appears You will provide Start Up Values for variables in this dialog
7 Enter the value for the BIAPPSDATASOURCE_NUM_ID variable This value is the Data Source Number that you identified for the source in section Identifying Data Source Number for a Registered Source above
Note that it is critical to provide the correct DATASOURCE_NUM_ID (DSN) which matches the value for DSN entered in Configuration Manager for this source This DSN is a composite key used to update the Warehouse tables
8 If you are running an Upgrade Load Plan for PeopleSoft source version 90 91 or 92 then additionally enter the values for the following variables
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
The values for these variables were identified in step Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92) above
9 Click OK to start the execution
The relevant steps in the Upgrade Load Plan are executed based on the BI Applications Offerings that are enabled in Configuration Manager
10 When the Load Plan completes execution repeat steps 4 to 9 for each additional Upgrade Load Plan you had identified to execute
Post-Upgrade Tasks
After you have completed execution of the Upgrade Load Plan(s) you need to execute a set of SQL statements For the SQL Statements that need to be run see Appendix gt Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct
WHERE TARGET_TABLE_NAME IN (W_PROJ_COST_AW_PROJ_COST_LINE_TMPW_PROJ_COST_A_TMP)
COMMIT
UPDATE W_ETL_LOAD_DATES
SET COMMITTED = 0
WHERE PACKAGE_NAME LIKE SDE_ORA_DOMAINGENERAL_PROJECTSTATUS
OR PACKAGE_NAME LIKE SDE_ORA_STATUSDIMENSION_PROJECTSTATUS
COMMIT
Contents
Overview
Pre-requisites
Part 1 - BI Applications Infrastructure Metadata and Schema Upgrades
Downloading BI Applications 111181 software and files
Upgrading the BI Applications binaries to version 111181
Applying Fusion Middleware Platform Patches for BI Applications 111181
Upgrading the JAZN file
Upgrading BIACOMP and BIACM_IO schemas
Upgrading ATG FSM and BIACM
Upgrading the BIACM_IO Schema
Granting Privileges to ltprefixgt_BIACM_IO schema
Enabling Deployment Changes to ATG and FSM in the BI Domain
Upgrading the RPD and Presentation Catalog
Correcting the Directory Name for Code Grants
Applying Additional Patches
Applying the Dynamic Monitoring Service Patch
Applying the ODI Patch to ODI Studio
Applying Patches to BI Administration Tool
Upgrading the ODI Repository
Creating a Back up of the 111171 ODI Repository
Exporting Content from the 111171 ODI Repository
Exporting Connections
Exporting Security
Exporting Customizations
Noting the ID of the 111171 ODI Repository
Dropping the 111171 ODI Repository Schema
Creating the ODI Repository for BI Applications 111181
Connecting to the ODI Repository for 111181
Changing the ID of the 111181 ODI Repository
Importing Content into the 111181 ODI Repository
Importing Connection Details
Verifying the Imported Details
Importing Security
Reconfiguring External Authentication
Importing Customizations
Validating Connections
Regenerating Load Plans
Part II - Business Analytics Warehouse Schema and Data Upgrades
Granting New Required Privileges to ltprefixgt_DW
Identifying the Upgrade Load Plans to Execute
Modifying the Upgrade Load Plans
Upgrading the Business Analytics Warehouse Schema
Running Domains-Only Load Plan(s)
Performing Domain Member Mappings
Upgrading Data in the Business Analytics Warehouse (Data Migration)
Synchronizing the Data Model
Performing Pre-Upgrade Tasks
Identifying Data Source Number for a Registered Source
Updating ETL Parameters (Required for Supply Chain and Order Management Analytics for EBS and JDE sources)
Noting Variable Value (Required if your source is PeopleSoft versions 90 91 or 92)
Executing Upgrade Load Plan(s) to upgrade data in the Business Analytics Warehouse
Post-Upgrade Tasks
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
Post-Upgrade SQL Statements
Appendix
Creating a Connection in ODI to the 111171 Back-up ODI Repository
This section describes how to create a new connection in ODI Studio to the back-up of the ODI Repository for 111171 which is now in a new database schema See section Creating a Back up of the 111171 ODI Repository above for reference
To create a new connection in ODI Studio to the back-up of the ODI Repository for 111171
Configure the connection to use the same ODI user you used before Configure the connection as a Master Repository connection Connect to the repository and navigate to Topology -gt Repositories -gt BIAPPS_WORKREP Edit the repository to change the database user details used by the Work Repository to use the new schema
Disconnect from the repository reconfigure the connection to include the Work Repository connect and verify all details are correct