2
Getting Started

This chapter provides information about how to start installing Oracle9i Application Server Release 2 (9.0.3) (Oracle9iAS 9.0.3). The topics include:

• Preinstallation Summary

• Hardware Requirements

• Operating System Requirements

• Certified Software

• Preinstallation Tasks

• Oracle Universal Installer

• Installation

2.1 Preinstallation Summary

Verify that you have completed the items listed on the following preinstallation summary before you install Oracle9iAS 9.0.3.

Table 2-1 Oracle9iAS 9.0.3 Preinstallation Summary

Preinstallation Task	Details
Hardware Requirements	Table 2-2, "Oracle9iAS 9.0.3 Hardware Requirements" Table 2-3, "Oracle9iAS 9.0.3 Requirements and Recommendation"
Operating System Requirements	Section 2.3, "Operating System Requirements"
Certified Software	http://metalink.oracle.com
Preinstallation Tasks	Section 2.5.1, "Release Notes" Section 2.5.2, "Oracle Directories" Section 2.5.3, "Host Name File Configuration" Section 2.5.4, "Port Allocation"

2.2 Hardware Requirements

Table 2-2 shows the hardware requirements for installing Oracle9iAS 9.0.3. Table 2-3 shows the minimal installation requirements and recommendations for production environments. Note that optimal sizing for an Oracle9iAS 9.0.3 installation depends on:

• the profile of your Oracle9iAS 9.0.3 installation (which Oracle9iAS 9.0.3 components are configured and used)

• the size of your applications

• the nature of your applications (largely transactional in nature or primarily read-only)

• user load (number of concurrent users)

• pattern of usage (peak usage or low usage)

• throughput and response time goals

Increasing the amount of hardware resources can improve the performance of your Oracle9iAS 9.0.3 installation and the number of supported concurrent users.

See Also: Oracle9i Application Server Performance Guide

Table 2-2 Oracle9iAS 9.0.3 Hardware Requirements

Information	Minimum Requirements
CPU	An Intel Pentium 300MHz processor
Disk SpaceFoot 1	500 MB
Total Pagefile Size (Virtual Memory)	512 MB (1 GB recommended for clustering or in production environment) To change the total pagefile size (virtual memory): Windows NT: Select Start > Settings > Control Panel > System. Under the Performance tab, enter a new virtual memory amount and click Change. Windows 2000: Select Start > Settings > Control Panel > System > Advanced. Under the Performance Options tab, enter a new virtual memory amount and click Change.
TEMP Directory	275 MB of free space
Monitor	256 color viewing capability

1 The disk space must be available on a single drive. Oracle9iAS 9.0.3 does not support spanning the installation over multiple drives.

Table 2-3 Oracle9iAS 9.0.3 Requirements and Recommendation

Information	Minimum Installation Requirement	Production Environment Recommendations
Memory	256 MBFoot 1	512 MB or greater

1 Memory for Oracle9iAS Web Cache should be based on the following formula: (average HTTP object size) * (maximum number of objects you want to cache). Thus, if you want to cache 1,000,000 objects and the average size of the objects is 2 KB, then set the maximum cache size to at least 2 GB.

2.2.1 Network Requirements

Oracle9iAS 9.0.3 does not support the following network configurations and scenarios:

• Changing the domain after installation.

• Using Network File System (NFS) to access and share files.

2.3 Operating System Requirements

Oracle9iAS 9.0.3 runs on the following operating systems:

• Microsoft Windows NT with Service Pack 6a

• Microsoft Windows 2000 with Service Pack 1 or above

2.3.1 Operating System Group Requirement

To install Oracle9iAS 9.0.3, you must be a member of the Windows Administrators group. If you are not a member, you need to get someone who is a member of the group to add you to the group.

To check if you are a member of the Administrators group:

Windows NT:

1. Select Start > Programs > Administrative Tools (Common) > User Manager. This displays the User Manager window.

2. Double-click your user name in the Username column. This displays the User Properties window.

3. Click Groups at the bottom of the window. This display the Group Memberships window. Check that you are a member of the Administrators group.

Windows 2000:

1. Select Start > Settings > Control Panel.

2. Double-click Administrative Tools.

3. Double-click Computer Management.

