Click here to load reader

Migrating from Oracle Application Server Release 1 · PDF fileMigrating from Oracle Application Server ... Oracle Internet Application Server Migrating from Oracle Application Server,

  • View
    217

  • Download
    2

Embed Size (px)

Text of Migrating from Oracle Application Server Release 1 · PDF fileMigrating from Oracle...

  • Oracle Internet Application Server 8i

    Migrating from Oracle Application Server

    Release 1.0

    June, 2000

    Part No. A83709-01

  • Oracle Internet Application Server Migrating from Oracle Application Server, Release 1.0

    Part No. A83709-01

    Copyright 2000, Oracle Corporation. All rights reserved.

    The Programs (which include both the software and documentation) contain proprietary information ofOracle Corporation; they are provided under a license agreement containing restrictions on use anddisclosure and are also protected by copyright, patent, and other intellectual and industrial propertylaws. 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 problemsin the documentation, please report them to us in writing. Oracle Corporation does not warrant that thisdocument is error free. Except as may be expressly permitted in your license agreement for thesePrograms, 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 onbehalf of the U.S. Government, the following notice is applicable:

    Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercialcomputer 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 computersoftware" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500Oracle Parkway, Redwood City, CA 94065.

    The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherentlydangerous 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 forsuch purposes, and Oracle Corporation disclaims liability for any damages caused by such use of thePrograms.

    Oracle is a registered trademark, and the Oracle Logo, Internet Application Server, Oracle8i, OracleEnterprise Manager, Oracle Internet Directory, and PL/SQL are trademarks or registered trademarks ofOracle Corporation. All other company or product names mentioned are used for identification purposesonly and may be trademarks of their respective owners.

    This product includes software developed by the Apache Group for use in the Apache HTTP serverproject (http://www.apache.org/).

  • Contents

    Preface............................................................................................................................................................ ix

    Audience ................................................................................................................................................. ixConventions............................................................................................................................................ ixOracle Services and Support ................................................................................................................. x

    1 Introduction to Oracle Internet Application Server

    What is Oracle Internet Application Server? ................................................................................ 1-2OAS and Oracle Internet Application Server Components ....................................................... 1-2Enterprise Services Migration .......................................................................................................... 1-2

    Overview........................................................................................................................................ 1-3Scalability....................................................................................................................................... 1-3Availability and Fault Tolerance ................................................................................................ 1-4Load Balancing.............................................................................................................................. 1-4Administration.............................................................................................................................. 1-5Security........................................................................................................................................... 1-5

    2 Migrating JWeb Applications to Apache JServ

    What is Apache JServ? ....................................................................................................................... 2-1Migrating OAS JServlets to Apache........................................................................................... 2-1

    JWEB and Apache JServ 1.1 Differences ........................................................................................ 2-2Architecture ................................................................................................................................... 2-2Life cycle ........................................................................................................................................ 2-5Threading....................................................................................................................................... 2-6Sessions .......................................................................................................................................... 2-6

    iii

  • Dynamic Content Generation in HTML Pages ........................................................................ 2-6Code Modifications for JWEB Applications .................................................................................. 2-7

    Session Control.............................................................................................................................. 2-7Application Threads..................................................................................................................... 2-8Logging........................................................................................................................................... 2-8

    3 Migrating OAS Cartridges to Apache Modules

    Cartridge Types and Corresponding Apache Modules ............................................................... 3-1PL/SQL Migration............................................................................................................................... 3-2

    File Upload/Download ............................................................................................................... 3-2Uploaded File Document Format............................................................................................... 3-3Using the oas2ias Tool.................................................................................................................. 3-4Custom Authentication................................................................................................................ 3-6Positional Parameter Passing Scheme ....................................................................................... 3-6Executing SQL Files...................................................................................................................... 3-6

    Perl Migration...................................................................................................................................... 3-7Perl Applications under OAS ..................................................................................................... 3-7Migrating Perl Cartridge Scripts from OAS to Oracle Internet Application Server ........... 3-8Variations from OAS Perl Cartridge.......................................................................................... 3-9

    LiveHTML Migration....................................................................................................................... 3-10SSI.................................................................................................................................................. 3-10Scripts ........................................................................................................................................... 3-11

    4 Migrating EJB, ECO/Java and JCORBA Applications

    Migrating EJBs..................................................................................................................................... 4-1Deployment Descriptors.............................................................................................................. 4-1Client Code .................................................................................................................................... 4-3Logging (Server Code) ................................................................................................................. 4-3

    Migrating ECO/Java ........................................................................................................................... 4-4Remote Interface ........................................................................................................................... 4-4Home Interface.............................................................................................................................. 4-4Implementation Class ...................................