Upgrade Steps Guide

4/15/2020 Document Display
Copyright (c) 2020, Oracle. All rights reserved. Oracle Confidential.
OBIEE 12c|OAS: Quick Reference For Oracle Business Intelligence Enterprise 12c Upgrade From
12.2.1 to 12.2.1.x (Doc ID 2153433.1)
In this Document
Purpose
Scope
Details
Disabling Internal SSL
Installing Fusion Middleware Infrastructure Release 12.2.1.1
Installing Oracle Business Intelligence Release 12.2.1.1
Running the Readiness Check
Upgrading Schemas with the Upgrade Assistant
Backing up the mapViewerConfig.xml File
Reconfiguring the BI Domain with the Reconfiguration Wizard
Restoring the mapViewerConfig.xml File
Upgrading the Configuration with the Upgrade Assistant
Apply Patch 26887297 to Avoid Issue When Enabling Internal SSL
Enabling Internal SSL
Testing the Upgrade
Alternative 'Out of Place' Upgrade
References
APPLIES TO:
Business Intelligence Suite Enterprise Edition - Version 12.2.1.0.0 and later

Oracle Analytics Server - Version 5.5.0 and later
Information in this document applies to any platform.
PURPOSE
This document is intended to supplement (with screen shots), act as a bridge and be used as a quick searchable reference to
the Oracle® Fusion Middleware Upgrading Oracle Business Intelligence documentation. It does not supersede the
documentation.
This document is a reference to quickly upgrade a test, development or demonstration environment. See the Enterprise
Deployment Guide for Oracle Business Intelligence for a reference production architecture.
This document was written and tested by upgrading OBIEE 12.2.1.0 to 12.2.1.1. At that time, OBIEE 12.2.1.2 and later had
not been released yet; however, the same steps apply for the upgrade from 12.1.1.0 to 12.2.1.x.
Once your upgrade is complete, you may want to review OBIEE 12c: Quick Reference For Architecture, Lifecycle Managment
and File Locations (Doc ID 2067527.1)
This knowledge article applies to both OBIEE and Oracle Analytics Server (OAS) which is Oracle's latest on-premise Analytics
offering.
https://support.oracle.com/epmos/faces/SearchDocDisplay?_adf.ctrl-state=7gveru7ul_4 1/67
SCOPE
This document can be useful for anyone preparing an upgrade of Oracle Business Intelligence Enterprise Edition 12c including
administrators, consultants, sales, partners, deployment engineers, architects, support.
DETAILS
You must read and understand the important information in Preparing to Upgrade Oracle Business Intelligence before you
begin the upgrade process. It identifies important tasks and checks to be performed to ensure that your environment is
properly prepared for upgrading the Oracle Business Intelligence:
Oracle Fusion Middleware Pre-Upgrade Checklist

Creating a Complete Backup
Cloning Your Production Environment for Testing
Verifying Certification and System Requirements
Updating Policy Files when Using Enhanced Encryption (AES 256)
Purging Unused Data
Creating a Non-SYSDBA User to Run Upgrade Assistant
Creating a Baseline Report with the Oracle BI Baseline Validation Tool
Example Linux upgrade (assumes OBIEE 12c is previously installed and configured)
Copy installation files or create a mount point for your installation files.
Ensure you have method for graphical user interface (e.g. VNC or local xterm)
JDK: configure JDK in your PATH and JAVA_HOME
For example:
export JAVA_HOME=/[path to your jdk]/jdk8

export PATH=/[path to your jdk]/jdk8/bin:$PATH
which java
/../jdk8/bin/java
java -version
java version "1.8.0_92"
Java(TM) SE Runtime Environment (build 1.8.0_92-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.92-b14, mixed mode)
The best practice for all future installations is to have the DOMAIN_HOME outside of the ORACLE_HOME. This makes clean-
up|deletion of the old ORACLE_HOME much easier after the upgrade process is complete and validated.
Note: The example in this document shows the Oracle home and the domain home together as the purpose is to
demonstrate the upgrade process in a test environment.
You must disable SSL on the internal communication links before you start the upgrade process.
../Oracle_Home/user_projects/domains/bi/bitools/bin/stop.sh
../Oracle_Home/user_projects/domains/bi/bitools/bin/ssl.sh internalssl false
Logging to: ../Oracle_Home/user_projects/domains/bi/bilogs/sslcommand.log

