Page 1 of 10

">

How to run OATM migration utility [ID 404954.1] Modified 23-OCT-2011 In this Document Goal Solution 1- Review OATM Model for Oracle Applications 11i 2- Install OATM migration utility 3- Run OATM migration utility 4- Parameters needed while starting OATM utility 5- OATM Menu Structure 6- Additional Post Migration Steps References Type HOWTO Status PUBLISHED

Applies to:
Oracle Application Object Library - Version: 11.5.9 to 11.5.10.2 - Release: 11.5 to 11.5 Information in this document applies to any platform.

Goal
1- Review OATM Model for Oracle Applications 11i 2- Install OATM migration utility 3- Run OATM migration utility 4- Parameters needed while starting OATM utility 5- OATM Menu Structure 6- Additional Post Migration Steps

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 2 of 10

Solution 1- Review OATM Model for Oracle Applications 11i

The Oracle Applications Tablespace Model (OATM) introduces a new, consolidated tablespace model in Oracle Applications, that uses 12 locally managed tablespaces for all products, including the temporary tablespace, system tablespace, and undo segments. In this revised Oracle Applications Tablespace Model, each Oracle Applications database object is mapped to a tablespace based on its Input/Output characteristics. This new model allows for easier maintenance, reduces space usage, and allows for potential run-time performance gains. The Oracle Applications Tablespace Migration Utility is an interactive menu-based PERL program including a set of sizing estimate reports. It enables customers to convert their Oracle Applications databases to the new tablespace model (OATM) for either all schemas at once or partially for select schema(s) at a time, depending on acceptable down time and available disk space. You can find more information about OATM migration utility in the following note: Note 248857.1 - Oracle Applications Tablespace Model Release 11i - Tablespace Migration Utility Also please refer to Oracle Documentation: http://download-uk.oracle.com/docs/cd/B25516_14/current/acrobat/115sacg.zip Oracle Applications System Administrator's Guide - Configuration B13925-06 Chapter 3 - Oracle Applications Tablespace Model and Migration Utility Page 67

2- Install OATM migration utility

You can install the OATM migration utility by downloading & applying the following patch through Metalink: Patch 3942506 - AOL/FND: OATM MIGRATION UTILITY ROLLUP C (Note: Above patch is already included in 11.5.10 and higher, so if you have Oracle Applications 11.5.10 or higher you do not need to install it)

3- Run OATM migration utility

After installing the utility through above patch , please use the following command in order to start running the utility:
perl $FND_TOP/bin/fndtsmig.pl

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 3 of 10

WARNING: When running OATM tool, please don't migrate CTXSYS schema to the default APPS_TS_TX_DATA tablespace as this will prevent you from implementing the following feature: Note 454574.1 - Cross Platform Transportable Tablespaces on 11i with 10gR2 Accordingly you should leave CTXSYS into it's own tablespace as a default database schema.

Important Note: When Moving a queue table on a RAC database, you should do following steps: a- Shutdown all instances except the one doing the MOVE operation. b- Limit any access to the instance doing the move. c- Stop all AQ related processes on the instance doing the move (eg; aq_tm_processes=0) d- After the moves are complete, development team recommend to flush the shared pool. Given that this is not guaranteed to flush the queue objects it would seem safest to replace the flush with an instance bounce to be sure that there is no stale information in the SGA.

4- Parameters needed while starting OATM utility

After running the PERL script in order to start the OATM utility, the following parameters screen will appear:
+=======================================================================+ | Copyright (c) 2003 Oracle Corporation Redwood Shores, California, USA| | All rights reserved. | +=======================================================================+ | | | Welcome to the Oracle Applications Tablespace Migration Utility | | | +=======================================================================+ | | | Warning: If DB was upgraded from 8.1.7 to a version prior to 9.2.0.6 | | please run $FND_TOP/patch/115/sql/fndupglb.sql before the migration. | | | +=======================================================================+

Enter OATM configuration file or press enter to continue:

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 4 of 10

Enter APPL_TOP[/u01/applmgr/olc510appl]:

Enter FND_TOP[/u01/applmgr/olc510appl/fnd/11.5.0]:

Enter the Database Connect String[OLC510]:

Enter the password for your 'SYSTEM' ORACLE schema:

Successfully connected to database OLC510 using SYSTEM user.

Enter the ORACLE APPS Schema name[APPS]: apps

Enter the password for APPS:

Successfully connected to database OLC510 using APPS user.

Enter the ORACLE Application Object Library Schema name[APPLSYS]: applsys ================================================================ CONNECT_STRING =OLC510 FND_TOP =/u01/applmgr/olc510appl/fnd/11.5.0 APPLSYS_SCHEMA =APPLSYS APPS_SCHEMA =APPS APPL_TOP =/u01/applmgr/olc510appl ================================================================

