Oracle Database Software Installation On Unix v30
Oracle Database Software Installation On Unix v30
Symptom
Oracle Database Software Installation on Unix
This SAP note describes the installation of Oracle Database software (Oracle Homes) on Unix in an SAP environment.
Applies to Unix platforms (AIX, HPUX, Linux, Solaris).
Does NOT apply to Engineered Systems (Exadata, ExaCS, ExaCC, ODA). See SAP note 2992680 for Engineered Systems.
Applies to Oracle Database 19c
Applies to Oracle Database 18c
For Oracle Database 12c see SAP note 1915301.
For Oracle Database 11g see SAP note 1524205.
News
2024-10-18 - Installation procedure from SAP Note 3296921 not restricted to OL9 / RHEL9
2024-Jul-09 - SAP RUNINSTALLER 19-031 available (see SAP Note 3296921)
2022-Mar-09 - Using '-invLoc <path>' and '-invPtrLoc <path>' option
2021-Jan-08 - Cloning an Oracle Database Home see SAP Note 3009807
2020-Dec-15 - SAP RUNINSTALLER 19-026 released: new option '-no_empty_dir_check'
2020-Nov-26 - Does NOT apply to Engineered Systems (Exadata, ExaCS, ExaCC, ODA).
2020-Nov-20 - SAP RUNINSTALLER only for on-prem and non-Oracle Engineered Systems
2020-Jul-21 - SAP RUNINSTALLER 19-024 available
2020-May-28 - Installation on Red Hat Enterprise Linux 8 and Oracle Linux 8
2020-Apr-02 - Installation Oracle Home path <IHRDBMS> must not contain symbolic links (symlink, softlink)
2020-Feb-12 - SAP RUNINSTALLER 19-018 available
2019-Nov-22 - 19c SLES15: Oracle Installer Bug 29742223: prereq check for libstdc++33
2019-Oct-10 - 19c SLES12: Oracle Installer Bug 29742223: prereq check for libstdc++33
2019-Aug-23 - rootpre.sh update #2 (AIX)
2019-Aug-13 - rootpre.sh update #1 (AIX)
2019-Jul-04 - updated for Oracle Database 19c
2019-Mar-01 - Released for Oracle Database 18c
Other Terms
RUNINSTALLER, runInstaller
Oracle Universal Installer, Oracle Database Setup Wizard
Oracle home, Installation Oracle Home (IHRDBMS), Runtime Oracle Home (OHRDBMS)
Reason and Prerequisites
Prerequisites
Applies to Unix platforms (AIX, HPUX, Linux, Solaris).
Does NOT apply to Engineered Systems (Exadata, ExaCS, ExaCC, ODA).
Applies to Oracle Database 19c
Applies to Oracle Database 18c
Installation Concept
Starting Oracle Database Release 11.2, SAP introduced the installation concept for Oracle database homes with "Installation Oracle home" and "Runtime Oracle home".
"Installation Oracle Home" (IHRDBMS) denotes the path where the Oracle home is installed. This path is used for installation and patching of the Oracle home.
"Runtime Oracle home" denotes the path from which Oracle database instances are run. This path is set in the ORACLE_HOME environment variable.
With this approach environment variable ORACLE_HOME and other dependent environment variables like PATH remain unchanged when a new Oracle home of a higher patch set release or with a higher
patch level (minimal downtime patching) was installed. For more information, see SAP Note 1524205.
Use of Symbolic Links for <IHRDBMS>
Starting 19c, the path of Installation Oracle Home <IHRDBMS> must not contain symbolic links (symlinks, softlinks). For more information, see SAP Note 2604854.
Signifier Description
"Runtime Oracle Home" OHRDBMS Oracle Home path; used for runtime; value of env. var. $ORACLE_HOME; symbolic link points to IHRDBMS
"Installation Oracle Home" IHRDBMS Oracle Home path; used for installation (software management)
Release 19c Release 18c Release 12.2.0.1 Release 12.1.0.2 Release 11.2.0.4
<DBSID> / <dbsid> name of the SAP database (upper case / lower case) $DB_SID
<ORACLE_SID> name of the Oracle database instance SI: $DB_SID, RAC: ${DB_SID}001, ${DB_SID}002
<IHRDBMS> Installation Oracle home = location where Oracle Database software is extracted. /oracle/<DBSID>/<YY>.0.0, see above
<ora_sapdvd> Mount point / Location of SAP DVD containing Oracle Database software -
<ora_image_file> Name of Oracle home image file containing the Oracle Database software <platform>_<release>_db_home.zip
Solution
New with 19c
New with 18c
Installing Oracle Database Software
Installing Oracle Database Software with SAP RUNINSTALLER
Installing SAP Bundle Patch with MOPatch
Installing Oracle Database Software Advanced Options
Removing Oracle Database Software
Cloning an Oracle Database Home
Appendix
A - About SAP RUNINSTALLER
B - Troubleshooting Oracle Database Software Installation
C - Installing Oracle Database Software Manually
You can use Oracle Database Software (Oracle Home Gold Image) from SAP DVDs and SAP RUNINSTALLER to install a new Oracle home if the following prerequisites are met:
Oracle Single instance or Oracle RAC
SAP database on premise
SAP database on Non-Oracle Engineered System
For Oracle Engineered Systems you must use the corresponding tool to download the database software and install a new database Oracle home:
On Exadata on premise (bare metal and virtual): dcli/oedacli, see SAP Note 1590515
On Exadata Cloud Service (ExaCS): dbaascli, see SAP Note 2614028
On Exadata Cloud Service (ExaCC): dbaascli, see SAP Note 2956661
Software Download
1. Go to SAP Support Portal -> Software Downloads -> Databases -> Oracle -> Oracle <release> Software.
2. Open the folder for your platform and download the Oracle Database software (SAP DVD) to your database server.
Preparation
1. Log on as Oracle software owner
2. Backup the Oracle central inventory before you install a new Oracle home (recommended).
3. Go to Oracle Database software location <ORA_SAPDVD>/<PLATFORM>/db_home/SAP
4. Set environment variable DB_SID.
5. Set environment variable DISPLAY (only for non-silent installation)
OS> id; pwd;
OS> cd <ORA_SAPDVD>/<PLATFORM>/db_home/SAP
OS> pwd
OS> echo "DB_SID=$DB_SID"
OS> echo "DISPLAY=$DISPLAY"
Installation of Oracle Database 19c according to SAP Note 3296921
When you install Oracle Database 19c (19.3 base release) on an new operating system version that is unknown to the Oracle installer (e.g. OL 9 or RHEL 9), you will get the following error:
[WARNING] [INS-08101] Unexpected error while executing the action at state:'supportedOSCheck'
CAUSE: No additional information available.
ACTION: Contact Oracle Support Services or refer to the software manual.
SUMMARY:
- java.lang.NullPointerException
SAP Note 3296921 describes a (workaround) procedure that uses the '-applyRU' option that avoids this error .
For new OS versions like Oracle Linux 9 (OL 9) or Red Hat Enterprise Linux (RHEL 9) you must follow the procedure from SAP Note 3296921.
However, the procedure is not restricted to Linux as operating system, not restricted to OL 9 or RHEL 9, and not restricted to new, unknown OS versions. The procedure can also be used to install Oracle
Database 19c on known OS versions of any Unix platform (AIX, HP-UX, Linux, Solaris). For more information see SAP Note 3296921.
Installation of Oracle Database 19c on RHEL 9 / OL9
SAP RUNINSTALLER 19-031 or higher checks setting of environment variable CV_ASSUME_DISTID.
For installation of Oracle Database 19c on RHEL 9 or OL 9, follow instructions of SAP Note 3296921.
Installation of Oracle Database 19c on RHEL 8 / OL8
Only for installation of Oracle Database 19c on Linux versions Red Hat Enterprise Linux 8 / Oracle Linux 8:
Set environment variable CV_ASSUME_DISTID = OL7
OS> setenv CV_ASSUME_DISTID OL7 C shell
If this is the first time you install Oracle Database software on IBM AIX on Power Systems (64-Bit), then you must run rootpre.sh before you continue. For more information about running rootpre.sh,
see below.
Oracle Database Setup Wizard Dialog
The following table shows Oracle Database Installer screens in a typical, SAP standard installation scenario for Unix platforms:
6 Prerequisite Checks Checks OS prerequisites. Make sure that all prerequisites are met.
7 Summary Review installation settings, then click on 'Install' to register Oracle Home.
8 Install Product Monitor installation progress. When prompted, run root scripts orainstRoot.sh and/or root.sh as root.
Answer the question "Do you want to setup Oracle Trace File Analyzer (TFA) now ?" with 'NO'.
9 Finish " The registration of Oracle Database was successful" indicates that the installation was successful.
Click 'Close' to exit from Oracle Database 18c Installer.
Registering a New Oracle Home without Extracting the Oracle Home Image File
The Oracle Home Image file has already been extracted successfully, but the Oracle Home is not yet registered. When you now run './RUNINSTALLER' without additional arguments, you will receive the
following error:
( ERROR ) - Oracle home directory is not empty - cannot extract.
(ERROR ) - Cannot extract Oracle home image file into Oracle home directory that is not empty.
(INFO ) - Option #1: skip extraction and continue with registration of Oracle home
(INFO ) - Rerun with option '-ohregister -ohsapcfg' to skip this step and continue the installation.
(INFO ) - Option #2: remove Oracle home directory, then rerun.
To continue the installation, you need to skip the extraction of the Oracle home image file using the following command:
OS> ./RUNINSTALLER -ohregister -ohsapcfg
Registering a New Oracle Home
Scenario: SAP System Copy or SAP System Rename
When you perform an SAP System Copy or SAP System Rename, the source Oracle home is cloned or renamed to the new target Oracle home. To finalize the installation of the Oracle home, you need to
register the Oracle home as follows:
1. Log on as oracle
2. Go to target Oracle home
OS> cd <ORACLE_HOME>
3. Set environment for RUNINSTALLER
OS> setenv DB_SID <DBSID>
OS> setenv DISPLAY <DISPLAY>
4. Run RUNINSTALLER to check:
OS> ./RUNINSTALLER -ohregister -ohsapcfg -q
5. Run RUNINSTALLER to register the Oracle home
OS> ./RUNINSTALLER -ohregister -ohsapcfg
6. Verify that the Oracle home is registered in the central inventory
OS> ./OPatch/opatch lsinventory
Note: if the SAP RUNINSTALLER script '<ORACLE_HOME>/RUNINSTALLER' does not exist, you need to run the Oracle Database Setup Wizard '<ORACLE_HOME>/runInstaller' to register the Oracle
home.
Performing Standalone Prerequisite Checks
In order to check the installation prerequisites without registration and configuration of the Oracle home, you must run the following separate steps:
OS> ./RUNINSTALLER -ohextract # Step 1: Extract Oracle Home Image file
OS> ./RUNINSTALLER -ohcheck # Step 2: Check Installation Prerequisites
In order to complete the installation, run the following command:
OS> ./RUNINSTALLER -ohregister -ohsapcfg # Step 3: Register and configure the Oracle home
Installing a New Oracle Home Step-By-Step
To install the new Oracle home step-by-step, run the following commands:
OS> ./RUNINSTALLER -ohprepare
OS> ./RUNINSTALLER -ohverify
OS> ./RUNINSTALLER -ohextract
OS> ./RUNINSTALLER -ohcheck
OS> ./RUNINSTALLER -ohregister
OS> ./RUNINSTALLER -ohsapcfg
With these commands you install the new Oracle home step-by-step. For more information, run 'RUNINSTALLER -help'.
Installing a New Oracle Home in a RAC Environment (Real Application Clusters)
You can use RUNINSTALLER to install a new Oracle home in an RAC environment (custom installations, not on Oracle Engineered Systems like Exadata). After the installation, follow the RAC-specific
post-installation steps mentioned below.
Installing a New Oracle Home on AIX (rootpre.sh)
Reference:
'Database Installation Guide for IBM AIX on POWER Systems (64-Bit)'
https://docs.oracle.com/en/database/oracle/oracle-database/18/axdbi/running-the-rootpre-sh-script.html
https://docs.oracle.com/en/database/oracle/oracle-database/19/axdbi/running-the-rootpre-sh-script.html
Oracle Support Document 201622.1
AIX only: If you start the Oracle installer in interactive mode, you see the following message:
********************************************************************************
Your platform requires the root user to perform certain pre-installation
OS preparation. The root user should run the shell script 'rootpre.sh' before
you proceed with Oracle installation. The rootpre.sh script can be found at:
<ORACLE_HOME>/clone/rootpre.sh
Answer 'y' if root has run 'rootpre.sh' so you can proceed with Oracle
installation.
Answer 'n' to abort installation and then ask root to run 'rootpre.sh'.
********************************************************************************
Has 'rootpre.sh' been run by root in this machine? [y/n] (n)
When do you have to run rootpre.sh?
Run the rootpre.sh script only the first time you install Oracle Database on IBM AIX on POWER Systems (64-Bit). You do not have to run the rootpre.sh script on an IBM AIX on POWER Systems (64-Bit)
server that has an Oracle Database software already installed.
Where do you find rootpre.sh?
You find the script at <ORACLE_HOME>/clone/rootpre.sh of the extracted Oracle home.
How can you skip this dialog?
To skip the dialog in the Oracle installer you set SKIP_ROOTPRE=TRUE in the environment before you start the Oracle installer.
How can you run the Oracle installer in silent mode?
If you run the Oracle installer in silent mode without setting SKIP_ROOTPRE, the Oracle installer will hang (Oracle Bug 30258274). Therefore, for silent mode installation, use the following procedure:
1. Make sure that rootpre.sh has been run.
2. Set SKIP_ROOTPRE=TRUE in the environment
3. Start installation
If this is the first time you install Oracle Database on IBM AIX on POWER Systems (64-Bit), you can use the step-by-step installation procedure:
1. Extract the Oracle Home Image File
OS> ./RUNINSTALLER -ohprepare -ohverify -ohextract [-silent]
2. Switch to user root and run rootpre.sh
OS> su - root
OS> <ORACLE_HOME>/clone/rootpre.sh
OS> exit
3. Set SKIP_ROOTPRE
OS> setenv SKIP_ROOTPRE TRUE
OS> export SKIP_ROOTPRE=TRUE
4. Register and Configure Oracle Home
OS> ./RUNINSTALLER -ohregister -ohsapcfg [-silent]
Post-Installation
The new Oracle home is now successfully installed, but the Oracle home is not yet complete and ready-to-use for SAP.
1. Before you can use a new installed Oracle home to create a new SAP database or to upgrade an existing SAP database, you must install the current SAP Bundle Patch (SBP). For more information,
follow the instructions given in the corresponding SBP README.
2. For RAC installations: Check $ORACLE_HOME/install/orabasetab on remote RAC cluster nodes.
For more information, see SAP Note 1521371.
3. For RAC installations: Create <OHRDBMS> runtime Oracle home on remote RAC cluster nodes.
OS> ln -s <IHRDBMS> <OHRDBMS>
Example: OS> ln -s /oracle/$DB_SID/18.0.0 /oracle/$DB_SID/18
Installing SAP Bundle Patch with MOPatch
For SAP you must install an SAP Bundle Patch. In general we recommend to install the latest SBP.
The installation of an SBP consists of 2 steps:
1. Patching the Oracle Home
With MOPatch, you install the SBP into the Oracle Home. This updates the Oracle home software with the new SBP. You must perform this step before (!) you create or upgrade the database.
2. Patching the Database
The database must be adapted to the new SBP by performing certain SBP post-installation tasks (catsbp) and by adapting database parameters. When you install a new SAP database, it is
recommended to perform the SBP post-installation tasks before loading the SAP database. If this is not possible, then you must perform these tasks right after the installation of the new system is
completed.
SBP Installation Procedure
1. Download the current SBP from the SAP Support Portal.
2. Follow the SBP-specific instructions given in the corresponding SBP README to install the SBP.
Note: When you run 'mopatch.sh' to install the SBP, make sure that LD_LIBRARY_PATH (SHLIB_PATH, LIBPATH) is not set or does not contain a reference to another Oracle home to avoid linking
errors.
OS> env | grep LD_LIBRARY_PATH
OS> env | grep SHLIB_PATH
OS> env | grep LIBPATH
Using the new Oracle Home for SAP
After you have successfully installed the SBP, the new Oracle home is ready for SAP. You can either create a new SAP database (e.g. using SWPM), upgrade an existing SAP database to this release (e.g. using
DBUA) or patch an existing SAP database to this higher patch level.
After you have created a new SAP database from this new installed Oracle home, or after you have upgraded an existing SAP database to this new installed Oracle home, you must perform the SBP-specific
post-installation steps as described in the SAP Bundle Patch README (SBP README).
Installing Oracle Database Software Advanced Options
One Oracle Home Patching Strategy
You can run your SAP database <DB_SID> from one Oracle home. This Oracle home is installed in <IHRDBMS>=/oracle/<DB_SID>/18.0.0 which is the SAP default path for an Oracle home of release 18c.
New SAP Bundle Patches are installed into this Oracle home. Although the Oracle home directory says '18.0.0', the full release of the Oracle home depends on the current installed SAP Bundle Patch.
Minimum Downtime Patching Strategy
If you decide to install a new Oracle home with a new SAP Bundle Patch into a new, separate Oracle home directory, then we suggest to use the following Oracle home naming convention. With this strategy,
you can immediately identify the current installed Release Update from the name of the Installation Oracle home directory IHRDBMS.
Appendix
A - About SAP RUNINSTALLER
SAP RUNINSTALLER Scripts
'SAP RUNINSTALLER' is an SAP specific installation tool for Oracle database software to install new Oracle database homes in SAP environments. SAP RUNINSTALLER consists of 2 shell scripts. The
current version of SAP RUNINSTALLER is attached to this SAP Note.
Oracle Database 19c:
19-024: option '-invPtrLoc' removed;
19-018: available on SAP DVD
Oracle Database 18c:
18-021: available on SAP DVD
SAP RUNINSTALLER Default Values
SAP RUNINSTALLER uses the following SAP default values:
The value for <DBSID> must be specified in the environment (env. var. $DB_SID).
Location
From DVD SAP RUNINSTALLER automatically finds the Oracle home image file on the DVD.
From extracted Oracle home SAP RUNINSTALLER automatically finds the extracted Oracle home.
From any directory You can download a new SAP RUNINSTALLER version to your database server.
To install a new Oracle home, use the option '-oracle_stage <path>' to specify the location of the Oracle home image file.
Command Description
You perform the installation of a new Oracle home in one run (RUNINSTALLER [-ohinstall]), or you can run the steps one after the other separately.
SAP RUNINSTALLER Basic Options
Command Description
OS prerequisites are not met? Check OS prerequisites: 'RUNINSTALLER -ohcheck'; check Oracle Database Installation Guide;
SAP RUNINSTALLER fails with <invalid option> Run 'RUNINSTALLER -help' for more information.
Oracle Universal Installer (OUI) fails Check OUI log file(s) at <oraInventory>/logs. The default location of the central inventory is <ORACLE_BASE>/oraInventory.
Is this a known installation issue? Check SAP note 1915299 for solutions and workarounds of known installation issues.
Location of central Oracle inventory? Check Oracle configuration files /etc/oraInst.loc or /var/opt/oracle/oraInst.loc
SAP RUNINSTALLER too old? Ensure that you have installed the current SAP RUNINSTALLER version.
Known Issues
Issue Solution
Cause
The Oracle Home has its own file system that contains the directory 'lost+found'.
Solution
Cause
Solution
If this is the first Oracle software installation, remove the old oraInst.loc file. Otherwise change the entry as follows:
Symptom
Cause
On AIX, dialog starts regarding rootpre.sh. In silent mode, you do not see this dialog.
Workaround/Solution
Symptom
Workaround
Symptom
Oracle Installer checks for RPMs libstdc++33***, but this package does not exist on SLES12 SP3 or later. Instead, package libstdc++6 (=new version of libstdc++33) mu
st be installed.
Installation Logfile
TASK_SUMMARY:FAILED:CRITICAL:VERIFICATION_FAILED
Cause
Oracle Bug 29742223. For more information, see MOS Doc ID 2540685.1.
Workaround
Ignore this prereq check error. Ensure that libstdc++6 (new version of libstdc++33) package is installed instead.
$ rpm -q libstdc++
libstdc++6
$
Additional information
For Linux OS requirements (SLES12, SLES15), see SAP Note 2478541 or Oracle Database documentation here: https://docs.oracle.com/en/database/oracle/oracle-data
base/19/ladbi/operating-system-requirements-for-x86-64-linux-platforms.html.
Run the Oracle Database Setup Wizard with the following entries / values:
1. Configuration Option: Choose 'Set Up Software Only'
2. Database Installation Options: Single Instance or Real Application Clusters - leave the default and continue
3. Database Edition: Choose 'Enterprise Edition'
4. Installation Location: For ORACLE_BASE, set '/oracle/<DBSID>'
5. Operating System Groups: Choose OS group 'oper' for OSOPER and OSBACKUPDBA, OS group 'dba' for the rest
6. Prerequisite Checks: On this page verify that all prerequisites are met
7. Summary: Review summary page, click on 'install' if satisfied
8. Install Product: Monitor installation progress, run configuration scripts (root.sh) when prompted
Note: For SAP it is not needed to setup the Oracle Trace File Analyzer (TFA) when running root.sh. For more information, see SAP Note 1915299.
9. Finish: Confirm by clicking 'Close' button.
10. Verify the log file of this install session.
Step #4: SAP-Specific Oracle Home Configuration
# Create Runtime Oracle Home (if not yet done)
ln -s $IHRDBMS $OHRDBMS
# Configure orabasetab (OHRDBMS) - Reference: SAP Note 1521371 (orabtt.sh)
If the tool orabtt.sh is not yet installed, then you can copy it from another Oracle home or install the corresponding Oracle patch 22819075.
Step #5: Install SAP Bundle Patch (SBP)
This step is mandatory. For more information, see section 'Installing Oracle Database SAP Bundle Patch' below.
Example:
Step #1 Create Installation Oracle Home and Runtime Oracle home mkdir -p $IHRDBMS && ln -s $IHRDBMS $OHRDBMS
Step #3 Configure and register the new Oracle home export DISPLAY=<display>; cd $IHRDBMS; ./runInstaller; echo runInstaller return code is $?
Step #4 SAP-Specific Oracle Home Configuration Configure orabasetab with orabtt. For more information, see SAP Note 1521371
Step #5 Install SAP Bundle Patch (SBP) For more information, see SBP README.
Attributes
Key Value
2992680 BC-DB-ORA
3296921 Installing Oracle Database 19c on Oracle Linux 9 and Red Hat Enterprise Linux 9
19cinstall-19-018-202002121652.zip 45 application/x-zip-compressed
19cinstall-19-031-202407021105.zip 50 application/x-zip-compressed
18cinstall-18-021-201902081553.zip 42 application/x-zip-compressed
19cinstall-19-024-202007211312.zip 47 application/x-zip-compressed
19cinstall-19-026-202012150956.zip 47 application/x-zip-compressed