4. Expand Local Users and Groups, and select the Users folder.

5. Double-click your user name in the right side of the window. This displays the Properties dialog for the user.

6. Click the Member Of tab to see groups that you belong to.

2.4 Certified Software

Installing and operating Oracle9iAS 9.0.3 requires a Web browser. A complete list of certified software for Oracle9iAS 9.0.3 is located at the OracleMetaLink site:

http://metalink.oracle.com

2.5 Preinstallation Tasks

Perform these tasks before installing Oracle9iAS 9.0.3:

• Release Notes

• Oracle Directories

• Host Name File Configuration

• Port Allocation

2.5.1 Release Notes

Oracle recommends reading the Oracle9i Application Server 9.0.3 Release Notes prior to installing Oracle9iAS 9.0.3. Oracle9i Application Server 9.0.3 Release Notes are available with Oracle platform-specific documentation and are available at the OTN Web site at:

http://otn.oracle.com/products/ias/content.html

2.5.2 Oracle Directories

Verify the requirements for the following directories before starting Oracle Universal Installer:

• Oracle Home

• TEMP

2.5.2.1 Oracle Home

Oracle home is the directory in which Oracle software is installed.

Oracle homes are identified by name. The Oracle home name identifies the program group associated with a specific Oracle home and the installed Oracle services associated with the home.

Your Oracle home name must not contain spaces and cannot be longer than 16 characters.

Your Oracle home path must not contain spaces and cannot be longer than 127 characters.

Note: The Oracle9iAS 9.0.3 instance must be installed in its own Oracle home. For example, you cannot install Oracle9iAS 9.0.3 into an Oracle9iAS 9.0.2 Oracle home. The Oracle9iAS 9.0.3 instance can be installed on the same or a different host from Oracle9iAS Infrastructure 9.0.2.

Do not install Oracle9iAS 9.0.3 into any existing Oracle home directories. For example:

• Oracle9iAS 9.0.2 home directory

• Oracle9iAS Infrastructure 9.0.2 home directory

• Oracle9iAS Developer Kits 9.0.2 home directory

• Oracle9i Database home directory

• Oracle8i Database home directory

• Oracle9i Developer Suite directory

If you want to migrate applications and configuration data from an existing Oracle9iAS 9.0.2 J2EE and Web Cache mid-tier, you install Oracle9iAS 9.0.3 in a separate directory, then migrate your applications from 9.0.2 to 9.0.3. You cannot migrate by installing 9.0.3 in the 9.0.2 directory. See the Oracle9i Application Server Migrating to Release 2 (9.0.3) guide for details.

Note: Oracle9iAS 9.0.3 cannot be used to run any of the Oracle9iAS 9.0.2 mid-tier install types. For example, you cannot run Oracle9iAS Portal, Oracle9iAS Forms Services, or Oracle9iAS Discoverer on top of Oracle9iAS 9.0.3.

The Oracle9iAS 9.0.3 installation requires an instance name and an administrative password (for the ias_admin user) during initial installation on a host. The ias_admin user's password enables Oracle9iAS 9.0.3 instance management through the Oracle Enterprise Manager. If Oracle9iAS 9.0.3 or another Oracle9iAS product has already been installed on the host, then a unique instance name and the existing ias_admin user's password must be provided before continuing with the installation. An Oracle9iAS 9.0.3 installation in a different Oracle home on the same host requires a unique instance name and the existing ias_admin user's password before continuing with the installation.

See Also: Section 2.2, "Hardware Requirements" Chapter 1, "Installation Concepts" Oracle9i Application Server Administrator's Guide

2.5.2.2 TEMP

During installation, Oracle Universal Installer uses a temporary directory for writing temporary files. This directory must meet the requirements listed in Section 2.2, "Hardware Requirements" before installing Oracle9iAS 9.0.3. The installation may fail if you do not have sufficient space.

2.5.3 Host Name File Configuration

Oracle Universal Installer requires that the fully qualified host name information appear in the configuration files for your computer. A fully qualified host name includes both the name of the system and its domain.

Verify that your system's network configuration has the correct host name file configuration by completing the following steps:

Windows NT

1. Go to Start > Settings > Control Panel.

2. Double-click Network.

