Skip Headers

Oracle9i Application Server Installation Guide
Release 2 (9.0.3) for Solaris Operating System (SPARC)
Part Number B10014-01
Go To Core Documentation
Core		 Go To Platform Documentation
Platform		 Go To Table Of Contents
Contents		 Go To Index
Index

Go to previous page Go to next page

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:

2.1 Preinstallation Summary

Review and verify that you have completed the items listed on the following preinstallation summary before you begin your installation of Oracle9iAS 9.0.3.

Table 2-1 Oracle9iAS 9.0.3 Preinstallation Summary
Preinstallation Task Details

Hardware Requirements

Operating System Requirements

Certified Software

Preinstallation Tasks

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. While considering hardware configurations, note that optimal sizing for an Oracle9iAS 9.0.3 installation depends on:

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 Requirements

CPUFoot 1

A SPARC Processor

Disk Space

457MB

TMP or Swap Space

256 MB

/var/tmp Space

200 MB

Monitor

256 color displayFoot 2
1 Oracle recommends a multiple CPU computer.
2 Oracle Universal Installer fails to appear if the display is set to 16 colors. Oracle Universal Installer uses Java Runtime Environment (JRE) 1.3.1 which supports display drivers with 256 colors or more.

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

TMP or Swap Space

256 MB

1 GB 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:

2.3 Operating System Requirements

Oracle certifies Oracle9iAS 9.0.3 to install and run on the following operating systems:

Table 2-4 lists the Solaris Operating System patches you need to download and install before installing Oracle9iAS 9.0.3. You can download the patches from: 

 http://sunsolve.sun.com






Table 2-4   Solaris Operating System and Required Patches 
 








Operating System


Version








Solaris 2.6



    


  • The latest Solaris 2.6 recommended patch cluster

    


  • 106409-01 or higherFoot 1: Chinese TrueType fonts

    


  • 108091-03 or higherFoot 2: SunOS 5.6: ssJDK1.2.1_03 fails with fatal errors in ISO8859-01 Locales

    


  • 106842-09 or higher: Euro support patch

    


  • 106841-01 or higher: Euro support patch

    









Solaris 7



    


  • The latest Solaris 2.7 recommended patch cluster

    


  • 107226-18 or higher: CDE Windows manager patch

    


  • 107153-01 or higher: patch for replacing bad font in zh.GBK locale

    









Solaris 8



    


  • The latest Solaris 2.8 recommended patch cluster

    


  • 108921-14 or higher: CDE dtwm patch

    


  • 108940-41 or higher: Motif 2.1 patch

    












1
This patch is only required to display Traditional Chinese characters in Swing applications.

2
This patch is only required for any locale that uses the ISO8859-1 or ISO8859-15 character encoding.

2.3.1 Font Package for Java Requirement

You may need different character settings for different locales. For Solaris Font Packages for Java, you always need both SUNWilof and SUNWxwfnt packages for all locales. You may need additional font packages depending on your locale. For detailed list of Solaris Font Packages, refer to: 

http://java.sun.com/j2se/1.3/font-requirements.html

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

Review and complete the following preinstallation tasks before installing Oracle9iAS 9.0.3:

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 Creating UNIX Accounts and Groups

The following UNIX account and groups are required for the installation process:

2.5.2.1 UNIX Group Name for the Oracle Universal Installer Inventory

Use the admintool or groupadd utility to create a group name. For example, oinstall. The oinstall group will own Oracle Universal Installer's oraInventory directory. The oracle user account that runs the installation must have the oinstall group as its primary group.

For more information on these utilities, refer to your operating system documentation.

2.5.2.2 UNIX Account to Own Oracle Software

The oracle account is the UNIX account that owns Oracle software for your system. You must run Oracle Universal Installer from this account.

Create an oracle account with the properties listed in Table 2-5.

Table 2-5 Oracle Account Properties
Variable Property

Login Name

Select any name to access the account. This document refers to the name as the oracle account.

Group Identifier

The oinstall group.

Home Directory

Select a home directory consistent with other user home directories.

Login Shell

The default shell can be either the C, Bourne, or Korn shell.

Note:

Use the oracle account only for installing and maintaining Oracle software. Never use it for purposes unrelated to the Oracle Universal Installer. Do not use root as the oracle account.

