Oracle® Application Server 10g

Quick Installation and Upgrade Guide

10g (9.0.4) for hp HP-UX PA-RISC (64-bit)

Part No. B10843-02

December 2003

1 Introduction

Oracle recommends reviewing the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g Release Notes before installing Oracle Application Server in a production environment or if there is an existing Oracle software installation on the computer

This Oracle Application Server Quick Installation Guide describes procedures for installation for the following Oracle Application Server installation types:

• J2EE and Web Cache

• Portal and Wireless

Table 1 shows the contents of the Oracle Application Server Quick Installation Guide:

Table 1 Content of This Guide  

2 Requirements

This section describes pre-installation requirements for installation of Oracle Application Server. Oracle recommends that you review and complete the tasks listed in the following sections:

• Section 2.1, "Check Hardware Requirements"

• Section 2.2, "Check Software Requirements"

• Section 2.3, "Create an Inventory Directory Group"

• Section 2.4, "Create Database Groups"

• Section 2.5, "Create an Operating System User"

• Section 2.6, "Check Environment Variables"

• Section 2.7, "Check Kernel Parameters"

• Section 2.8, "Check Port Use"

• Section 2.9, "Mounting Your CD-ROM or DVD"

• Section 2.10, "Starting up the Installer"

2.1 Check Hardware Requirements

Check that your computer has a 64-bit HP-UX PA-RISC processor (Oracle recommends a 240 MHz or better processor) and meets the following disk space and memory requirements:

The installer may display inaccurate disk space requirement figures. Refer to the figures listed above for disk space requirements.

1. To determine that the system architecture is 64-bit:

   # /bin/getconf KERNEL_BITS
   
   

2. To determine the physical RAM size, enter the following command:

   # /usr/sbin/dmesg | grep "Physical:"
   
   

3. To determine the amount of free disk space, enter the following command:

   prompt> bdf dir.
   
   

   Replace dir with the Oracle home directory or with the parent directory if the Oracle home directory does not exist yet. For example, if you plan to install Oracle Application Server in /opt/oracle/infra, you can replace dir with /opt/oracle or /opt/oracle/infra.

4. To determine the amount of available swap space, use the swapinfo command:

   # /usr/sbin/swapinfo -a
   
   

   If necessary, see your operating system documentation for information on how to configure additional swap space.

2.2 Check Software Requirements

Check that the following software is installed on the computer:

1. Check that one of the following versions of HP-UX is installed on the computer:
   • HP-UX 11.0 (64-bit)

   • HP-UX 11i (11.11) PA-RISC or higher

   To check the version of HP-UX, enter the following command:

   # uname -a
   
   

2. Verify that computer has the following operating system patches, or higher:

   Operating System	Required Patches (or higher version)
   HP-UX 11.0 (64-bit)	Sept 2002 Quality Pack (QPK1100 B.11.00.58.5) or higher PHKL_27813 s700_800 11.00 POSIX AIO;getdirentries; MVFS;rcp;mmap/IDS patch PHSS_26559 s700_800 11.00 ld(1) and linker tools cumulative patch
   HP-UX 11i (11.11) PA-RISC or higher	Dec 2001 Consolidate Patches (Dec01GQPK11i_Aux_Patch B.03.02.06) or higher PHKL_25212 vm preemption point, mlock/async_io patch PHKL_25506 asyncio driver patch PHKL_27091 s700_800 11.11 Core PM, vPar, Psets Cumulative, slpq1 perf patch PHKL_28267 s700_800 11.11 thread perf, user limit, cumulative VM PHNE_28089 s700_800 11.11 cumulative ARPA Transport patch PHSS_24638 s700_800 11.11 HP aC++ -AA runtime libraries (aCCA.03.33) PHSS_26263 s700_800 11.11 ld(1) and linker tools cumulative patch PHSS_26792 s700_800 11.X ANSI C compiler B.11.11.04 cumulative patch PHSS_26793 s700_800 11.X +O4/PBO Compiler B.11.11.04cumulative patch

   1. To determine whether a Quality Pack is installed, enter the following command:

      # /usr/sbin/swlist | grep QPK
      
      

      If the quality pack is not installed, download it from the following URL and install it:

      http://www.software.hp.com/SUPPORT_PLUS/qpk.html
      
      

   2. To determine whether a patch is installed, enter a command similar to the following:

      # /usr/sbin/swlist -l patch | grep PHKL_27813
      
      

      Alternatively, to list all installed patches, enter the following command:

      # /usr/sbin/swlist -l patch | more
      
      

      If a required patch is not installed, download it from the following URL and install it:

      http://itresourcecenter.hp.com
      
      