3. Select the Protocols tab.

4. Select the TCP/IP protocol.

5. Click Properties button.

6. Select the DNS tab.

7. Verify that the correct host name and domain are entered the respective fields.

Also verify the hosts file located in your Winnt directory located on your hard drive. Locate the following file:

C:\Winnt\System32\drivers\etc\hosts

where "C" is the letter for your hard drive.

Windows 2000

1. Go to Start > Settings > Control Panel.

2. Double-click System.

3. Select the Network Identification tab.

4. Click the Properties button.

5. Verify that the correct host name and domain are listed in Full computer name.

   If the host name and domain are not listed or listed incorrectly, then click More button to enter the correct host name and domain.

After you have properly configured the hostname information, reboot your computer before starting Oracle9iAS 9.0.3 installation.

2.5.3.1 Host Domain Name

Oracle Universal Installer requires specific conventions for the host domain name. If the host domain name does not conform to the following requirements, the Oracle9iAS 9.0.3 installation will fail:

• No blank spaces or underscores are permitted as part of the domain name.

• Domain names can be upper or lower case.

• The first character of the host domain name must be a letter of the alphabet.

• The last character of the host domain name must not be a minus sign or period.

• A host which serves as an Internet gateway should have "GATEWAY" or "GW" as part of the domain name.

2.5.4 Port Allocation

Following installation, Oracle Universal Installer creates a file showing the port numbers assigned during installation of Oracle9iAS 9.0.3 components. The installation process automatically detects any port conflicts and selects an alternative port in the range allocated for that component. Appendix B, "Default Port Numbers and Port Ranges" lists the default port ranges. The portlist.ini file is located at:

ORACLE_HOME\install\portlist.ini

This file lists component entries as "port_name = port_value". For example:

Oracle HTTP Server port = 7777
Oracle HTTP Server SSL port = 4443
Oracle HTTP Server listen port = 7778
Oracle HTTP Server SSL listen port = 4444
Oracle HTTP Server Jserv port = 8007
Enterprise Manager Servlet port = 1810

You can also view the port numbers by pointing your browser to the Oracle9iAS Welcome page and selecting the Ports tab.

See Also: Section 3.2.3, "About the Oracle Enterprise Manager Web Site" Oracle9i Application Server Administrator's Guide.

2.6 Oracle Universal Installer

This section describes how Oracle9iAS 9.0.3 uses Oracle Universal Installer for installation. It includes the following topics:

• About Oracle Universal Installer

• Oracle Universal Installer Prerequisite Checks

• Oracle Universal Installer Inventory Directory

• Windows System Files Installation

• Starting Oracle Universal Installer

2.6.1 About Oracle Universal Installer

Oracle9iAS 9.0.3 uses Oracle Universal Installer to guide you through each step of the installation process.

The Oracle Universal Installer provides the following features:

• Describes installation options for Oracle9iAS 9.0.3

• Detects configuration settings

• Sets configuration during installation

• Offers configuration options for a customized installation of Oracle9iAS 9.0.3

• Deinstalls Oracle9iAS 9.0.3

  Note: Oracle Universal Installer fails to appear if the display uses less than 256 colors. Oracle Universal Installer uses JRE 1.3.1, which supports display drivers with 256 colors or more.

2.6.2 Oracle Universal Installer Prerequisite Checks

The Oracle Universal Installer automatically checks your computer prior to installation to verify that your system meets operational requirements. Table 2-4 lists the prerequisite checks that are performed.

Table 2-4 Oracle Universal Installer Automatic Prerequisite Checks

Prerequisite Checks	See Also
Verify Operating System Requirements	Section 2.3, "Operating System Requirements"
Check for enough disk space for Oracle home installation	Table 2.2, "Hardware Requirements"
Check for TEMP Space	Section 2-2, "Oracle9iAS 9.0.3 Hardware Requirements"
Check that the install host has enough RAM	Table 2-3, "Oracle9iAS 9.0.3 Requirements and Recommendation"
Verify Total Pagefile Size	Section 2.2, "Hardware Requirements"
Verify existence of Windows Systems files	Section 2.6.4, "Windows System Files Installation"
Check the hosts file configuration	Section 2.5.3, "Host Name File Configuration"
Prohibit installation of Oracle9iAS 9.0.3 into an existing Oracle home	Section 2.5.2.1, "Oracle Home"
Ensure that the name of ORACLE_HOME does not contain spaces and is not longer than 16 characters	Section 2.5.2.1, "Oracle Home"
Verify the monitor has 256 color viewing capability	Section 2.2, "Hardware Requirements"
Verify operational requirements of the CPU	Table 2.2, "Hardware Requirements"
Port detection and resolution	Section 2.5.4, "Port Allocation"

