Oracle® Applications
Maintaining Oracle Applications
Release 11i
January 2001 Part No. A87339-01 Oracle Applications, Maintaining Oracle Applications, Release 11i
Part No. A87339-01
Release 11i
Copyright © 1996, 2000, 2001 Oracle Corporation. All rights reserved.
Primary Author: Yun Shaw
Contributing Authors: Subash Chadalavada, Michael Cole, Carole Eubanks, Michael Fiore, Billy Greene, Rick Lotero, Kent Noble, Roger Sanders
Program Documentation is licensed for use solely to support the deployment of the Programs and not for any other purposes.
The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited.
The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation.
If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable:
Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs.
Oracle is a registered trademark, and Context, EMM Advantage, Net8, Oracle Alert, Oracle Application Object Library, Oracle Financials, OracleMetaLink, Oracle Quality, Oracle Web Customers, Oracle Web Employees, Oracle Work in Process, Oracle Workflow, Oracle8, Oracle8i, PL/SQL, SmartClient, SQL, SQL*Net, SQL*Plus, and SQL*Report are trademark[s] or registered trademark[s] of Oracle Corporation. Other names may be trademarks of their respective owners. Contents
Send Us Your Comments ...... ix
Preface...... xi Audience...... xi Structure ...... xii Information for Windows NT Users ...... xiii Software Requirements...... xiii Registry Variables and Environment Variables...... xiii Conventions...... xiv Getting Help ...... xv Oracle Consulting Services ...... xv Oracle Support Services...... xv Related Documents ...... xvi
1 About AD Utilities What Are the AD Utilities?...... 1-1 AD Administration (adadmin or adadmin.exe) ...... 1-1 AutoUpgrade (adaimgr or adaimgr.exe) ...... 1-2 AutoPatch (adpatch or adpatch.exe) ...... 1-3 AD Controller (adctrl or adctrl.exe)...... 1-3 AD Configuration (adutconf.sql) ...... 1-3 AD File Identification (adident or adident.exe) ...... 1-4 AD Splicer (adsplice or adsplice.exe) ...... 1-4 File Character Set Conversion (adncnv or adncnv.exe)...... 1-4
iii ODF Comparison (adodfcmp or adodfcmp.exe) ...... 1-4 AD Relink (adrelink.sh) ...... 1-4 AD Merge Patch (admrgpch or admrgpch.exe)...... 1-4 DataMerge (addmimp or addmimp.exe) ...... 1-5 AD Run SQL (adurs or adurs.exe) ...... 1-5 AD Rebase (adrebase.exe) ...... 1-5 Verify Apps (advrfapp.sql) ...... 1-5 License Manager (LicenseMgr)...... 1-5 How They Work ...... 1-5 Running AD Utilities...... 1-6 Getting Ready...... 1-6 Stopping and Restarting ...... 1-8 Responding to Prompts ...... 1-9 Configuration and Environment Files...... 1-15 Creating an Environment File...... 1-15 AD Timing Report ...... 1-20
2 AD Administration What is AD Administration? ...... 2-1 Database Tasks...... 2-1 File System Tasks...... 2-2 Running AD Administration Interactively ...... 2-2 Using the Main Menu ...... 2-3 Running AD Administration in Non-Interactive Mode ...... 2-17
3 AutoUpgrade What is AutoUpgrade?...... 3-1 Using AutoUpgrade ...... 3-2 How AutoUpgrade Works ...... 3-2 Running AutoUpgrade in a Multi-server Environment ...... 3-3 Running AutoUpgrade ...... 3-3 Starting and Stopping AutoUpgrade...... 3-4 Responding to Prompts ...... 3-4 Restarting AutoUpgrade ...... 3-5 Using AutoUpgrade Menus and Screens ...... 3-7
iv Main Menu ...... 3-7 About the AutoUpgrade Screens ...... 3-8 Select Products Screen ...... 3-9 Product Detail Screens...... 3-13 Select Modules Screen...... 3-13 Database Parameters Screen ...... 3-15 Tasks Screen ...... 3-19 Running the Upgrade...... 3-24 Monitoring AutoUpgrade ...... 3-26 Manager and Worker Messages ...... 3-26 Log and Restart Files...... 3-27 Correcting AutoUpgrade Errors ...... 3-29 Acceptable Errors ...... 3-31 After Running AutoUpgrade...... 3-34
4 AutoPatch What is AutoPatch?...... 4-1 How It Works...... 4-2 Patch Format ...... 4-5 Running AutoPatch...... 4-7 Starting AutoPatch...... 4-8 Responding to Prompts ...... 4-9 AutoPatch Messages ...... 4-11 After Running AutoPatch ...... 4-14 Running AutoPatch Again...... 4-17 Controlling AutoPatch Behavior ...... 4-19 Test Mode ...... 4-19 Pre-install Mode...... 4-20 Non-interactive Mode...... 4-21 Using the options Parameter ...... 4-25 Using the AD Merge Patch Utility ...... 4-26 Patch Driver Files ...... 4-27 Patch History File ...... 4-30 Patch Summary File ...... 4-32 Adding Translations...... 4-32
v Applying Java Patches ...... 4-32 Java Release Infrastructure...... 4-36
5 Other AD Utilities AD Controller (adctrl) ...... 5-2 Log File...... 5-3 Reviewing Worker Status...... 5-3 Restarting a Failed Worker...... 5-4 Restarting a Terminated Worker...... 5-5 Reactivating the Manager...... 5-6 Shutting Down the Managers ...... 5-6 Controlling the Number of Workers...... 5-7 AD Configuration (adutconf.sql)...... 5-7 AD File Identification (adident) ...... 5-8 AD Splicer (adsplice) ...... 5-9 Splicing New Products...... 5-9 Editing newprod.txt ...... 5-11 File Character Set Conversion (adncnv) ...... 5-13 ODF Comparison (adodfcmp) ...... 5-14 Running ODF Comparison ...... 5-14 AD Relink (adrelink.sh) ...... 5-19 Running adrelink.sh...... 5-20 Relinking with Debug ...... 5-23 Target File ...... 5-23 Backup Options for adrelink.sh...... 5-25 DataMerge (addmimp)...... 5-26 AD Run SQL (adurs) ...... 5-28 AD Rebase (adrebase.exe) ...... 5-29 License Manager (LicenseMgr) ...... 5-30
6 Maintaining the Applications Database Analyzing the Database...... 6-1 Pinning Packages and Sequences...... 6-2 Changing Oracle Applications Passwords...... 6-4 Migrating the Oracle Applications Database...... 6-5
vi Preparing to Migrate the Database ...... 6-7 Export the Oracle Database...... 6-12 Import the Oracle Database ...... 6-14 Finishing the Migration ...... 6-16 Database Initialization Parameters ...... 6-20 General init.ora Parameters ...... 6-20 Fixed SGA init.ora Parameters ...... 6-24 Cost-Based Optimization (CBO) init.ora Parameters...... 6-26 Special Features...... 6-30 Rollback Segments ...... 6-31 Product Tablespace Requirements ...... 6-32
7 Maintaining the Applications File System Migrating the Oracle Applications File System ...... 7-1 Moving Files on the Same Machine ...... 7-1 Preparing to Migrate the File System to Another Machine...... 7-4 Unload Oracle Applications Product Files ...... 7-4 Completing the Migration...... 7-4 Recovering Disk Space ...... 7-5 Server Processes ...... 7-7 Starting Server Processes...... 7-7 Reserved Words...... 7-11 Index
vii viii Send Us Your Comments
Oracle Applications, Maintaining Oracle Applications, Release 11i Part No. A87339-01
We welcome your comments and suggestions on the quality and usefulness of this publication. Your input is an important part of the information used for revision.