3. Determine whether JDK 1.4.1.05 or higher is installed by entering the following command:

   # JDK_location/bin/java -fullversion
   
   

   If the version displayed is less than 1.4.1.05, download JDK 1.4.1.05 or higher from the following Web site and install it:

   http://www.hp.com/products1/unix/java/index.html
   
   

4. Make sure that all patches required for JDK 1.4.1.05 are installed. This list is constantly under review and is published on the JDK download page on the HP web site.

5. Check that Motif 2.1 is installed:
   • On HP-UX 11.0 (64-bit) check that Motif 2.1 Development Environment X11MotifDevKit.MOTIF21-PRG:B.11.00.01 is installed.

   • On HP-UX 11i (11.11) check that Motif 2.1 Development Environment (X11MotifDevKit.MOTIF21-PRG) B.11.11.01 is installed.

   If this package is not installed on the computer, create the following symbolic links:

   1. Log in as root.

   2. Change to the /usr/lib directory:

      # cd /usr/lib
      
      

   3. Create the required links:

      # ln -s libX11.3 libX11.sl
      # ln -s libXIE.2 libXIE.sl
      # ln -s libXext.3 libXext.sl
      # ln -s libXhp11.3 libXhp11.sl
      # ln -s libXi.3 libXi.sl
      # ln -s libXm.4 libXm.sl
      # ln -s libXp.2 libXp.sl
      # ln -s libXt.3 libXt.sl
      # ln -s libXtst.2 libXtst.sl
      

2.3 Create an Inventory Directory Group

Create a local operating system group to own the product files. You can use any name for the group, this guide uses the name oinstall. To create the oinstall group, enter the following as the root user:

# /usr/sbin/groupadd oinstall

For more information about operating system users and groups, see your operating system documentation or contact your system administrator.

2.4 Create Database Groups

This section applies only if you are installing the Portal and Wireless Developer Topology.

Create two groups dba and oper using the following commands:

# /usr/sbin/groupadd dba
# /usr/sbin/groupadd oper

2.5 Create an Operating System User

You can use any name for the user, this guide uses the name oracle. This user must belong to the oinstall operating system group.

If you installing a Portal and Wireless Developer topology you must also add this user to the dba and oper operating system groups.

To create the oracle operating system user for the Java Developer topology, enter the following command as the root user:

# /usr/sbin/useradd -g oinstall oracle

To create the oracle operating system user for the Portal and Wireless Developer topology, enter the following command as the root user:

# /usr/sbin/useradd -g oinstall -G dba,oper oracle

For more information about operating system users and groups, see your operating system documentation or contact your system administrator.

Set the password for the oracle user by entering the following command and follow the instructions on screen:

# passwd oracle

2.6 Check Environment Variables

Check the values of the environment variables shown in Table 2 when logged in as the oracle user.

Table 2 Environment Variables  

% setenv DISPLAY
machine1.acme.com:0.0

$ DISPLAY=machine1.acme.com:0.0;
export DISPLAY

% setenv TMP /tmp2
% setenv TMPDIR /tmp2

$ TMP=/tmp2; export TMP
$ TMPDIR=/tmp2; export TMPDIR

% echo $PATH

$ echo $PATH

% unsetenv TNS_ADMIN

$ unset TNS_ADMIN

% unsetenv ORA_NLS33

$ unset ORA_NLS33

2.7 Check Kernel Parameters

This section is applicable only if you are installing a Portal and Wireless Developer topology. You will be installing a database for the OracleAS Metadata Repository.

Check that the kernel parameters are set to the minimum values as shown in Table 3.

Table 3 Kernel Parameters for HP-UX  

To view the current value or formula specified for these kernel parameters, and to change them if necessary, follow these steps:

1. Optionally, set the DISPLAY environment variable to specify the display of the local system:

   For the Bourne, Bash, or Korn shell:

   $ DISPLAY=local_host:0.0 ; export DISPLAY
   

   For the C shell:

   $ setenv DISPLAY local_host:0.0
   

2. Start System Administration Manager (SAM):

   # /usr/sbin/sam
   
   