2.6.3 Oracle Universal Installer Inventory Directory

The Oracle Universal Installer creates the Inventory directory the first time it is run on a computer. The Inventory directory keeps an inventory of products that the Oracle Universal Installer installs on your computer, as well as other installation information. If you have previously installed Oracle products, then you may already have an Inventory directory.

The default location of the Inventory directory is:

C:\Program Files\Oracle\Inventory

Do not delete or manually alter the Inventory directory or its contents. Doing so can prevent the installer from locating products that you have installed on your system.

Oracle Universal Installer creates log files at the following location:

C:\Program Files\Oracle\Inventory\logs\installActionsdate_time.log

date_time is the date and time of installation.

A complete listing of log files is included in the Oracle9i Application Server Administrator's Guide.

2.6.4 Windows System Files Installation

Note: This section applies to Windows NT only. You do not need to run wsf.exe on Windows 2000.

Oracle9iAS 9.0.3 requires several files to be present in the Windows System folder. During the installation, these files are examined to ensure that they are up-to-date. If any file has an outdated version, it will be replaced with a compatible version.

Normally, replacement can be done during the installation, but if the file to be replaced is in use by another process at the time of installation, then the installation will halt and an error dialog will appear. This is because Windows needs to restart for the updated file to take effect, and the installation routine cannot be interrupted by a system reboot during installation.

Oracle9iAS 9.0.3 includes a supplementary installation for the required Windows System Files. This Windows System Files installation will automatically reboot the system if necessary at the conclusion of the system files installation.

If you encounter a Windows System Files error during the installation, click OK to close the error dialog, then use the following instructions to run the Windows System Files installation. You cannot proceed with the Oracle9iAS 9.0.3 installation if you do not run the Windows System Files installation.

To run the Windows System Files installation:

1. Click OK to close the error dialog. The error dialog looks like this:

   

   Text description of the illustration wsf_warning.jpg

2. Click Exit to quit the Oracle9iAS 9.0.3 installation.

3. If you have any open or unsaved documents from other applications, save and close them. This is important because wsf.exe will reboot the machine automatically when it is complete.

4. Change to the root directory on the Oracle9iAS 9.0.3 CD-ROM.

5. Run wsf.exe.

   Click Next to start the file copying process.

   When wsf.exe is complete, it restarts Windows automatically, if required; otherwise the Windows System Files installation will end without displaying any Installation Finished dialog.

6. After Windows restarts or at the end of the Windows System Files installation, restart the Oracle9iAS 9.0.3 installation.

2.6.5 Starting Oracle Universal Installer

Follow these steps to start Oracle Universal Installer and install Oracle9iAS 9.0.3:

1. Stop all Oracle processes and services (for example, the Oracle database).

2. Be sure that you are logged in to the computer as a member of the Windows Administrators group.

3. Insert the Oracle9iAS 9.0.3 installation disk into the CD-ROM drive to launch Oracle Universal Installer.
   • If your computer supports the auto run feature, the installer will automatically launch on your computer.

   • If your computer does not support the auto run feature, perform the following steps to launch the installer:

   1. Locate the following file:

      G:\Setup.exe, where "G" is the letter for your CD-ROM drive.

   2. Start the installer by launching the Setup.exe program.

      This launches Oracle Universal Installer through which you can install Oracle9iAS 9.0.3.

2.7 Installation

The following sections describe the installation screen sequence, installation considerations, and additional installation information for Oracle9iAS 9.0.3. This section contains the following topics:

• Installation Sequence

• Installation Considerations

• Additional Oracle9iAS 9.0.3 Installations

2.7.1 Installation Sequence

