Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Trademarks The following terms are registered trademarks of International Business Machines Corporation in the United States and/or other countries: AIX, AIX/L, AIX/L (AIX/L), IBM, IBM (IBM), pSeries, Total Storage, Power PC. The following terms are registered trademarks of International Business Machines Corporation in the United States and/or other countries; Power VM, Advanced MicroPartitioning, AIX 5L, AIX 6 (logo), Micro Partitioning, Power Architecture, POWER6, POWER6, POWER7, Redbooks, System p, System p5, System p6, System p7, System Storage. A complete list of U.S trademarks owned by IBM may be found at: http://www.ibm.com/legal/copytrade.shtml Oracle, Java and all Java based trademarks are registered trademarks of Oracle Corporation in the USA and/or other countries UNIX is a registered trademark in the United States, other countries or both.
Disclaimers While efforts have been made to verify the information, this paper may contain errors. IBM makes no warranties or representation with respect to the content hereof and specifically disclaim any implied warranties of merchantability or fitness for any particular purpose. IBM assumes no responsibility for any errors that may appear in this document. The information contained in this document is subject to change without notice. IBM reserves the right to make any such changes without obligation to notify any person of such revisions or changes. IBM makes no commitment to keep the information contained herein up to date.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Table of Contents Introduction ....................................................................... 6 Oracle Transportable Database....................................... 7 Environment ...................................................................... 8 Prior to Migration ............................................................. 9 Hardware / Server ............................................................ 9 Initial AIX 6.1 tuning for the database & apps server ... 9 Software............................................................................ 9 AIX.................................................................................... 9 JAVA ............................................................................... 10 Visual Age C/C++ Compiler ......................................... 10 Oracle ............................................................................. 10 a) rootpre.sh ................................................................ 10 b) Oracle Universal Installer (OUI) ............................ 10 c) Other known OUI issues & workaround ................ 10 d) Oracle patches for AIX .......................................... 10 e) Other Oracle patches .............................................. 11 Storage & Other Considerations.................................... 11 a) JFS2 mount option for transfer of files. ................. 11 b) Data file fragmentation........................................... 12 c) Identifying & fixing fragmentation issues. ............ 12 Avoid Migration hazards................................................ 13
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Database Migration ........................................................ 14 Open Database in READ ONLY mode ........................... 14 Verify Portability ............................................................ 14 Check for external objects .............................................. 14 SQL statement for creating control file .......................... 15 Edit script ....................................................................... 15 Target Database Server .................................................. 16 Transfer Data files from the source database server ..... 16 Create Control file ......................................................... 16 Convert data files using RMAN ...................................... 16 Tuning the conversion of data files ................................ 17 Shut down the database .................................................. 18 Copy files from staging area .......................................... 18 Open Database & miscellaneous completion tasks ....... 18 a) Create Temporary Table space ............................... 18 b) External Objects ..................................................... 19 c) Compile Invalid Objects......................................... 19 d) Set Up and Start the Database listener ................... 19 e) Enable AutoConfig on Database server ................. 19
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Migrating the Applications node ................................... 20 Verify Patches on the source applications server .......... 20 Maintain Snapshot Information ..................................... 20 Request custom migration patch from Oracle................ 20 Set Up the Target APPL_TOP ....................................... 21 Copy the Security File for Jinitiator .............................. 21 Clone the AutoConfig XML context file ......................... 21 Install the Technology stack ........................................... 22 AutoConfig Setup............................................................ 22 Apply custom migration patch........................................ 22 Apply Techstack Interoperability patch ......................... 23 Regenerate file system objects........................................ 23 AutoConfig ..................................................................... 24 Finishing Tasks .............................................................. 24 Apply third party extension patches ............................ 24 Misc. and customizations ............................................ 24 Update printer settings ................................................. 24 Update workflow configuration settings ..................... 24 Review CLASSPATH setting ..................................... 25 AIX Specific Forms patches ........................................... 25 Start all services and test ............................................... 26 Summary.......................................................................... 27 References & Acknowledgements ................................. 28
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Introduction
The objective of this document is to provide a detailed step by step approach on how to perform a cross platform migration of the Oracle E-Business Suite Database 10gR2 or higher and 11i (11.5.10.x) E-Business Suite Applications environment to AIX. Oracle database operations are similar on all operating systems. However deployment strategies can vary on different operating systems. Migration of an existing Oracle 11i E-Business Suite database to a new architecture can prove to be overwhelming initially due to many factors like New operating system Operating system preparedness Installation nuances Oracle patches Database migration 11i E-Business Suite Application Migration
Oracle Database 10gR2 introduced the transportable database feature which is used for migration of the 11i E-Business Suite database. This is certified by Oracle in the series of steps described in My Oracle Support (MOS) note id 729309.1. Oracle 11i E-Business Suite Application migration is done with a series of procedures described in MOS note id 238276.1. This document is targeted towards users migrating from Solaris and HP-UX to AIX and covers topics mentioned above. The migration steps documented in this paper have been leveraged at numerous customer sites successfully and lessons learnt during these migrations are also included. For the purpose of this document, the source environment is on Sun Solaris and will be referred to as source database. The AIX environment will be referred to as the target database.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Oracle10gR2 (10.2.0.1) or higher is required for transporting a database. The next few steps explain the process for transporting an Oracle 10gR2 database from Sun Solaris to AIX . These steps are the same as they would be if you were transporting a database from any big-endian platform to AIX.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Environment
Source System Configuration: Hardware: Sun Fire V440 Server Software: Solaris 5.9 Oracle 10gR2 (10.2.0.4) or higher 4 x Ultra SPARC IIIi @ 1.59 GHz 32 GB RAM Direct Attach Storage D1000 Arrays.
Target System Configuration: Hardware: IBM p6 570 Software: AIX 6 Visual Age C/C++ Professional v7.0 Oracle 10gR2 (10.2.0.4) or higher 2 x POWER6 CPU @ 3.5 GHz 32 GB RAM IBM N3700.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Prior to Migration
Hardware / Server
Initial AIX 6.1 tuning for the database & apps server
a) Network tuning (interface level) tcp_sendspace & tcp_recvspace=262144 tcp_nagle_limit & tcp_nodelayack = 1 rfc1323=1 b) ioo numfsbufs=1568 j2_maxPageReadAhead=256 c) Misc ulimit a for oracle & apps user should return unlimited for all (except core) maxuproc=4096 export AIXTHREAD_SCOPE=S for oracle and apps user For AIX 5.3 tuning, please refer to a document titled Oracle Architecture & Tuning on AIX and a link to this document is included in the reference section
Software AIX
Following file sets are required for Oracle database and Apps servers. Use the command lslpp l | grep <file set name> to verify the existence of a file set bos.adt.base bos.adt.lib bos.adt.libm bos.perf.libperfstat bos.perf.perfstat bos.perf.protocols xlC.aix.rte
AIX patches should be consistent with MOS note id. 282036.1 Minimum software version and patches required to support Oracle products on IBM Power System.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX. Version 3, December 2010 Page No. 9
JAVA
AIX uses IBM JDK only for all Oracle products. Depending on the version of the database and the E-business Suite, appropriate version of JAVA should be installed. The version of JDK should be consistent with the source server. For certification of JAVA on Power7 server, please review the references section for additional details.
Oracle
The Oracle database version and patches should be consistent with the source server.
a) rootpre.sh
rootpre.sh script is required to be run as a root user prior to invoking the Oracle Universal Installer (OUI) and the rapidwiz installer for apps. Depending on the Oracle & AIX versions, rootpre.sh prepares AIX system for Oracle installation. This script should be executed only once for multiple oracle homes/versions. Do not run the rootpre.sh if there is a newer release of Oracle database already installed on the system.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
b) 11.1.0.7 (11gR1) Patch 7893016 RMAN convert fails with ORA-600 c) 11.2.0.1(11gR2) Patch 7893016 RMAN convert fails with ORA-600
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Explicit cio mount option should only be used if there is a need for an external access (cp, dd, cpio) to the oracle data files after the database has been opened. It is beyond the scope of this document to discuss all other AIX/Oracle tuning topics, however this is covered in a document titled Oracle Architecture & Tuning on AIX and a link to this document is included in the Reference section.
32 32 32 32 32
512002 frags over space of 40012334 frags: space efficiency = 1.3% 2845 extents out of 512002 possible: sequentiality = 99.4%
The sequentiality % is more important than the space efficiency %. A high sequentiality % indicates that when a file is read, it won't be moving the actuator (a seek) much due to fragmentation.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX. Version 3, December 2010 Page No. 12
A high space efficiency indicates the file's pieces are all close together, but the file could be fragmented requiring lots of seeks to read it, but at least the actuator won't have to move far. The only way to defragment a fragmented file is to create a scratch file system and sequentially copy out the file and sequentially copy in again.
Applications tier migration. Applications tier migration is a sequence of steps. Do not change the order, or circumvent/ skip any step. Examine the log files generated by every step for any errors and rectify them prior to moving to the next step. Always keep the source database in read only mode or in a shut down state until the applications migration is completed. It has been observed that if the source database is open it can be potentially updated by the target migration steps due any user error in the migration process.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Database Migration
Open Database in READ ONLY mode
The first step is to open the database in READ ONLY mode as follows. Unless mentioned otherwise, all the steps mentioned below are to be performed on the source database server.
SQL> startup mount ORACLE instance started. Total System Global Area 4815060992 bytes Fixed Size 2077752 bytes Variable Size 905972680 bytes Database Buffers 3892314112 bytes Redo Buffers 14696448 bytes Database mounted. SQL> alter database open read only; Database altered. SQL>
Verify Portability
The next step is to verify the portability of the database by running the following SQL script which uses the DMS_TDB.CHECK_DB function. If the database is not transportable the SQL script will give an error message.
SET SERVEROUTPUT ON DECLARE db_ready BOOLEAN; BEGIN db_ready := DBMS_TDB.CHECK_DB('AIX-Based Systems (64-bit)'); END; / PL/SQL procedure successfully completed.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Edit script
Edit the trace file which was generated earlier to create the control file. The trace generates two SQL statements for the creating the control file. For the purpose of migration we will use the section of RESETLOGS (usually set #2 in the file). Edit the path to reflect the locations of the data files on the target server. Delete all the other lines. The contents of your file would be similar as follows :
STARTUP NOMOUNT PFILE='/oracle/db/10gr2/dbs/initPROD.ora' CREATE CONTROLFILE REUSE SET DATABASE "VIS" RESETLOGS NOARCHIVELOG MAXLOGFILES 32 MAXLOGMEMBERS 5 MAXDATAFILES 512 MAXINSTANCES 8 MAXLOGHISTORY 3635 LOGFILE GROUP 1 '/oracle/oradata/log1.dbf' SIZE 7999M, GROUP 2 '/oracle/oradata/log2.dbf' SIZE 7999M DATAFILE '/oracle/oradata/sys1.dbf', '/oracle/oradata/sys2.dbf', '/oracle/oradata/sys3.dbf', . . . '/oracle/oradata/reference10.dbf', '/oracle/oradata/undo07.dbf', '/oracle/oradata/undo08.dbf', '/oracle/oradata/undo09.dbf', '/oracle/oradata/sys8.dbf', '/oracle/oradata/sys9.dbf', '/oracle/oradata/apps_assm_data.dbf', '/oracle/oradata/apps_assm_idx.dbf' CHARACTER SET UTF8; spool off
After editing, copy this script to the target server for later use. The source database can be either shut down or left in a read-only mode.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
$cat datafile1.rman RUN { CONVERT DATAFILE '/oracle/oradata/system01.dbf' FROM PLATFORM 'Solaris[tm] OE (64-bit)' FORMAT '/oradata_new/system01.dbf; } EXIT; $cat datafile2.rman RUN { CONVERT DATAFILE '/oracle/oradata/system02.dbf' FROM PLATFORM 'Solaris[tm] OE (64-bit)' FORMAT '/oradata_new/system02.dbf; } EXIT; $ cat parallel_convert.sh #!/bin/ksh rman target=/ @datafile1.rman log=datafile1.log & rman target=/ @datafile2.rman log=datafile2.log & rman target=/ @datafile3.rman log=datafile3.log & wait $ rman target=/ @datafile4.rman log=datafile4.log &
..
In the above example the datafile1.rman and datafile2.rman represent scripts for individual files to be converted. The shell script parallel_convert.sh starts the RMAN command in background mode and waits until the third data file conversion is completed before it starts another set of data file conversions. Depending on the CPU utilization the wait statement can be put after two or four data files. In this way we can convert multiple data files.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
The database migration is complete, however before the database can be used, there are a few additional tasks need to be completed.
a)
Create the temporary table space as sized on the source database server
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX. Version 3, December 2010 Page No. 18
SQL> create temporary tablespace temp_table_space_name SQL> tempfile '/xxx/temp.dbf' size 32m autoextend on SQL> extent management local;
b)
External Objects
Use export / import, Data Pump or recreate the external objects on target database server.
c)
Using SQLPLUS login as sqldba and compile the invalid objects using the
d)
Copy the listener.ora from the source database server and make necessary editing to reflect the target hostname and the oracle home. Start the database listener.
From the <10g ORACLE_HOME/appsutil/bin> directory, create an instance-specific XML context file by executing the command:
$ perl adbldxml.pl tier=db appsuser=<userid> appspasswd=<password>
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
From the <10g ORACLE_HOME>/appsutil/bin directory, execute AutoConfig on the database tier by running the adconfig.pl script. Check the AutoConfig log file located in <10g ORACLE_HOME>/appsutil/log/
The database migration is now complete. Its advisable to take a cold backup of the database at this point in time.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Go to http://updates.oracle.com/PlatformMigration and login using the My Oracle support user id and password. Follow the instructions on the screen to upload the manifest file previously generated. An email is sent out in 30 minutes with details on how to download the migration patch. If an email notification does not arrive in thirty minutes or so, login to the same site and download the patch.
Where <JAVA HOME> - absolute path where JDK is installed <source context file> - absolute path pointing to copied source system applications XML context file located in APPL_TOP/admin
The clone context tool will ask for all the new mount points, port information for the target migration node. This will create the target system context file in APPL_TOP/admin/<SID>_<hostname>.xml.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
AutoConfig Setup
This is the most important step in the entire cloning process of the apps tier node. This step populates the target database server with all the relevant target apps server information and uses the applications context file generated earlier. Anything wrong information in the applications context file can potentially update the source database server hence the source database should be either shut down or be in the read only mode. Prior to running this command it is advisable to use the grep command on the applications context file and check values on the target host for s_dbhost, s_dbsid, s_dbport. This command will also create the apps environment file.
$./adconfig.sh run=INSTE8_SETUP context_file=<target system contextfile>
Note. Ignore any adident executable errors as this executable is still an Solaris/HP executable at this point. Exit out form the telnet session, login back and source the newly generated environment file. Verify that /usr/vaccp/bin in included in $PATH.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
for top_name in `ls $APPL_TOP` do if [ -d $APPL_TOP/$top_name/11.5.0/lib ]; then cd $APPL_TOP/$top_name/11.5.0/lib rm *.o rm *.a ar rv lib$top_name.a fi done $. /adpatch options=noprereq uses the adpatch provided by the migration patch
Note: Executables dependent on third party products (Ilog, Roguewave, and Quantum) might fail during relinking. This is expected and is addressed in "Section 14: Finishing Tasks". In that case, answer "yes" when adpatch asks whether to "Continue as if it were successful". Shared top binaries do not get relinked and need to be relinked manually:
$ adrelink.sh force=y crp CYCPLN $ adrelink.sh force=y crp CYCCRP $ adrelink.sh force=y crp CYRRCP $ adrelink.sh force=y crp CYQLIB $ adrelink.sh force=y crp CYCROL
Run adadmin to generate messages, forms, reports, graphics and jar files.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
AutoConfig
Run adconfig.sh to update the database.
$ $AD_TOP/bin/adconfig.sh contextfile=<Target System context file>
Finishing Tasks
The entire task list mentioned in this section is optional depending on your specific environment.
Column Name
TEXT_VALUE TEXT_VALUE GUID NAME ADDRESS
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Update it to new web hostname Update it to new plsql listener name Update correct logfile directory path Update with new directory path
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Review the logs of all the services. After verification, backup the entire applications file systems. Note. If the concurrent managers fail to start up, from the sql prompt execute the fnd_conc_clone.setup_clean and re-run adautocfg. This step will clean up the FND_NODES table and will enable the concurrent manager to start up.
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle 11i E-Business Suite Cross Platform Migration to AIX.
Summary
Transition to a new architecture is an expensive proposition. In order to be successful, proper planning is the key for all Oracle platform migration projects. Its important to identify and line up all resources prior to execution. Every migration exercise is different and hence multiple mock migrations are essential to a successful transition as they provide an opportunity to tune the migration. Oracle Transportable Database certainly helps in migrating complex databases. The introduction of Transportable Database provides a highly performing and straightforward migration technology than earlier Export/Import or Data Pump options. However some infrastructure challenges remain as an obstacle for faster cross platform migration. Transferring large data files from source to target via the network can take time. This can be challenging for very large database sizes which can run into multiple terrabytes. Technologies like VERITAS Portable Data Containers can be utilized to overcome moving the data files. This concludes the topics for this document. Please refer to the listings in the References section for sources of additional information on questions that you may have,
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle Database Cross Platform Migration to AIX.
Acknowledgements
Several people provided technical input and guidance for this paper including: Peter Barnett Dan Braden Timothy Spencer Stephen Poon
IBM Copyright, 2007 http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101174 Oracle Database Cross Platform Migration to AIX.