3. Choose the Kernel Configuration area, then choose the Configurable Parameters area.

4. Check the value or formula specified for each of these parameters and, if necessary, modify that value or formula.

   If necessary, see the SAM online help for more information on completing this step.

5. Exit from SAM.

6. If you modified the value specified for any parameter, reboot the system:

   # /sbin/shutdown -r now
   
   

7. If necessary, when the system restarts, log in and switch user to root.

8. Restart the computer for the new values to take effect.

2.8 Check Port Use

This section is applicable only if you are installing a Portal and Wireless Developer topology.

If you have other applications listening on port 1521, you may need to configure them so that they listen on a different port.

Verify whether port 1521 is in use by an application on your computer with the following command:

prompt> netstat -an | grep 1521

Review the output to verify if port 1521 is in use.

If port 1521 is in use by your OracleAS Metadata Repository, then you may share the port with your installation of Portal and Wireless. Refer to the Oracle Application Server 10g Installation Guide for documentation on sharing ports.

If port 1521 is in use by a third-party application, you need to configure the application to use a different port. Refer to the Oracle Application Server 10g Installation Guide or third-party documentation for information on sharing ports.

2.9 Mounting Your CD-ROM or DVD

Oracle CD-ROMs are in ISO 9660 format with Rockridge extensions. The DVD is in DVD-ROM format.

In the following instructions, the disc mount point is referred to as /SD_CDROM. If your mount point is different, substitute the correct mount point name for all references to /SD_CDROM.

To mount the disc:

1. Place the disc in the disc drive.

2. Create the /SD_CDROM directory if it does not already exist:

   /usr/bin/mkdir /SD_CDROM
   
   

3. To mount the disc, enter a command similar to the following:

   # /usr/sbin/mount -F cdfs -o rr /dev/dsk/cxdytz /SD_CDROM
   
   

   In the preceding example, /SD_CDROM is the disc mount point directory and /dev/dsk/cxdytz is the device name for the disc device, for example /dev/dsk/c0d2t0.

2.10 Starting up the Installer

1. Log in as the oracle user. If you switched to the oracle user using the "su - oracle" command, check the values of the environment variables again because the variables are not passed to the oracle user.

2. Insert Disk 1 into the disc drive.

3. Run the following commands (shown below the notes) to start up the Oracle Universal Installer from the disc.

   Notes: Be sure you are not logged in as the root user when you start the Oracle Universal Installer. If you are, then only the root user will have permissions to manage Oracle Application Server. Do not start the installation inside the mount_point directory. If you do, then you may not be able to eject the installation disk. The cd command, shown below, changes the current directory to your home directory.

   CD-ROM users:

   prompt> cd
   prompt> /SD_CDROM/runInstaller
   
   

   DVD users:

   prompt> cd
   prompt> /SD_CDROM/application_server/runInstaller
   
   

3 Installation

This section describes how to install these two Oracle Application Server topologies:

• Java Developer topology: Install this topology if you need a simple container for deploying and testing J2EE applications. See Section 3.1, "Installing a Java Developer Topology".

• Portal and Wireless Developer topology: Install this topology if you plan to develop applications that use OracleAS Portal, Oracle Application Server Wireless, or Identity Management services, such as Oracle Internet Directory and OracleAS Single Sign-On. You must install OracleAS Infrastructure 10g to install this topology. See Section 3.2, "Installing a Portal and Wireless Developer Topology".

These topologies are intended for development environments. See the Oracle Application Server 10g Installation Guide for additional topologies, including deployment topologies. Oracle recommends reviewing the Oracle Application Server 10g Installation Guide to verify coexistence of Oracle Application Server components for your deployment topology.

3.1 Installing a Java Developer Topology

A Java Developer topology consists of a J2EE and Web Cache instance, on which you can deploy and run J2EE applications.

Perform the following procedure to install a J2EE and Web Cache instance:

1. Start up the installer. See Section 2.10, "Starting up the Installer" for details.

2. Welcome screen: Click Next.

3. If this is the first Oracle product to be installed on this computer, you have to set up the "inventory" directory, as prompted by these screens:
   1. Specify Inventory Directory screen

      Enter the full destination path for the inventory directory: Enter the full destination path for the directory where you want the installer to store its files. Enter a directory that is different from the Oracle home directory.

      Example: /opt/oracle/oraInventory

      Click OK.

   2. UNIX Group Name screen

      Enter the name of the operating system group to have write permission for the inventory directory.

      Example: oinstall

      Click Next.

   3. Run orainstRoot.sh: Run the orainstRoot.sh script in a different shell as the root user. The script is located in the oraInventory directory.

      Click Continue.