Oracle recommends reviewing the installation sequence for a better understanding of the Oracle9iAS 9.0.3 installation process.

Note: Before installation on a host that already has an Oracle9iAS instance, you must stop the Oracle Enterprise Manager Web site using the Services panel: (Windows NT) Go to Start > Settings > Control Panel > Services. Select the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Stop button. (Windows 2000) Go to Start > Programs > Administrative Tools > Services. Select the Oracle Enterprise Manager Web site (OracleORACLE_HOMEEMWebsite). Click the Stop icon. After installation, you can restart the Oracle Enterprise Manager Web site by clicking the Start button or icon.

The following screens appear during installation of Oracle9iAS 9.0.3:

1. Welcome screen: Review information about the Oracle Universal Installer.

2. File Locations screen: Verify the source path, destination name, and destination path for your Oracle9iAS 9.0.3 installation.

3. Component Configuration and Startup screen: Select the components to configure during the installation process.

4. Oracle9iAS Infrastructure Use screen: Allows you to select whether or not you will use Oracle9iAS Single Sign-On or cluster management (with Oracle9iAS Infrastructure 9.0.2) with your installation of Oracle9iAS 9.0.3 (Oracle9iAS Single Sign-On installs with Oracle9iAS Infrastructure 9.0.2).

5. Oracle Internet Directory screen (optional): Enter the username and password for your registration of Oracle9iAS 9.0.3 configuration information into Oracle Internet Directory. (Oracle Internet Directory installs with Oracle9iAS Infrastructure 9.0.2.) The username you enter must be a member of the IASAdmins group (for example, orcladmin).

   If you are associating Oracle9iAS 9.0.3 with an Infrastructure, you must provide the username and password for the Oracle Internet Directory associated with that Infrastructure.

6. One of the following screens appears based on whether Oracle9iAS 9.0.3 has been installed on your computer:
   • Create Instance Name and ias_admin Password screen: This screen appears if this is a first time installation of Oracle9iAS 9.0.3 on this host. Enter the following instance information:
     • Instance Name: Identifies the installation instance of Oracle9iAS 9.0.3 on this host.

     • ias_admin Password: The ias_admin user's password used to administer any Oracle9iAS 9.0.3 instance on this host. This password is required for installation of additional Oracle9iAS 9.0.3 instances or other Oracle9i Application Server products.

   • Create Instance Name screen: This screen appears if the Oracle Universal Installer has detected a previous installation of Oracle9iAS 9.0.3 or other Oracle9i Application Server products on this host but in a different Oracle home. Enter an instance name to identify this instance of Oracle9iAS 9.0.3. Enter the ias_admin user's password from the previous installation.

7. Metadata Repository screen (optional): Select the Oracle9iAS Metadata Repository you would like to use for this Oracle9iAS 9.0.3 installation. This screen appears if the Oracle Universal Installer detects multiple installations of Oracle9iAS Metadata Repository 9.0.2 (Oracle9iAS Metadata Repository installs with Oracle9iAS Infrastructure 9.0.2).

8. Installation Summary screen: Review the summary of your Oracle9iAS 9.0.3 installation and begin the installation process.

9. Install screen: Appears while the product is installing. The screen shows installation operations. No user interaction is required.

10. Oracle9iAS Configuration Tools screen: Review the status of Oracle9iAS configuration tools for components you have selected. No user interaction is required.

11. End of Installation screen: Appears at the end of the installation process. It notifies you whether the installation was successful or unsuccessful and provides information about accessing the Oracle9iAS 9.0.3 instance from a Web browser.

    Note: After the installer finishes, you must perform the tasks in Section 3.2, "Postinstallation" to complete your Oracle9iAS 9.0.3 installation.

2.7.2 Installation Considerations

Please review the following installation considerations for Oracle9iAS 9.0.3:

• Oracle9iAS 9.0.3 cannot be used to run any of the Oracle9iAS 9.0.2 mid-tier install types. For example, you cannot run Oracle9iAS Portal, Oracle9iAS Forms Services, or Oracle9iAS Discoverer on top of Oracle9iAS 9.0.3.

