SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix

Note Language: English Version: 48 Validity:
Valid Since 09.12.2010

Summary
Symptom Oracle Instant Client in SAP Environments

This note describes the installation and configuration of the Oracle Instant Client in an SAP environment on Unix. For Instant Clients on Windows platforms, please refer to note 998004.

Other terms
Oracle Instant Client Easy Client Instant Client Basic Instant Client Light

Reason and Prerequisites
The currently used Oracle Instant Client is not up-to-date.

Oracle Client Software DVD Download
Oracle 10.2.0.4 Client V5 DVD is available for download from SAP Service Market Place via https://service.sap.com/oracle-download Oracle 10.2 Software -> Installation -> Platforms -> Oracle

Solution Contents

Choosing the Recommended Oracle Instant Client Version Obtaining the Oracle Instant Client for an SAP Environment Using the Oracle Instant Client in an SAP Environment Manually Installing the Oracle Instant Client in an SAP Environment Determining the Oracle Instant Client Version Oracle Instant Client Compatibility Matrix Patching the Oracle Instant Client Installing the Oracle Instant Client for Secondary Connections Appendix Appendix A: Instant Client Packages for SAP Appendix B: Instant Client Package Contents

05.01.2011

Page 1 of

7

2. on Linux x86 (32-bit) this would look like: Item name on SMP: OCL_BASIC_10204_32_V2.4 that is currently available on the Service Marketplace.01.0.SAR File name: OCL10232. General recommendations: o SAP customers should use only the instant client versions released for SAP from the SAP Service Marketpace.SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix Choosing the Recommended Oracle Instant Client Version An Oracle Instant Client must be installed for all SAP Kernels (ABAP or Java) linked with Oracle release 10.2011 Page 2 of 7 . Running a mix of different versions is not recommended. Please install the latest instant client version of release 10.2 patchset release that is available on the SAP Service Marketplace should be installed. All SAP application servers of an SAP system should run with the same (=latest) version of the instant client.0. The use of Oracle instant client versions that are available on OTN is not supported.sap.SAR For example. Regarding overall support policy of instant client versions please refer to note 1339724.com/oracle-download Database Patches -> Oracle -> Oracle <patchset release> -> Instant Client -> <platform> The instant client packages follow the following naming conventions: Item name on SMP: OCL_BASIC_<RELEASE>_<WORDSIZE>_<VERSION>.SAR 05. For SAP installations only instant clients from SAP Service Marketplace should be installed. Oracle Instant Clients of release 10.0.2. The instant client of the latest Oracle 10.4 are recommended at the time of this writing.2.SAR File name: OCL<RELEASE><WORDSIZE>. Obtaining the Oracle Instant Client for an SAP Environment The latest version of the Oracle Instant Client for SAP environments may be downloaded from the Oracle download area on the SAP Service Marketplace: http://service.2 are no longer supported. o o o o Regarding support of instant clients please note: o o Oracle Instant Clients of release 10.2.