4. Specify File Locations screen:

   Name: Enter a name to identify this Oracle home.

   Example: OH_J2EE_904

   Destination Path: Enter the full path to the destination directory. This is the Oracle home directory.

   Example: /opt/oracle/OraJ2EE_904

   If the destination directory does not exist, Oracle Universal Installer creates it.

   If you want to create the destination directory beforehand, create it as the oracle user; do not create it as the root user.

   Click Next.

5. Specify Hardware Cluster Installation Mode screen: This screen appears only on a computer that is part of a hardware cluster. This instance cannot be automatically installed on all computers of a cluster. Select Non-Cluster Installation and click Next.

6. Select a Product to Install screen: Select Oracle Application Server and click Next.

7. Select Installation Type screen: Select J2EE and Web Cache and click Next.

8. Preview of Steps for Middle Tier Installation screen: Click Next.

9. Confirm Pre-Installation Requirements screen: Verify that your computer meets all the requirements, and click Next.

10. Select Configuration Options screen:

    Select OracleAS Web Cache if you want to use caching capabilities with this Oracle Application Server instance.

    Do not select Identity Management Access.

    Do not select OracleAS Database-Based Cluster.

    Do not select OracleAS File-Based Cluster.

    Click Next.

11. Specify OracleAS Instance Name and ias_admin Password screen:

    Instance Name: Enter a name for this instance. If you have more than one Oracle Application Server instance on a computer, the instance names must be unique.

    Example: J2EE_904

    ias_admin Password and Confirm Password: Enter and confirm the password for the ias_admin user. This is the administrative user for this instance.

    Passwords must consist of at least five characters, and one of the characters must be a number.

    Click Next.

12. Choose JDK Home Directory

    Enter the full path to the HP Java 2 SDK 1.4.1.05 (or higher) for PA-RISC installation.

    Click Next.

13. Summary screen

    Verify your selections and click Install.

    Oracle Universal Installer is now installing the files and configuring Oracle Application Server components. This may take a while.

14. Run root.sh dialog

    Note: Do not run root.sh until prompted. Oracle Universal Installer will display a screen prompting you to run root.sh.

    In a different window, login as the root user and run the root.sh script. The script is located in this instance's Oracle home directory. After the root.sh script has completed, click OK on the Run root.sh dialog.

    The Configuration Assistants screen display shows the progress of the configuration assistants. The Configuration Assistants configure Oracle Application Server components.

15. End of Installation screen

    Click Exit to quit the installer.

3.2 Installing a Portal and Wireless Developer Topology

In this topology, you install a Portal and Wireless middle tier, which enables you to deploy applications that use components such as OracleAS Portal and OracleAS Wireless. The Portal and Wireless middle tier requires an OracleAS Infrastructure 10g, which you will install before installing the Portal and Wireless middle tier.

3.2.1 Installing an OracleAS Infrastructure 10g

This procedure installs an infrastructure with a new database and a new Oracle Internet Directory.

1. Start up the installer. See Section 2.10, "Starting up the Installer" for details.

2. Welcome screen: Click Next.

3. If this is the first Oracle product to be installed on this computer, you have to set up the "inventory" directory, as prompted by these screens:
   1. Specify Inventory Directory screen

      Enter the full destination path for the inventory directory: Enter the full destination path to the directory where you want the installer to store its files. Enter a directory that is different from the Oracle home directory.

      Example: /opt/oracle/oraInventory

      Click OK.

   2. UNIX Group Name screen

      Enter the name of the operating system group to have write permission for the inventory directory.

      Example: oinstall

      Click Next.

   3. Run orainstRoot.sh: Run the orainstRoot.sh script in a different shell as the root user. The script is located in the oraInventory directory.

      Click Continue.

4. Specify File Locations screen:

   Name: Enter a name to identify this Oracle home.

   Example: OH_INFRA_904

   Destination Path: Enter the full destination path to the Oracle home directory.

   Example: /opt/oracle/OraInfra_904

   If the destination directory does not exist, Oracle Universal Installer creates it.

   If you want to create the destination directory beforehand, create it as the oracle user; do not create it as the root user.

   Click Next.