Please review and press 'Y' to accept or 'N' to re-enter[Y]: y

Performing database check...

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 5 of 10

Database check completed.

Checking required components...

Required components check completed.

5- OATM Menu Structure

After providing all parameters as in the previous step, you will get the Main Menu for Oracle Applications Tablespace Migration Utility which consists of 8 options as following: Important Note: Some Menu Options are available only on 11.5.10.2 and later such as: Migrate CTXSYS Schema, Generate script to drop empty tablespaces. Oracle Applications Tablespace Migration Utility Main Menu

1. 2. 3. 4. 5. 6. 7. 8.

Migration Sizing Reports Create New Tablespaces Generate Migration Commands Execute Migration Commands Run Migration Status Reports Run Post Migration Steps Run Customization Steps Run Migration in Batch Mode

[Q]uit

[N]ext

Please enter your option Here are the details for each menu option: 5.1. Migration Sizing Reports

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 6 of 10

Migration Sizing Reports These reports are provided to help you gauge the space requirements for the new Tablespaces. Additionally, they will also help you determine the type of migration approach that best suits your needs 1. Generate a Report with the list of all the Oracle Application product schemas that can be migrated 2. Calculate total space required by each new tablespace to migrate all Oracle Application product schemas (relevant for a complete migration) 3. Calculate total space required by each new tablespace to migrate each Oracle Application product schema (relevant for a schema-by-schema migration) 4. Calculate total space required by each Oracle Applications schema, with details for each object 5. Display Sizing Exception report [Q]uit [B]ack [N]ext Please enter your option -

5.2. Create New Tablespaces

Create New Tablespaces 1. Generate new tablespace creation script 2. Create new tablespaces [Q]uit [B]ack [N]ext Please enter your option -

5.3. Generate Migration Commands

Generate Migration Commands Generation of Migration commands including disable/enable commands for triggers, constraints, policies, stop/start for queues. 1. Invalid Indexes Report. Please correct/drop these before

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 7 of 10

generating migration commands 2. Generate migration commands for all schemas 3. Generate migration commands for a list of schemas [Q]uit [B]ack [N]ext Please enter your option -

5.4. Execute Migration Commands

Execute Migration Commands Execution of Migration commands including disable commands for triggers constraints, stop/start for queues. PLEASE TAKE A COMPLETE BACKUP OF THE DATABASE BEFORE MIGRATION 1. Migrate all Schemas 2. Migrate a list of Schemas 3. Migrate CTXSYS Schema Note: Migrate CTXSYS schema when no other migration process is in progress. [Q]uit [B]ack [N]ext Please enter your option -

5.5. Run Migration Status Reports

Run Migration Status Reports 1. Run migration progress report 2. Run migration error report [Q]uit [B]ack [N]ext Please enter your option -

5.6. Run Post Migration Steps

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 8 of 10

Run Post Migration Steps 1. 2. 3. 4. Run audit report Enable constraints/triggers/policies & start queues Resize old tablespaces Generate script to drop empty tablespaces

Note: Please complete refresh all the Materialized Views in Oracle Applications before using the system. [Q]uit [B]ack Please enter your option -

5.7. Customization
Customization 1. 2. 3. 4. Register new tablespace - tablespace type Change name of the existing tablespace Register object classification Change object classification

[Q]uit [B]ack Please enter your option -

5.8. Batch Mode Migration

Batch Mode Migration 1. Run Migration in Batch Mode 2. Run Migration Monitor

[Q]uit [B]ack Please enter your option -

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 9 of 10

6- Additional Post Migration Steps

After running OATM utility it may happen that some tables can change the orders of the columns, this can cause the following Oracle Error (ORA-00932) in some core forms. So it is recommended if you face such a situation to use (adadmin) utilities to compile all forms for Oracle Applications.

Important Note: Only for customers who are using DB spfile, please make sure to use "Alter System ..." SQL command to set "aq_tm_processess=1" otherwise you might face a problems in AQ tables related to WF.

References
NOTE:248857.1 - Oracle Applications Tablespace Model Release 11i - Tablespace Migration Utility PATCH:3942506 - AOL/FND: OATM MIGRATION UTILITY ROLLUP C http://download-uk.oracle.com/docs/cd/B25516_14/current/acrobat/115sacg.zip

Related

Products Oracle E-Business Suite > Applications Technology > Application Object Library > Oracle Application Object Library Errors ORA-932

Back to top

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012

Page 10 of 10

Copyright (c) 2007, 2010, Oracle. All rights reserved. Legal Notices and Terms of Use | Privacy Statement

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=HOWTO&id=404954.1&addClickInfo=<data search_text...

1/19/2012