2.5.3 Setting Environment Variables

Verify the requirements for the following environment variables before starting Oracle Universal Installer:

2.5.3.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 can not 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:

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:

2.5.3.2 DISPLAY

Set the DISPLAY environment variable to refer to the X Server that will display the installer. The format of the DISPLAY environment variable is: 

hostname:display_number.screen_number

For example: 

hostname:0.0

Oracle9iAS 9.0.3 requires a running X server to properly create graphics for the installer, Web applications, and management tools. The frame buffer X server installed with your operating system requires that you remain logged in and have the frame buffer running at all times. If you do not wish to do this, then you must use a virtual frame buffer, such as X Virtual Frame Buffer (XVFB) or Virtual Network Computing (VNC).

The installer configures this instance to use the same X server from the installation process for applications and management tools. This X server must either always be running or you must reconfigure Oracle9iAS 9.0.3 to use another X server that is always running after the installation completes.

Note:

Oracle Applications users must read article 181244.1 at: 

 http://metalink.oracle.com

This article contains applications-specific X server requirements and configuration information.

See Also:

  • Your operating system documentation for more information on the DISPLAY environment variable.

  • Oracle Technology Network (http://otn.oracle.com) for further information about obtaining and installing XVFB or other virtual frame buffer solutions. Search OTN for "frame buffer".

2.5.3.2.1 Installing From a Remote Workstation

Setting the DISPLAY environment variable enables you to run the Oracle Universal Installer remotely from another workstation. On the system where you launch the Oracle Universal Installer, set DISPLAY to the system name or IP address of your local workstation.

Note:

You can use a PC X emulator to run the install if it supports a PseudoColor color model or PseudoColor visual. Set the PC X emulator to use a PseudoColor visual, and then start the installer. Refer to the X emulator documentation for instructions on how to change the color model or visual settings.

If you get an Xlib error similar to "Failed to connect to server," "Connection refused by server," or "Can't open display" when starting the installer, then run the commands on your local workstations as listed in the table below.

Shell Types On server where the installer is running In session on your workstation

C shell

 
prompt> setenv DISPLAY host:0.0Foot 1

prompt> xhost +host

Bourne or Korn shell

 
prompt> DISPLAY=host:0.0;export 
DISPLAY

prompt> xhost +host
1 Host is the hostname or IP address of the workstation on which you want to display the installer.

2.5.3.3 TMP

During installation, Oracle Universal Installer uses a temporary directory for swap space. 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. The installer checks for the TMP environment variable to locate the temporary directory. If this environment variable does not exist, then the installer uses the /tmp directory. Set the TMP environment variable using the following command.

C shell Bourne/Korn shell 
prompt> setenv TMP full_path

prompt> TMP=full_path;export TMP

2.5.3.4 TNS_ADMIN

TNS_ADMIN points to the directory where Net configuration files are stored.

If TNS_ADMIN is set on your system, you will have conflicts between that directory and the directory where the Oracle9iAS 9.0.3 Net configuration files are created. You will also have conflicts if the configuration files are in a common directory outside of the Oracle home for any other installed Oracle products. For example, your system may use /var/opt/oracle/tnsnames.ora for database aliases.

To prevent conflicts between the Net configuration files for different Oracle products, copy the configuration files from either TNS_ADMIN or the common directory to ORACLE_HOME/network/admin for the other products and unset TNS_ADMIN using the following command.

C shell Bourne/Korn shell 
prompt> unsetenv TNS_ADMIN

prompt> unset TNS_ADMIN

2.5.4 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 /etc/hosts.* has the following format: 

IP_ADDRESS FULLY_QUALIFIED_HOSTNAME SHORT_HOSTNAME ALIASES

The following example shows a properly configured /etc/hosts.* file: 

148.87.9.44 oasdocs.us.oracle.com oasdocs oracleinstall

In addition to /etc/hosts, ensure the following files use the fully qualified hostname:

Failure to properly configure the hostname information in the listed files may result in runtime errors during Oracle9iAS 9.0.3 installation.

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

2.5.4.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:

2.5.5 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 A, "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:

2.6 Oracle Universal Installer

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

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:

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-6 lists the prerequisite checks that are performed.

Table 2-6 Oracle Universal Installer Automatic Prerequisite Checks
Prerequisite Checks See Also

Check for enough disk space for Oracle home installation

Table 2.2, "Hardware Requirements"

Check for TMP variable and sufficient swap space

Table 2.2, "Hardware Requirements"

Check that the install host has enough RAM

Table 2-3, "Oracle9iAS 9.0.3 Requirements and Recommendation"

Check the /etc/hosts file.

Section 2.5.4, "Host Name File Configuration"

Prohibit installation of Oracle9iAS 9.0.3 into an existing Oracle home

Section 2.5.3.1, "ORACLE_HOME"

Check for Solaris Operating Environment version 2.6 or later

Section 2.3, "Operating System Requirements"

Ensure that the value of ORACLE_HOME does not contain spaces or is longer than 127 characters

Section 2.5.3.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.5, "Port Allocation"

2.6.3 Oracle Universal Installer oraInventory Directory

The Oracle Universal Installer creates the oraInventory directory the first time it is run on a computer. The oraInventory 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 oraInventory directory.

When a UNIX group name is created and specified, it grants the specified group the permission to write to the oraInventory directory. If another group attempts to run the installer, then they must have permission to write to the oraInventory directory. If they do not have permission, then the installation will fail.

The location of oraInventory is defined in /var/opt/oracle/oraInst.loc.

The latest log file is: 

/your_base_directory/oraInventory/logs/installActiontodays_date_time.log

The your_base_directory identifier is the location for your installation files and todays_date_time is the date and time of installation. Log file names of previous installation sessions take the form installActionsdatetime.log.

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

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

2.6.4 Starting Oracle Universal Installer

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

  1. Insert the CD labelled Disk 1 into the CD-ROM drive.

  2. Mount the installation CD-ROM.

    The Oracle Product Installation CD-ROM is in RockRidge format. If you are using the Solaris Volume Management software (installed by default with Solaris Operating Environment), then the CD-ROM is mounted automatically to /cdrom/9ias_903disk1 when you insert it in the disk drive.

    If you are not using the Solaris Volume Management software, then you must mount the CD-ROM manually. To manually mount or unmount the CD-ROM, you must have root privileges. Be sure to unmount the CD-ROM before removing it from the drive.

    Follow these steps to manually mount Disk 1 CD-ROM:

    1. Log in as the root user.

    2. Create the CD-ROM mount point directory: 

      prompt> mkdir mount_point
    3. Mount the CD-ROM drive on the mount point directory and exit the root account: 

      prompt> mount options device_name mount_point
prompt> exit

      The following example mounts the CD-ROM manually on /cdrom, without using the Solaris Volume Management software. Execute the following commands as root user: 

      prompt> mkdir /cdrom
prompt> mount -r -F hsfs device_name /cdrom
    4. Log out as the root user.

  3. Run Oracle Universal Installer from the CD-ROM.

    Note:

    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 Oracle9iAS 9.0.3.

    1. Log in as the oracle user.

    2. Start the installer by entering: 

      prompt> mount_point/9ias_903disk1/runInstaller

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

      Note:

      Do not start the installation inside the mount_point directory. If you do, then you may not be able to eject the installation disk.

2.7 Installation

The following sections provide the sequence of the installation screens that you will encounter during the installation process, installation considerations, and additional installation information for Oracle9iAS 9.0.3. This section contains the following topics:

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. Your primary Oracle9iAS installation contains the active Oracle Enterprise Manager Web site. Run the following command in your primary installation ORACLE_HOME: 

prompt> ORACLE_HOME/bin/emctl stop

Following Oracle9iAS 9.0.3 installation, restart the Oracle Enterprise Manager Web site using the following command: 

prompt> ORACLE_HOME/bin/emctl start

The following screens appear during installation of Oracle9iAS 9.0.3:

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

  2. Inventory Location screen: Verify the location of the base directory for installation files (first time installation).

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

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

  5. 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).

  6. 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.

  7. 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 created from the previous installation.

  8. 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).

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

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

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

  12. 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:

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:

Go to previous page Go to next page
Oracle
Copyright © 2002 Oracle Corporation.
All Rights Reserved.
Go To Core Documentation
Core		 Go To Platform Documentation
Platform		 Go To Table Of Contents
Contents		 Go To Index
Index