• Oracle9iAS 9.0.3 cannot be installed in an existing Oracle home. For example, you cannot install Oracle9iAS 9.0.3 into an Oracle9iAS 9.0.2 Oracle home.

  If you want to migrate applications and configuration data from an existing Oracle9iAS 9.0.2 J2EE and Web Cache mid-tier, you install Oracle9iAS 9.0.3 in a separate directory, then migrate your applications from 9.0.2 to 9.0.3. You cannot migrate by installing 9.0.3 in the 9.0.2 directory. See the Oracle9i Application Server Migrating to Release 2 (9.0.3) guide for details.

• You cannot create a cluster that consists of J2EE and Web Cache 9.0.3 instances and J2EE and Web Cache 9.0.2 instances.

• The J2EE and Web Cache instances in an application server cluster can be on different hosts; however, all J2EE and Web Cache instances in a single cluster must reside on hosts that use the same operating system type (for example, Windows). This is because the configuration information that is shared between instances in a cluster contains operating system-specific information, such as file path names.

• If you are installing Oracle9iAS Infrastructure 9.0.2 on the same host as Oracle9iAS 9.0.3, then you must install the Oracle9iAS Infrastructure 9.0.2 first. You can associate Oracle9iAS 9.0.3 with the Oracle9iAS Infrastructure 9.0.2 during, or after the Oracle9iAS 9.0.3 installation.

• If you are installing Oracle9iAS Infrastructure 9.0.2 on a different host from Oracle9iAS 9.0.3, then you can install the infrastructure before, or after the Oracle9iAS 9.0.3 installation. You can associate Oracle9iAS 9.0.3 with the infrastructure during, or after the Oracle9iAS 9.0.3 installation.

• If you associate your Oracle9iAS 9.0.3 instance with an Oracle9iAS Infrastructure 9.0.2, you cannot remove and reassociate the Oracle9iAS 9.0.3 instance with the infrastructure.

  See Also: Oracle9i Application Server Administrator's Guide for more information on clustering and associating an instance with an infrastructure.

2.7.2.1 Installing the Oracle9i Application Server 9.0.2.1 Patch

If you will be using Oracle9iAS 9.0.3 on the same host or farm as Oracle9iAS 9.0.2, then you must install the Oracle9i Application Server 9.0.2.1 patch. You must apply the 9.0.2.1 patch to all Oracle9iAS 9.0.2 instances, either before or after your installation of Oracle9iAS 9.0.3.

You can download the patch from:

http://metalink.oracle.com

Select the Patches link. On the patch download form, select Oracle9i Application Server in the Product Family field and then submit the form.

2.7.3 Additional Oracle9iAS 9.0.3 Installations

Oracle recommends reviewing the following before performing additional Oracle9iAS 9.0.3 installations on the same host:

• Review the preinstallation tasks covered previously in this chapter.

• Ensure all installation users are members of the Administrators operating system group.

• Specify a different Oracle home than the first Oracle9iAS 9.0.3 installation.

• Use the same Inventory directory for all Oracle9iAS 9.0.3 installations.

• Stop Oracle Enterprise Manager Web site before subsequent Oracle9iAS 9.0.3 installations. For more information refer to the Oracle9i Application Server Administrator's Guide.

• If you install more than one instance of Oracle9iAS 9.0.3, then each instance name must be unique.

• If an Oracle9iAS 9.0.3 installation is associated with an Oracle9iAS Infrastructure 9.0.2, then all subsequent Oracle9iAS 9.0.3 installations on the same host are automatically associated with the same infrastructure.

• If you perform multiple Oracle9iAS 9.0.3 installations, on different hosts, using the same Oracle9iAS Infrastructure 9.0.2, you must perform only one installation at a time. Simultaneous Oracle9iAS 9.0.3 installations and configurations pointing to a common Oracle9iAS Infrastructure 9.0.2 can result in a failure during OC4J deployment with some resource dead lock errors.

• After completion of your Oracle9iAS 9.0.3 installation, exit Oracle Universal Installer before installing another instance of Oracle9iAS 9.0.3. If the same installation session is used to install another instance of Oracle9iAS 9.0.3, then applications may fail in the second instance with "URL not found" errors.

• You can perform multiple Oracle9iAS 9.0.3 installs on the same host as different users. For more information refer to Section 3.2.8, "Multi-User Installations".