Migrating Oracle9ias Containers for J2EE
Total Page:16
File Type:pdf, Size:1020Kb
Oracle9i Application Server Migrating from Oracle9iAS Release 1 (1.0.2.2.x) to Release 2 (9.0.2) Release 2 (9.0.2) for AIX-Based Systems, hp-ux PA-RISC (64-bit), hp Tru64 UNIX, and Linux x86 Part No. A97298-02 November, 2003 Oracle9i Application Server Migrating from Oracle9iAS Release 1 (1.0.2.2.x) to Release 2 (9.0.2), Release 2 (9.0.2) for AIX-Based Systems, hp-ux PA-RISC (64-bit), hp Tru64 UNIX, and Linux x86 Part No. A97298-02 Copyright © 2002, 2003 Oracle Corporation. All rights reserved. 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, except to the extent required to obtain interoperability with other independently created software or as specified by law, 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 OracleMetaLink, Oracle Store, Oracle9i, Oracle9iAS Discoverer, SQL*Plus, and PL/SQL are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners. Contents Send Us Your Comments .................................................................................................................. xiii Preface........................................................................................................................................................... xv Audience ................................................................................................................................................ xv Organization.......................................................................................................................................... xv Related Documentation ...................................................................................................................... xvi Conventions......................................................................................................................................... xvii Documentation Accessibility ............................................................................................................. xix 1 Overview of Oracle9iAS Migration Migration Scope and Methods......................................................................................................... 1-1 Identifying Source and Target Oracle9iAS Installations......................................................... 1-1 Migration Paths................................................................................................................................... 1-2 Components and Installation Types.......................................................................................... 1-2 Oracle9iAS Release 1 and Release 2 Installation Types .......................................................... 1-4 Components Requiring Database Migration.......................................................................... 1-11 Component Interdependencies ................................................................................................ 1-11 Preparing to Migrate ........................................................................................................................ 1-14 How To Use This Guide .................................................................................................................. 1-14 2 Using the Oracle9iAS Migration Assistant Understanding the Migration Assistant......................................................................................... 2-2 The Oracle HTTP Server Migration Process............................................................................. 2-2 Oracle HTTP Server Migration Candidates ...................................................................... 2-3 iii Default modules ............................................................................................................. 2-4 Default Directives in httpd.conf................................................................................... 2-5 HTTP Server Elements Not Migrated................................................................................. 2-6 The HTTP Server Directive Migration Process ................................................................. 2-7 Migration of SSL Settings.............................................................................................. 2-8 Backup and Auditing Measures for Oracle HTTP Server Migration .......................... 2-10 The Oracle9iAS Containers for J2EE (OC4J) Migration Process .......................................... 2-10 OC4J Migration Candidates............................................................................................... 2-11 Standalone OC4J Instances and Migration ...................................................................... 2-11 The OC4J Configuration File Migration Process............................................................. 2-11 J2EE Compliance Requirements for OC4J Migration..................................................... 2-12 Validating EAR Files for J2EE Compliance .............................................................. 2-12 Backup and Auditing Measures for OC4J Migration..................................................... 2-13 The Oracle9iAS Web Cache Migration Process...................................................................... 2-14 Web Cache Migration Candidates .................................................................................... 2-14 Migration of Session Definitions................................................................................ 2-14 The Web Cache Migration Process ................................................................................... 2-15 Backup and Auditing Measures for Web Cache Migration .......................................... 2-17 Installing the Migration Assistant................................................................................................. 2-17 Hardware Requirements ........................................................................................................... 2-17 Software Requirements............................................................................................................. 2-17 Operating System Requirements.............................................................................................. 2-17 Starting Oracle Universal Installer........................................................................................... 2-21 Migrating Applications ................................................................................................................... 2-27 Preparing to Migrate .................................................................................................................. 2-27 Information Requirements ................................................................................................. 2-28 SSL Configuration Requirements...................................................................................... 2-28 Using the Oracle9iAS Migration Assistant (GUI Version) ................................................... 2-28 Using the Oracle9iAS Migration Assistant (Command Line Version) ............................... 2-36 Completing the Web Cache Migration.................................................................................... 2-39 Restarting the Oracle9iAS Migration Assistant.......................................................................... 2-40 3 Migrating Internet Applications Components Migrating Oracle9iAS Containers for J2EE ..................................................................................