Reading domain
Setting protocol to http for server bi_server1
Internal BIEE communications have been configured to not use SSL.
Sensitive information will be transmitted in the clear.
Startup all BIEE servers to consume the new configuraton. For example run the start[.sh]
command line tool in the same directory as this ssl tool.
./start.sh
Installing Fusion Middleware Infrastructure Release 12.2.1.1
[path to jdk8/bin]/java -jar fmw_12.2.1.1.0_infrastructure.jar
After installing Fusion Middleware Infrastructure Release 12.2.1.1 the following directories are created under
../Oracle_Home_12.2.1.1:
drwxr-x--- 4 oracle oracle 4096 Jun 23 17:15 cfgtoollogs

drwxr-x--- 5 oracle oracle 4096 Jun 23 17:13 coherence
drwxr-x--- 8 oracle oracle 4096 Jun 23 17:14 em
drwxr-x--- 2 oracle oracle 4096 Jun 23 17:15 install
drwxr-x--- 19 oracle oracle 4096 Jun 23 17:16 inventory
drwxr-x--- 12 oracle oracle 4096 Jun 23 17:14 OPatch
drwxr-x--- 23 oracle oracle 4096 Jun 23 17:14 oracle_common
-rw-r----- 1 oracle oracle 130 Jun 23 17:15 oraInst.loc
drwxr-x--- 8 oracle oracle 4096 Jun 23 17:15 oui
drwxr-x--- 7 oracle oracle 4096 Jun 23 17:13 wlserver
Installing Oracle Business Intelligence Release 12.2.1.1
cd /[path to your software download]

unzip fmw_12.2.1.1.0_bi_linux64_Disk1_1of2.zip
unzip fmw_12.2.1.1.0_bi_linux64_Disk1_2of2.zip
./bi_platform-12.2.1.1.0_linux64.bin
Running the Readiness Check
The instance must be running to run the Readiness Check as the Upgrade Assistant connects to the domain:
../Oracle_Home_12.2.1.1/oracle_common/upgrade/bin/ua -readiness
Examine the readiness report and take action as needed. The report is available under:
../Oracle_Home_12.2.1.1/oracle_common/upgrade/logs
Here is a sample Readiness Report file
Upgrading Schemas with the Upgrade Assistant
Stop the instance and run the Upgrade Assistance:
../Oracle_Home/user_projects/domains/bi/bitools/bin/stop.sh | .cmd
../Oracle_Home_12.2.1.1/oracle_common/upgrade/bin/ua
Backing up the mapViewerConfig.xml File
The mapViewerConfig.xml file is overwritten by the reconfiguration templates when you run the Reconfiguration Wizard.
Therefore, you must back up the mapViewerConfig.xml file before reconfiguring your 12.2.1.0 domain.
cd ../Oracle_Home/user_projects/domains/bi/config/fmwconfig/mapviewer/conf
cp mapViewerConfig.xml mapViewerConfig.xml.orig
Reconfiguring the BI Domain with the Reconfiguration Wizard
../Oracle_Home_12.2.1.1/oracle_common/common/bin/reconfig.sh
Restoring the mapViewerConfig.xml File
cd ../Oracle_Home/user_projects/domains/bi/config/fmwconfig/mapviewer/conf
cp mapViewerConfig.xml.orig mapViewerConfig.xml
Upgrading the Configuration with the Upgrade Assistant
../Oracle_Home_12.2.1.1/oracle_common/upgrade/bin/ua
Apply Patch 26887297 to Avoid Issue When Enabling Internal SSL
If you are upgrading to OBIEE 12.2.1.3.0 or later, you may encounter the following bug after the upgrade when attempting
to enable internal SSL:
26887297 AFTER UPGRADE TO 12.2.1.3.0 /12.2.1.4 ENABLING INTERNAL SSL CAUSES OBICCS1 TO FAIL TO START
The Cluster Controller system component will fail to start. To avoid this issue, apply the following patch to the new Oracle
Home for the version you have upgraded to (12.2.1.3.0 or 12.2.1.4.0):
Patch 26887297 AFTER UPGRADE TO 12.2.1.3.0 ENABLING INTERNAL SSL CAUSES CCS TO FAIL TO START
For more information and an alternative workaround to applying the patch, check the following note:
2314918.1 OBIEE 12c: Unable To Start obiccs1 Services After Upgrading OBIEE From 12.2.1.0 To 12.2.1.3 Or Higher
Enabling Internal SSL