0. In an SAP environment the Oracle Instant Client is used in the following 3 scenarios: 1. The default path for the installed instant client in an SAP environment is /oracle/client/10x_<wordsize>/instantclient By default.2.SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix Using the Oracle Instant Client in an SAP Environment The Oracle Instant Client contains the complete Oracle client software required for an SAP system in an easy-to-install way. The SAP system runs with the EX2 kernel. This would currently be the 640_EX2 and 46D_EX2 kernel (see SAP note 1058988).2 or newer. The BR*Tools version 7. since this is a prerequisite for the BR*Tools version 7. The PREPARE phase of the upgrade to release 7. SAPINST furthermore installs the instant client on the database server.00 or above are used.00 and above. This would apply to SAP products such as BS 2005/NW 2004s. In the following scenarios the Oracle Instant Client needs to be installed manually as described in the following section: 1.2011 Page 3 of 7 .00 and above are all linked against Oracle release 10. the Oracle 10.00 has to be run. SAPINST installs the instant client in both cases. Consequently.2.40-based installations on the IBM PPC platform).2. 05.2 instant client software needs to be installed on all 7. 2. The SAP kernel 7. on a 64-bit platform and for instant client release 10. 3. Oracle Instant Clients replace the full client installations ("Oracle-Home-based client") that were required prior to Oracle release 10.00 to be started as the <sapsid>adm user.2 it does not make any difference whether the SAP system is a central system (DB/CI) or only an application server.00 kernel based application servers. This would normally be the case when the database was upgraded to Oracle release 10. The database was upgraded to Oracle 10.4 the latter directory would be named /oracle/client/10x_64/instantclient_10204 SAPINST automatically installs the instant client as described above for all new installations based on the 7. that path is a symbolic link pointing to a directory /oracle/client/10x_<wordsize>/instantclient_<release> For example. 2.00 kernel (and for 6. The basic philosophy that the version of the client software depends on the version of the SAP kernel still holds good. The SAP system runs with SAP Kernel 7.01.2. Starting with Oracle release 10.

05. stop all your SAP systems.SAR This results in a directory instantclient_<release> being created. SHLIB_PATH. Create a link from instantclient_<release> to instantclient by means of the following command: ln -s instantclient_<release> instantclient 5. Create directory /oracle/client/10x_64 if that does not already exist. Before you replace an instant client with a newer version.2011 .01. Change to directory /oracle/client/10x_64 and extract the instant client package by means of SAPCAR -xvf OCL<RELEASE><WORDSIZE>. 3. It MUST NOT contain more than one instant client directory or any Oracle Home directory ( $ORACLE_HOME/lib). 2. Download the instant client package from the SAP Service Marketplace as described in section "Obtaining the Oracle Instant Client for an SAP Environment" of this note. NEVER unzip or copy instant client packages to directories $ORACLE_HOME/lib or $ORACLE_HOME/bin. LIBPATH) MUST refer to only one instant client directory. Follow the following steps for manually installing a new version of the Oracle Instant Client: 1. It is recommended to extract the instant client package following the defaults defined by SAP (see previous section). regardless of ordering. You cannot replace an instant client of an SAP system while the system is up and running! 3. 4. SAP application servers. 4. and any other processes that use the instant client. The library search path (LD_LIBRARY_PATH.00 (or above) and ABAP Stack or Double Page 4 of 7 2.SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix Manually Installing the Oracle Instant Client in an SAP Environment Please keep the following in mind when manually installing the Oracle Instant Client: 1. Under no circumstances set the environment variable ORA_NLS10 for the <sapsid>adm user. On SAP systems with kernel 7.

execute the following additional steps: Check if the SAP DBSL can load the newly installed instant client correctly.2. if ldd cannot resolve all libraries.so If that succeeds.01.2. verify that the SAP system is able to connect to the database by means of R3trans -x Otherwise.4.3 you can determine the instant client version using the genezi utility from the instant client directory itself by calling "genezi -v". Since release 10. The instant client packages on SAP Service Marketplace contain a readme file called SAPIC_README that contains more detailed information about o o o o o build date OS and platform Oracle patchset release instant client version installed patches Please note that the instant client versions are not synchronized across platforms. instant clients with identical versions may contain different bug fixes on different platforms. Determining the Oracle Instant Client Version Starting with release 10. This is described in detail in the SAP Guide 'Upgrade to Oracle Database 10g Release 2 (10.0. execute the following additional steps: Update all references from the J2EE engine to the JDBC driver jars such that they point to the JDBC driver in the instant client directory.2): Unix' in chapter 'Changing the Location of the JDBC Driver'. It should be set as: /usr/sap/SID/SYS/exe/run:/oracle/client/10x_64/instantclient 6. On SAP systems with kernel 7.2011 Page 5 of 7 . Oracle Instant Client Compatibility Matrix The Oracle Instant Client interoperates with any database version that the full Oracle Client interoperates with. the Oracle Instant Clients released for SAP may be identified by a unique instant client version.SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix Stack.00 (or above) and Java Stack or Double Stack.0. then verify the value of the library search path for the <sid>adm user. For details please see Metalink Note 05. Change to the exe directory as user <sapsid>adm and run the ldd command on dboraslib.so: ldd dboraslib. In particular.

0.so ojdbc14.SAR.jar ojdbc6. Installing the Oracle Instant Client for Secondary Connections If you manually install the Oracle Instant Client on a system to open secondary connections to an Oracle instance.SAR Appendix B: Instant Client Package Contents dbclient.ora both exist and that the environment variable TNS_ADMIN points to the directory location of these two files.2011 Released for Customer 09. OCL_BASIC_10204_64_V3.SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix 207303.so libclntsh.01.jar Header Data Release Status: Released on: Master Language: 05.lst SAPIC_README classes12.jar genezi libclntsh.2010 14:44:22 English Page 6 of 7 .so libociei.2.SAR (64-bit platforms) Instant Client Package names on SAP Service Marketplace (if available): OCL_BASIC_10204_32_V2.SAR. Patching the Oracle Instant Client SAP customers are strongly advised not to create their own patched versions of the Oracle Instant Client.2. For SAP systems the minimum required version of the Oracle Instant Client is 10.1 is not supported in an SAP environment. you need to make sure that the Oracle Net Services files sqlnet.1: Oracle Client / Server Interoperability Support The use of Oracle Instant Client 10.0.x / 10.SAR OCL_BASIC_10204_32_V4. Updated versions of the instant client for SAP will be made available for download on the SAP Service Marketplace if this is necessary.10.so. OCL_BASIC_10204_64_V4.SAR.12.ora and tnsnames.1 libnnz10.0.SAR OCL_BASIC_10204_32_V3. OCL_BASIC_10204_64_V2.SAR (32-bit platforms) OCL10264. Appendix Appendix A: Instant Client Packages for SAP File names: OCL10232.2.1.

01.4 10g: "ThrtReadDBVersion: Db version overflow" w/ SAP start EX2 Kernels: Extended Kernel Maintenance 46D_EX2 Kernels 640_EX2 Kernels Update the Oracle Instant Client on Windows J2EE on Oracle: Updating the JDBC drivers Oracle database 10g: Preparation for SAP upgrade ORA-12701/ORA-12705/ORA-12709 05.2. 2011 DBA Cockpit: Oracle as a remote database Oracle 10.0: Patches/Patch Collections for 10.2.2.2 Extended Support free until July 31.0.2.0.2011 Page 7 of 7 .5 Oracle 10.0: Patches/patch collections for Oracle 10.SAP Note 819829 Oracle Instant Client Installation and Configuration on Unix Priority: Category: Primary Component: Secondary Components: BC-DB-ORA-SYS Database Interface / DBMS for Oracle Recommendations/additional info Installation information BC-DB-ORA Oracle The Note is release-independent Related Notes Number 1437021 1431752 1339724 1261329 1137346 1113270 1106096 1086956 1058988 998004 915079 836517 592657 Short Text Signal 11 with Oracle Instant Client on Fujitsu FlexFrame Oracle 10.