5. Specify Hardware Cluster Installation Mode screen: This screen appears only on a computer that is part of a hardware cluster.

   If you want to install a High Availability environment refer to the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g High Availability Guide.

   Click Next.

6. Select a Product to Install screen: Select OracleAS Infrastructure 10g and click Next.

7. Select Installation Type screen: Select Identity Management and OracleAS Metadata Repository and click Next.

8. Preview of Steps for Infrastructure Installation screen: Click Next.

9. Confirm Pre-Installation Requirements screen: Verify that your computer meets all the requirements, and click Next.

   Refer to Section 2.8, "Check Port Use" to verify availability of port 1521.

10. Select Configuration Options screen:

    Select Oracle Internet Directory.

    Select OracleAS Single Sign-On.

    Select Oracle Delegated Administration Services.

    Select Oracle Directory Integration and Provisioning.

    Do not select OracleAS Certificate Authority.

    Do not select High Availability Addressing.

    Click Next.

11. Specify Namespace in Internet Directory screen: Select Suggested Namespace and click Next.

12. Enter information to create the OracleAS Metadata Repository database:
    1. Specify Privileged Operating System Groups screen

       This screen appears if you are running the installer as a user who is not in the dba operating system groups.

       Database Administrator (OSDBA) Group: Enter the name of an operating system group that you belong to.

       Example: dbadmin

       Database Operator (OSOPER) Group: Enter the name of an operating system group that you belong to.

       Example: dbadmin

       Click Next.

    2. Specify Database Identification screen

       Global Database Name: Enter a name for the OracleAS Metadata Repository database, and append the domain name of your computer to the database name.

       Example: asdb.acme.com

       SID: Enter the system identifier for the OracleAS Metadata Repository database. Typically this is the unique global database name, but without the domain name. The SID must be unique across all databases.

       Example: asdb

       Click Next.

    3. Specify and confirm the Passwords for the SYS and SYSTEM Users screen: Set the passwords for these database users, which are privileged accounts used for database administration.

       Click Next.

    4. Specify Database File Location screen:

       Enter or select a directory for database files: Enter the directory where you want the installer to create data files for the OracleAS Metadata Repository database.

       Example: /data_partition/ias_dbfiles/

       Click Next.

    5. Specify Database Character Set screen: Select Use the default character set.

       Click Next.

13. Specify OracleAS Instance Name and ias_admin Password screen:

    Instance Name: Enter a name for this instance. If you have more than one Oracle Application Server instance on a computer, the instance names must be unique.

    Example: INFRA_904

    ias_admin Password and Confirm Password: Enter and confirm the password for the ias_admin user. This is the administrative user for this instance.

    Passwords must consist of at least five characters, and one of the characters must be a number.

    Click Next.

14. Choose JDK Home Directory

    Enter the full path to the HP Java 2 SDK 1.4.1.05 (or higher) for PA-RISC installation.

    Click Next.

15. Summary screen

    Verify your selections and click Install.

    Oracle Universal Installer is now installing the files and configuring Oracle Application Server components. This may take a while.

16. Run root.sh dialog

    Note: Do not run root.sh until prompted. Oracle Universal Installer will display a screen prompting you to run root.sh.

    In a different window, login as the root user and run the root.sh script. The script is located in this instance's Oracle home directory. After the root.sh script has completed, click OK on the Run root.sh dialog.

17. End of Installation screen

    Click Exit to quit the installer.

3.2.2 Installing a Portal and Wireless Instance

This procedure installs a Portal and Wireless instance and configures it to use the infrastructure installed in Section 3.2.1, "Installing an OracleAS Infrastructure 10g".

1. Start up the installer. See Section 2.10, "Starting up the Installer" for details.

2. Welcome screen: Click Next.

3. Specify File Locations screen:

   Name: Enter a name to identify a new Oracle home.

   Example: OH_PORTAL_904

   Destination Path: Enter the full destination path to the Oracle home directory.

   Example: /opt/oracle/OraPortal_904

   If the destination directory does not exist, Oracle Universal Installer creates it.

   If you want to create the destination directory beforehand, create it as the oracle user; do not create it as the root user.

   Click Next.

4. Specify Hardware Cluster Installation Mode screen: This screen appears only if you are installing on a computer that is part of a hardware cluster. Select Non-Cluster Installation and click Next.

   If you want to install a High Availability environment refer to the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g High Availability Guide.