You only need to enable internal SSL, if you had done any of the following:
You previously disabled it for the upgrade process because you had it previously enabled.
You did not have internal SSL previously enabled, but you require it. Then follow the 'Enable End-to-End SSL' steps
in the Security Guide -> Enable End-to-End SSL
After the upgrade is complete, enable internal SSL communication and start the instance:
../Oracle_Home/user_projects/domains/bi/bitools/bin/ssl.sh internalssl true

Logging to: ../Oracle_Home/user_projects/domains/bi/bilogs/sslcommand.log
Reading domain
Setting protocol to https for server bi_server1
Rebinding channel certificates for server bi_server1
Checking certificate exists for endpoint: BI-SECURITY-SOAP.bi_server1
http://demobi.us.oracle.com:9505/bi-security/service - custom channel bi_internal_channel1
No new certificates required.
Internal BIEE communications have been configured to use SSL with certificates
matching the current listening addresses. Rerun if you change the addresses.
To achieve end to end security you also need to review the SSL configuration
of other components, including the external ports of WebLogic servers.
All certificates have more than 30 days to expiry.
Startup all BIEE servers to consume the new configuration. For example run the start[.sh]
command line tool in the same directory as this ssl tool.
./start.sh
Testing the Upgrade
Log in to Analytics and check the new OBIEE version:
After upgrading OBIEE the following directories are under ../Oracle_Home_12.2.1.1 (new Oracle Home):
../Oracle_Home_12.2.1.1
-bash-4.2$ ls -l
total 132
drwxr-x--- 19 oracle oracle 4096 Jun 23 19:11 bi
drwxr-x--- 2 oracle oracle 4096 Jun 23 19:12 bin
drwxr-x--- 4 oracle oracle 4096 Jun 23 17:15 cfgtoollogs
drwxr-x--- 5 oracle oracle 4096 Jun 23 17:13 coherence
drwxr-x--- 4 oracle oracle 4096 Jun 23 19:10 crs
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:10 css
-rw-r----- 1 oracle oracle 217 Jun 23 21:42 domain-registry.xml
drwxr-x--- 8 oracle oracle 4096 Jun 23 17:14 em
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:10 has
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:12 install
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:12 instantclient
drwxr-x--- 19 oracle oracle 4096 Jun 23 19:12 inventory
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:10 jdbc
drwxr-x--- 2 oracle oracle 4096 Jun 23 19:10 jlib
drwxr-x--- 5 oracle oracle 4096 Jun 23 19:10 ldap
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:12 lib
drwxr-x--- 8 oracle oracle 4096 Jun 23 19:12 network
drwxr-x--- 5 oracle oracle 4096 Jun 23 19:10 nls
drwxr-x--- 12 oracle oracle 4096 Jun 23 17:14 OPatch
drwxr-x--- 25 oracle oracle 4096 Jun 23 19:10 oracle_common
drwxr-x--- 4 oracle oracle 4096 Jun 23 19:10 oracore
-rw-r----- 1 oracle oracle 130 Jun 23 17:15 oraInst.loc
drwxr-x--- 8 oracle oracle 4096 Jun 23 17:15 oui
drwxr-x--- 5 oracle oracle 4096 Jun 23 19:10 plsql
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:12 plugins
drwxr-x--- 5 oracle oracle 4096 Jun 23 19:10 precomp
drwxr-x--- 8 oracle oracle 4096 Jun 23 19:10 rdbms
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:10 slax
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:10 sqlplus
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:10 srvm
drwxr-x--- 3 oracle oracle 4096 Jun 23 19:28 user_projects
drwxr-x--- 7 oracle oracle 4096 Jun 23 17:13 wlserver
drwxr-x--- 4 oracle oracle 4096 Jun 23 19:10 xdk
There is an empty directory created by the installer under the user_projects directory of the new Oracle Home but it can be
ignored:
../Oracle_Home_12.2.1.1/user_projects/domains
as the "bi" domain is still under the upgraded directory:
-bash-4.2$ ls -l
../Oracle_Home/user_projects/domains
-bash-4.2$ ls -l
total 4
drwxr-x--- 29 oracle oracle 4096 Jun 23 22:21 bi
-bash-4.2$ cd bi
-bash-4.2$ ls -l
total 260
drwxr-x--- 2 oracle oracle 4096 Mar 15 14:49 autodeploy
drwxr-x--- 5 oracle oracle 4096 Mar 15 15:05 bidata
drwxr-x--- 4 oracle oracle 4096 Jun 23 15:25 bilogs
drwxr-x--- 6 oracle oracle 4096 Jun 23 21:41 bin
drwxr-x--- 2 oracle oracle 4096 Jun 23 21:42 BipJmsStore
drwxr-x--- 2 oracle oracle 4096 Jun 23 22:25 BipJmsStore_auto_1
drwxr-x--- 3 oracle oracle 4096 Mar 15 15:05 bisysman
drwxr-x--- 3 oracle oracle 4096 Mar 15 14:53 bitools
drwxr-x--- 2 oracle oracle 4096 Jun 23 22:15 biupgrade
-rw-r----- 1 oracle oracle 1 Mar 15 14:57 blankLine.txt
drwxr-x--- 3 oracle oracle 4096 Mar 15 15:14 common
drwxr-x--- 13 oracle oracle 4096 Jun 23 22:21 config
drwxr-x--- 2 oracle oracle 4096 Mar 15 14:49 console-ext
-rw-r----- 1 oracle oracle 21523 Jun 23 22:30 createDDL.jdbc
-rw-r----- 1 oracle oracle 87061 Jun 23 20:59 debugMagicThreadDumpFile
-rw-r----- 1 oracle oracle 226 Jun 23 22:23 derby.log
-rw-r----- 1 oracle oracle 122 Jun 23 20:59 derbyShutdown.log
-rw-r----- 1 oracle oracle 4038 Jun 23 22:30 dropDDL.jdbc
drwxr-x--- 2 oracle oracle 4096 Jun 23 22:25 DssJmsStore_auto_1
-rw-r----- 1 oracle oracle 139 Jun 23 22:21 edit.lok
-rw-r----- 1 oracle oracle 328 Mar 15 14:49 fileRealm.properties
drwxr-x--- 2 oracle oracle 4096 Mar 15 15:17 generated_classes
drwxr-x--- 3 oracle oracle 4096 Jun 23 21:43 init-info
drwxr-x--- 2 oracle oracle 4096 Jun 23 22:25 JRFWSAsyncFileStore_auto_1
drwxr-x--- 2 oracle oracle 4096 Mar 15 14:49 lib
drwxr-x--- 5 oracle oracle 4096 Jun 23 22:31 nodemanager
drwxr-x--- 3 oracle oracle 4096 Jun 23 22:21 orchestration
drwxr-x--- 3 oracle oracle 4096 Mar 15 15:23 precompiled
-rw-r----- 1 oracle oracle 27 Mar 15 14:55 readme.txt
drwxr-x--- 2 oracle oracle 4096 Sep 24 2015 resources
drwxr-x--- 2 oracle oracle 4096 Jun 23 21:42 security
drwxr-x--T 9 oracle oracle 4096 Mar 15 15:18 servers
-rw-r----- 1 oracle oracle 821 Jun 23 21:42 startManagedWebLogic_readme.txt
-rwxr-x--- 1 oracle oracle 277 Jun 23 21:42 startWebLogic.sh
drwxr-x--- 3 oracle oracle 4096 Mar 15 14:53 store
drwxr-x--- 8 oracle oracle 4096 Jun 23 21:42 sysman
drwxr-x--- 7 oracle oracle 4096 Mar 15 15:16 system_components
drwxr-x--- 5 oracle oracle 4096 Jun 23 22:31 tmp
Start and stop scripts to use are also under the upgraded domain directory:
../Oracle_Home/user_projects/domains/bi/bitools/bin/start.sh
../Oracle_Home/user_projects/domains/bi/bitools/bin/stop.sh
Reference: Fusion Middleware Upgrading Oracle Business Intelligence
Alternative 'Out of Place' Upgrade
The OBIEE 12c Upgrade Guide references the FMw Planning an Upgrade Guide About In-Place versus Out-of-Place Upgrades
This documents 'out of place' binaries and 'out of place' domain, but in all documented cases, the RCU schemas are upgraded
'in-place'
We would recommend 'in place' approach as documented and highlighted in this note.
In some cases, you may have a need to opt for a fresh installation.
Whether you perform an 'in place' upgrade or an 'out of place' upgrade, it still needs to be planned with backups, certifications
and system requirements executed.
The high-level steps would be:
Install new RCU

export | import RCU schema data
Install new binaries
Configure new domain with the Configuration Assistant
Configure LDAP|SSO|DB security (or export|import WLS LDAP if primary security)
export | import BAR
Optional: Scan and Update Catalog
Optional: Run BVT on source and target
Optional: Apply or re-apply customization(s)
REFERENCES
NOTE:2070465.1 - OBIEE 12c: Required and Recommended Bundle Patches and Patch Sets For Oracle Business Intelligence
12c
NOTE:2067527.1 - OBIEE 12c: Quick Reference For Architecture, Lifecycle Management and File Locations
NOTE:2064302.1 - OBIEE 12c: Quick Reference For Oracle Business Intelligence Enterprise 12c (12.2.1) Installation
Didn't find what you are looking for?

Upgrade Steps Guide

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Upgrade Steps Guide

Transféré par

Droits d'auteur :

Formats disponibles

4/15/2020 Document Display

Copyright (c) 2020, Oracle. All rights reserved. Oracle Confidential.

Business Intelligence Suite Enterprise Edition - Version 12.2.1.0.0 and later

Oracle Fusion Middleware Pre-Upgrade Checklist

JDK: configure JDK in your PATH and JAVA_HOME

export JAVA_HOME=/[path to your jdk]/jdk8

Disabling Internal SSL