5. Select a Product to Install screen: Select Oracle Application Server and click Next.

6. Select Installation Type screen: Select Portal and Wireless click Next.

7. Preview of Steps for Middle Tier Installation screen: Click Next.

8. Confirm Pre-Installation Requirements screen: Verify that your computer meets all the requirements, and click Next.

9. Select Configuration Options screen:

   Select OracleAS Portal.

   Select OracleAS Wireless.

   Click Next

10. Enter connect information for Oracle Internet Directory:
    1. Register with Oracle Internet Directory screen

       Hostname: Enter the name of the computer where Oracle Internet Directory is running.

       Port: Enter the port number at which Oracle Internet Directory is listening. To determine Oracle Internet Directory's port number, look in the portlist.ini file located in the ORACLE_HOME/install directory of the infrastructure.

       If you select Use only SSL connections with this Oracle Internet Directory, then you must obtain the port number from Oracle Internet Directory (SSL) parameter in the portlist.ini file.

       Click Next.

    2. Specify Login for Oracle Internet Directory screen

       Username: Enter orcladmin. This is the name of the Oracle Internet Directory administrator.

       Password: The password for orcladmin is the same as the password for the ias_admin user in the infrastructure. You entered this password when you installed the infrastructure (see step 13 in Section 3.2.1, "Installing an OracleAS Infrastructure 10g").

       Click Next.

11. Select Metadata Repository screen

    Repository: Select the OracleAS Metadata Repository that you want to use for this middle tier instance and click Next.

12. Specify OracleAS Instance Name and ias_admin Password screen:

    Instance Name: Enter a name for this instance. If you have more than one Oracle Application Server instance on a computer, the instance names must be unique.

    Example: PORTAL_904

    ias_admin Password and Confirm Password: Enter and confirm the password for the ias_admin user. This is the administrative user for this instance.

    Passwords must consist of at least five characters, and one of the characters must be a number.

    Click Next.

13. Choose JDK Home Directory

    Enter the full path to the HP Java 2 SDK 1.4.1.05 (or higher) for PA-RISC installation.

    Click Next.

14. Summary screen

    Verify your selections and click Install.

    Oracle Universal Installer is now installing the files and configuring Oracle Application Server components. This may take a while.

15. Run root.sh dialog

    Note: Do not run root.sh until prompted. Oracle Universal Installer will display a screen prompting you to run root.sh.

    In a different window, login as the root user and run the root.sh script. The script is located in this instance's Oracle home directory. After the root.sh script has completed, click OK on the Run root.sh dialog.

16. End of Installation screen:

    Click Exit to quit the installer.

3.3 Accessing the Welcome Page

After installation, access the Oracle Application Server Welcome page to verify that the installation was successful. The URL for the Welcome page is:

http://hostname.domainname:http_port

Determine the http_port by looking in the portlist.ini file, located in the ORACLE_HOME/install directory. The http_port is listed on the "Oracle HTTP Server listen port" line.

The Welcome page provides links to these useful pages:

• What is new in Oracle Application Server 10g (9.0.4)

• Oracle Enterprise Manager Application Server Control (Application Server Control), which is a browser-based administrative tool.

• Release Notes

• Demos

4 Installing OracleAS Metadata Repository in an Existing Database

If you want to install the OracleAS Metadata Repository in an existing Oracle database, you can run a tool called the Oracle Application Server Repository Creation Assistant (OracleAS RepCA). This tool loads the OracleAS Metadata Repository data into an existing database.

You can find the OracleAS RepCA and associated documentation in the Installing the Oracle Application Server Metadata Repository into an Existing Database document on the "OracleAS RepCA and Utilities" CD-ROM.

5 Upgrade

This section describes how to upgrade the J2EE and Web Cache installation type, and the OracleAS Portal component of the Portal and Wireless installation type from Release 2 (9.0.2) or Release 2 (9.0.3) to Oracle Application Server 10g (9.0.4).

This section does not explain how to upgrade the OracleAS Portal schema in the Infrastructure.

This section also includes instructions for using the Oracle Application Server Upgrade Assistant (OracleAS Upgrade Assistant), a tool that automates much of the upgrade process.

This section features the following topics:

• Section 5.1, "Conventions"

• Section 5.2, "Performing Pre-Upgrade Tasks"