../Oracle_Home/user_projects/domains/bi/bitools/bin/ssl.sh internalssl false

Logging to: ../Oracle_Home/user_projects/domains/bi/bilogs/sslcommand.log

Installing Fusion Middleware Infrastructure Release 12.2.1.1

[path to jdk8/bin]/java -jar fmw_12.2.1.1.0_infrastructure.jar

drwxr-x--- 4 oracle oracle 4096 Jun 23 17:15 cfgtoollogs

Installing Oracle Business Intelligence Release 12.2.1.1

cd /[path to your software download]

Running the Readiness Check

Here is a sample Readiness Report file

Upgrading Schemas with the Upgrade Assistant

Stop the instance and run the Upgrade Assistance:

Backing up the mapViewerConfig.xml File

Reconfiguring the BI Domain with the Reconfiguration Wizard

Restoring the mapViewerConfig.xml File

Upgrading the Configuration with the Upgrade Assistant

Apply Patch 26887297 to Avoid Issue When Enabling Internal SSL

Enabling Internal SSL

../Oracle_Home/user_projects/domains/bi/bitools/bin/ssl.sh internalssl true

All certificates have more than 30 days to expiry.

Testing the Upgrade

Log in to Analytics and check the new OBIEE version:

as the "bi" domain is still under the upgraded directory:

Reference: Fusion Middleware Upgrading Oracle Business Intelligence

Alternative 'Out of Place' Upgrade

The high-level steps would be:

Install new RCU

Vous aimerez peut-être aussi