• Section 5.3, "Performing a J2EE and Web Cache Upgrade"

• Section 5.4, "Performing a Portal and Wireless Upgrade"

5.1 Conventions

In Section 5, references to Oracle homes use the following conventions:

• The Release 2 (9.0.2) or Release 2 (9.0.3) Oracle Application Server instance is designated in path names as <source_MT_OH>.

• The 10g (9.0.4) instance is designated in path names as <desination_MT_OH>.

5.2 Performing Pre-Upgrade Tasks

Before upgrading, perform the tasks in the following sections:

• Section 5.2.1, "Install Oracle Application Server 10g (9.0.4)"

• Refer to the Oracle Application Server 10g Upgrading to 10g (9.0.4) for component specific pre-upgrade tasks.

5.2.1 Install Oracle Application Server 10g (9.0.4)

Before upgrading, you must install Oracle Application Server 10g (9.0.4). Select the J2EE and Web Cache or Portal and Wireless installation type during Oracle Application Server 10g (9.0.4) installation. The upgrade cannot take place unless there is a destination Oracle Application Server instance. (Do not install a new infrastructure.)

The installation type of the source instance must match the installation type of the destination instance. The source and destination Oracle Application Server instance must exist on the same computer. If the source instance uses an infrastructure, the destination instance must use the same Oracle Internet Directory and Metadata Repository. (Do not install a new infrastructure.) The 9.0.4 installation should use the same oraInventory directory as the source 9.0.2 installation.

5.3 Performing a J2EE and Web Cache Upgrade

This procedure enables you to upgrade a J2EE and Web Cache instance:

1. Stop the Application Server Control with the following commands:

   <source_MT_OH>/bin/emctl stop
   <destination_MT_OH>/bin/emctl stop iasconsole
   
   

2. In the J2EE and Web Cache instances, stop Web Cache, OPMN and the Oracle Application Server processes managed by it with the following command:

   <source_MT_OH>/opmn/bin/opmnctl stopall
   <source_MT_OH>/webcache/bin/webcachectl stop
   <destination_MT_OH>/opmn/bin/opmnctl stopall
   
   

3. Start the OracleAS Upgrade Assistant with the following command:

   <destination_MT_OH>/upgrade/iasua.sh
   
   

4. Welcome screen: Click Next.

5. Oracle Homes screen:

   Select the source J2EE and Web Cache Oracle home from the drop-down list and click Next.

6. Examining Components dialog screen:

   Click OK.

7. Requirements screen:

   Ensure that all the requirements are met, and check all checkboxes then click Next.

8. Summary screen:

   Click Finish to start the upgrade processing.

9. Upgrade Succeeded dialog screen:

   Click OK.

   See Also: Oracle Application Server 10g Upgrading to 10g (9.0.4), section titled "Manual Upgrade Tasks You May Need to Perform" if the J2EE and Web Cache configuration you upgraded from has any of these conditions: Files in non-default locations Configuration files that refer to custom files and directories Static documents and directories in the default document root directory that you want to use in 10g (9.0.4) Web Cache configured as the first listener

5.4 Performing a Portal and Wireless Upgrade

Follow the steps below to upgrade the Portal and Wireless middle tier.

1. Stop the Application Server Control with the following commands:

   <source_MT_OH>/bin/emctl stop
   <destination_MT_OH>/bin/emctl stop iasconsole
   
   

2. In the J2EE and Web Cache instance, stop Web Cache, OPMN and the Oracle Application Server processes managed by it with the following command:

   <source_MT_OH>/opmn/bin/opmnctl stopall
   <source_MT_OH>/webcache/bin/webcachectl stop
   <destination_MT_OH>/opmn/bin/opmnctl stopall
   
   

3. Start the OracleAS Upgrade Assistant with the following command:

   <destination_MT_OH>/upgrade/iasua.sh
   
   

4. Welcome screen:

   Click Next.

5. Oracle Homes screen:

   Select the Portal and Wireless source Oracle home from the drop-down list and click Next.

6. Examining Components dialog screen:

   Click OK.

7. Requirements screen:

   Ensure that all the requirements are met, and check all checkboxes. Click Next.

8. Summary screen:

   Click Finish to start the upgrade processing.

9. Upgrade Succeeded dialog screen:

   Click OK.

   See Also: Oracle Application Server 10g Upgrading to 10g (9.0.4), section titled "Completing the OracleAS Portal Upgrade" if the Parallel Page Engine or the Portal Development Kit Services for Java were customized. These customizations must be copied from the files in <source_MT_OH> to the corresponding files in <destination_MT_OH>.

6 Additional Resources

For more information, see these Oracle resources:

• Oracle Application Server Documentation Library CD-ROM

• Oracle Application Server platform-specific documentation on Oracle Application Server Disk 1

Printed documentation is available for sale in the Oracle Store at:

http://oraclestore.oracle.com/

You can also contact your Oracle representative to purchase printed documentation.

To download free release notes, installation documentation, white papers, or other collateral, visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at

http://otn.oracle.com/membership/index.htm

If you already have a username and password for OTN, then you can go directly to the documentation section of the OTN Web site at

http://otn.oracle.com/docs/index.htm

6.1 Oracle Support Services

If you purchased Oracle Product Support, you can call Oracle Support Services for assistance. Oracle Support Services include phone assistance, version updates and access to our service offerings. You have access to phone support 24 hours a day, 7 days a week. In the U.S.A., you can call Product Support at 1-800-223-1711.

Make sure you have your CSI (CPU Support Identifier) number ready when you call. (Keep the CSI number for your records, because it is your key to Oracle Support Services.) The Oracle Store sends the CSI number to you in an e-mail alert when it processes your order. If you do not have your CSI number and you are in the U.S.A., you can look up your CSI number by accessing our online Order Tracker which provides detailed order information. Go to the Oracle Store and click on Order Tracker located above the top navigation bar.

For Oracle Support Services locations outside the U.S.A., call your local support center for information on how to access support. To find the local support center in your country, visit the Support Web Center at:

http://www.oracle.com/support.

At the Support Web Center you will find information on Oracle Support Services, such as:

• Contact information

• Instructions on how to access electronic services

• Helpful Web sites

• Support Resources

• Oracle Support Portfolio

• Oracle Support Services news

With Oracle Product Support, you have round-the-clock access to OracleMetaLink, Oracle Support Services premier Web support offering. OracleMetaLink offers you access to installation assistance, product documentation, and a technical solution knowledge base.

It has technical forums, where you can post questions about your Oracle products and receive answers from Oracle Technical Support Analysts and other Oracle users. The questions and answers remain posted for the benefit of all users.

OracleMetaLink options include:

• Technical Assistance Request (TAR) access

• Patch downloads

• Bug database query access

• Product life-cycle information

You can access OracleMetaLink at:

http://metalink.oracle.com/.

6.2 Version Updates

If you do not have a currently supported license, you can purchase the most recent version of an Oracle product from the Oracle Store (http://oraclestore.oracle.com).

If you do have a currently supported license, you can place non-urgent requests for version update shipments through the iTAR feature on OracleMetaLink. You will need to log the iTAR type as a U.S. Client Relations/Non-Technical Request.

You can also request Version Update shipments in the U.S.A. by calling Client Relations. When requesting a Version Update, provide the following information to the Client Relations Analyst:

• CSI number

• Contact information

• Platform

• Product name

• Shipping address

• Version number of the product

Outside the U.S.A., call your local Oracle Support Center.

6.3 Premium Services

For information on our Premium Services, including onsite support, OracleGOLD, OraclePLATINUM, remote services, and upgrade packages, visit the Support Web Center at http://www.oracle.com/support or call your Support Sales Representative in the U.S.A at 1-800-833-3536.

6.4 Quick Reference

Resource	Contact Information/ Web Site
Purchase additional products, full-use licenses, version updates, and documentation in the U.S.A.	http://oraclestore.oracle.com
Access technical resources for developers	http://otn.oracle.com
Access installation documentation	http://otn.oracle.com
Access information about technical support	http://www.oracle.com/support
Locate local Oracle Support Centers outside the U.S.A.	http://www.oracle.com/support select Contact Support Services
Locate local Oracle offices outside the U.S.A.	http://www.oracle.com/international/html/
Call Client Relations in the U.S.A.	1-800-223-1711
Speak with your sales representative in the U.S.A.	1-800-ORACLE-1
TTY Access to technical support in the U.S.A.	1-800-446-2398

7 Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at:

http://www.oracle.com/accessibility/

7.1 Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Copyright © 2003 Oracle. All Rights Reserved.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.