Skip Headers
Oracle® Application Server Installation Guide
10g Release 2 (10.1.2) for AIX 5L Based Systems (64-Bit)
  Go To Documentation Library
Go To Table Of Contents
Go To Index


5 Things You Should Know Before Starting the Installation

This chapters includes the following sections:

5.1 Obtaining Software from Oracle E-Delivery

You can obtain Oracle products from Oracle E-Delivery at Oracle products are distributed as "E-Packs". An E-Pack is an electronic version of the software that is also available to Oracle Customers on CD-ROM or DVD. This section contains the following topics:

5.1.1 Finding and Downloading the Oracle Application Server 10g Release 2 (10.1.2) E-Pack

Refer to the CD/Media Pack description or the list of products that you purchased on your Oracle Ordering Document. Then, view the License List to help you decide which Product Pack you need to select in order to search for the appropriate E-Pack(s) to download. Prior to downloading, verify that the product you are looking for is in the License and Options section of the E-Pack README. Oracle recommends that you print the README for reference.

5.1.2 Finding Required and Optional Downloads

Refer to the README link that is on each E-Pack Download page. In addition to listing the licensable products and options contained in the pack, the README lists downloadable files that are required to run each product and which downloadable files are optional. Oracle recommends that you print the README for reference.

5.1.3 Disk Space Requirements

In addition to having the required disk space necessary to install and run your Oracle software, you'll need to have sufficient disk space to download all the required software files and have enough disk space to extract them.

After extracting the software from the Zip files, you can burn them onto CD-ROM and install from them, or install from your computer's hard drive.

5.1.4 Extracting Software from the Zip Files

Verify that the file size of your downloaded file matches the file size displayed on E-Delivery. Unzip each Zip file to its own temporary directory. For example, create a directory called oraAS10g on the hard drive:


Then create a new directory for each Zip file you downloaded:


If you plan to burn the files on a CD-ROM, create a separate CD-ROM from the contents of each directory. Do not burn a CD-ROM containing the Zip file itself; you need the unzipped contents of the Zip files to do the installation. When you burn the files to CD-ROM, the contents of each disc must be at the root of the CD image.

To install from CD-ROM or from your hard drive, see Section 5.19, "Starting Oracle Universal Installer".

5.2 Basic Concepts

Oracle Application Server is made up of:

You deploy and run your applications on Oracle Application Server middle tiers. The infrastructure provides services that are used by middle tiers. Infrastructure services can be shared by one or more middle tiers.

When you run the installer, you select whether you want to install the middle tier or the infrastructure. Typically you need both, so you would run the installer twice.

Figure 5-1 shows a simple Oracle Application Server installation. The J2EE and Web Cache middle tier running on computer 1 uses OracleAS Infrastructure running on computer 2. The figure shows the OracleAS Metadata Repository and two Identity Management services (OracleAS Single Sign-On and Oracle Internet Directory).

Figure 5-1 A Middle Tier Using Infrastructure Services

Description of Figure 5-1  follows
Description of "Figure 5-1 A Middle Tier Using Infrastructure Services"

5.3 Order of Installation

In most cases, you must install OracleAS Infrastructure first, because the middle tiers depend on OracleAS Infrastructure services. The one case where the infrastructure is optional is the J2EE and Web Cache middle-tier type. (But see Section 7.4, "Configuration Options for the J2EE and Web Cache Middle Tier")

5.4 Where Do I Install Oracle Application Server?

You can install the middle tiers and the infrastructure on the same computer or on separate computers. You can get better performance if you install the infrastructure on its own computer, and the middle tiers on other computers.

For example, Figure 5-2 shows a topology with four computers:

Refer to Chapter 15, "Recommended Topologies" for topology examples.

Figure 5-2 Configuration with Multiple Middle Tiers and an Infrastructure

Description of Figure 5-2  follows
Description of "Figure 5-2 Configuration with Multiple Middle Tiers and an Infrastructure"


You can install different middle tiers and infrastructure components on different platforms. The only exception is that if you want to cluster multiple J2EE and Web Cache middle tiers, they must be on the same platform. However, the infrastructure for this cluster can still be on a different platform.

5.5 Oracle Home Directory

The directory in which you install Oracle Application Server is called the Oracle home. During installation, you specify the full path to this directory and a name for this Oracle home.

For example, you can install OracleAS Infrastructure in /opt/oracle/OraHome_Infra, and you can name it "Infra".

Names of Oracle homes must be 128 characters or fewer, and can contain only alphanumeric characters and underscores.


Spaces are not allowed anywhere in the Oracle home directory path. For example, you cannot install in "/opt/oracle/app server/Infra" because of the space character in "app server". The installer does not check for this until several screens after you have entered the path.

If you plan to install a middle tier and an infrastructure on the same computer, you must install them in different Oracle home directories. The installer does not allow you to install a middle tier and an infrastructure in the same Oracle home. Section 15.2, "Portal and Wireless Developer Topology" describes a configuration where you install a middle tier and an infrastructure on the same computer.


If you install multiple Oracle Application Server instances (for example, an OracleAS Infrastructure and a middle tier) on the same computer, create scripts for setting the environment for each instance. This is to ensure that you run the binaries from the proper Oracle home. Environment variables that you need to set include ORACLE_HOME and PATH.

5.5.1 Installing in an Existing Oracle Home

Generally, you cannot install Oracle Application Server in an existing Oracle home. Refer to "Oracle home directory" for a list of combinations that are not allowed. Two exceptions to the rule are:

  • You can install Oracle Application Server middle tiers into an existing Oracle home that contains Oracle Developer Suite 10g Release 2 (10.1.2). However, before you install, check that in the file ORACLE_HOME/j2ee/home/config/default-web-site.xml, the protocol is set to "ajp13" (not http), and the port is set to 0 (zero).


    If you choose to install Oracle Application Server in an existing Oracle Developer Suite 10g Release 2 (10.1.2) home, you will lose some Oracle Developer Suite functionality. Specifically, you can no longer access directly the OC4J home instance in Oracle Developer Suite using the hostname:8888 URL.

  • You can install Oracle Application Server middle tier into an existing middle tier if you are expanding it. Refer to Section 7.14, "Expanding a MiddleTier" for details.

5.5.2 Installing in a Non-Empty Oracle Home

You cannot install Oracle Application Server in a directory that already contains some files, except for the cases mentioned in Section 5.5.1, "Installing in an Existing Oracle Home". For example, if you cancel an installation, or if an installation failed, you have to clean up the directory before you can reinstall Oracle Application Server in it. Also, the installer cannot "repair" an installation. Refer to Section G.2.2, "Message About Installing in a Non-Empty Directory" for instructions on how to clean up the directory.

5.6 Can I Use Symbolic Links?

You can create symbolic links before installing Oracle Application Server and use them during installation. For example, if you run the following commands:

mkdir /home/basedir
ln -s /home/linkdir /home/basedir

then, when you run the installer, you can specify /home/linkdir as the Oracle Home.

After installation, you cannot create symbolic links to the Oracle Home. You also may not move the Oracle Home to a different location and create a symbolic link to the original Oracle Home.

5.7 First-Time Installation of Any Oracle Product

If Oracle Application Server is the first Oracle product to be installed on a computer, the installer displays a screen where you specify an inventory directory (also called the oraInventory directory). This inventory directory is used by the installer to keep track of all Oracle products installed on the computer.

The inventory directory is separate from the Oracle home directory for Oracle Application Server.

To ensure other users in the oinstall group have access to the inventory directory (so that they can install Oracle products), do not use the oracle user's home directory as the inventory directory because home directories might not have the proper permissions set up for the oinstall group. Instead, you can put the inventory directory in the /opt/oracle directory (for example, /opt/oracle/oraInventory).

If you have installed an Oracle product previously on the computer, the installer uses the existing inventory directory. Ensure that you have write permissions on that directory. The best way of ensuring this is to run the installer as the same operating system user who installed the existing Oracle products.

Oracle recommends creating an operating system user to perform all tasks related to installation of Oracle products. Refer to Section 4.7, "Operating System User".

5.8 Installing Additional Languages

By default, the installer installs Oracle Application Server with text in English and in the operating system language. If you need additional languages, click the Product Languages button in the "Select a Product to Install" screen.

When you select additional languages to install, the installer installs text in the selected languages. It also installs fonts required to display the languages.

For some components, languages are installed only if you select them during installation. In this case, if you access the application in a language that is not available, it will fall back on the server locale language.

For other components, available languages are installed regardless of what you select during installation. In this case, however, fonts are installed only for the languages that are explicitly selected. When you access the application, it uses text in your language because the language was installed. However, if you do not have the appropriate fonts to render the text, the text appears as square boxes. This usually applies to the Chinese, Japanese, and Korean languages.

You can install fonts after installation. Refer to Section G.2.7, "User Interface Does Not Display in the Desired Language, or Does Not Display Properly".


OracleAS Portal is not supported on the ZHT32EUC database character set used for Traditional Chinese. If your environment supports Traditional Chinese, then the ZHT16MSWIN950, AL32UTF8, or ZHT16BIG5 character set must be used. For details about selecting the character set in the Oracle Universal Installer (OUI), refer to Oracle Application Server Globalization Guide.

Note that you cannot install additional languages after installation. You must install all languages that you need during installation. If you run Oracle Application Server in an environment that uses a language that you did not install, the user interface can display text in that language and/or in English, or it can display square boxes (caused by missing fonts) instead of text.

5.9 Oracle Application Server Instances and Instance Names

When you install the infrastructure or middle tier, what you get is an Oracle Application Server instance. The installer prompts you to provide a name for the Oracle Application Server instance you are installing. For example, you can name an instance "infra" or "J2EE". This name can be different from the Oracle home name.

You cannot change this name after installation.

Oracle Application Server appends the hostname and domain name to the given instance name to form a complete instance name. For example, if you are installing an instance on a computer named c1, and you name the instance infra1, then the full name of the instance is, assuming the domain name is

Valid Characters in Instance Names

Instance names can consist only of the alphanumeric characters (A-Z, a-z, 0-9) and the _ (underscore) character.

The maximum length for an instance name is 64 characters.

Restrictions on Oracle Application Server Instance Names

Do not use the hostname of the computer when naming Oracle Application Server instances.

If you are planning to place the Oracle Application Server instance in an OracleAS Cluster, the instance name must not contain the following:

How Oracle Application Server Uses Instance Names

Instance names are important because Oracle Application Server uses them to uniquely identify instances. This means that if you install multiple Oracle Application Server instances on the same computer (for example, an OracleAS Infrastructure and a J2EE and Web Cache instance), you must give them different names.

When you administer Oracle Application Server using Oracle Enterprise Manager 10g Application Server Control (or Application Server Control for short), the instance name appears on the screens. You can click the instance name to see details about the instance, such as the components that are installed in that instance, if the components are running or stopped, and the log files for the components. The Application Server Control is a browser-based administration tool for Oracle Application Server. Refer to Oracle Application Server Administrator's Guide for details about this administration tool.

In addition, some dcmctl commands require an instance name as a parameter. dcmctl is a command-line tool for administering Oracle Application Server instances. Refer to Distributed Configuration Management Administrator's Guide for details about dcmctl.

5.10 The ias_admin User and Restrictions on its Password

The installer prompts you to specify the password for the ias_admin user. The ias_admin user is the administrative user for Oracle Application Server instances. To manage Oracle Application Server instances using Application Server Control, you log in as ias_admin.

On a computer, you can install multiple Oracle Application Server instances, each with its own unique instance name, but the name of the administrative user is ias_admin for all instances. The password for the ias_admin user can be different for each instance.

Password for the ias_admin User

The password for the ias_admin user must conform to Oracle Internet Directory's password policy:

In addition to the password policy defined in Oracle Internet Directory, the password for the ias_admin user has these restrictions:


When entering your password, check that the state of the Caps Lock key is what you want it to be. Passwords are case-sensitive.

You must remember the password because you need to enter it to perform the following tasks:

If you forget the password, you can reset it. Refer to Oracle Application Server Administrator's Guide for details.

5.11 Comparing Installing Components Against Configuring Components

When you select components on the Select Configuration Options screen, the installer installs and configures the selected components. For the unselected components, the installer still installs them, but does not configure them.

In most cases, you can configure components that you did not select on the Select Configuration Options screen after installation using the Application Server Control. Refer to Oracle Application Server Administrator's Guide for details.

5.12 Installing Oracle9i Application Server Release 2 (9.0.2) on the Same Computer

If you want to install the current release of Oracle Application Server and Oracle9i Application Server Release 2 (9.0.2) on the same computer, make sure you install Release 2 (9.0.2) first.

If you install Oracle9i Application Server Release 2 (9.0.2) Infrastructure after installing the current release of Oracle Application Server Infrastructure, you must disable the Net Listener installed by the 9.0.2 infrastructure. The current version of Net Listener is capable of listening for both the current and previous releases of the database. For information on starting and stopping Net Listener, see Oracle Application Server Administrator's Guide.

For more information on compatibility with earlier releases, see Oracle Application Server Upgrade and Compatibility Guide.


Oracle9i Application Server Release 2 (9.0.2) is no longer supported. Oracle recommends that you upgrade to the latest release of Oracle Application Server.

5.13 Where Does the Installer Write Files?

The installer writes files to the following directories:

Table 5-1 Directories Where the Installer Writes Files

Directory Description

Oracle home directory

This directory contains Oracle Application Server files. You specify this directory when you install Oracle Application Server.

Inventory directory

When you install the first Oracle product on a computer, you specify this directory, which the installer uses to keep track of which Oracle products are installed on the computer. In subsequent installations, the installer uses the same inventory directory.

/etc directory

This directory contains information on locations of Oracle homes on the computer.

If you installed Oracle9iAS Release 2 (9.0.2) on your computer, this directory also contains files that provide information for Oracle Enterprise Manager 10g.

/tmp directory

The installer writes files needed only during installation to a "temporary" directory. By default, the "temporary" directory is /tmp. To specify a different directory, set the TMP environment variable. Refer to Section 4.8.5, "TMP and TMPDIR" for details.

5.14 Why Do I Need to be Able to Log In as Root At Certain Times During Installation?

At least once during installation, the installer prompts you to log in as the root user and run a script. You need to be root because the script edits files in the /etc directory.

5.15 Running During Installation

The installer prompts you to run the script in a separate window. This script creates files in the local bin directory (/usr/local/bin, by default).

If the script finds files of the same name, it prompts you if you want to override the existing files. You should back up these files (you can do this from another window), then overwrite them.

The following lines show the prompts from the script. The default values are enclosed in square brackets.

Enter the full pathname of the local bin directory: [/usr/local/bin]:
The file "dbhome" already exists in /usr/local/bin.  Overwrite it? (y/n)[n]:  y
 Copying dbhome to /usr/local/bin ...
The file "oraenv" already exists in /usr/local/bin.  Overwrite it? (y/n)[n]:  y
 Copying oraenv to /usr/local/bin ...
The file "coraenv" already exists in /usr/local/bin.  Overwrite it? (y/n)[n]: y
 Copying coraenv to /usr/local/bin ...

After you run, you may see warnings that begin with "chmod: WARNING: Corresponding set-ID also disabled..." You may ignore these warnings.

5.16 Can I Modify Other Oracle Application Server Instances During Installation?

During the installation of an Oracle Application Server instance, you should not change the configuration or passwords of other installations in your environment. For example, if there is an OracleAS Infrastructure installation in your environment, you should not modify it during the installation of a middle tier.

5.17 Connecting to Oracle Internet Directory Through SSL Connections

When you install OracleAS Infrastructure or middle tiers, you can specify that Oracle Application Server components connect to Oracle Internet Directory only through SSL connections. On screens where you specify the hostname and port for Oracle Internet Directory, you can select the Use Only SSL Connections With This Oracle Internet Directory option.

Note that Oracle HTTP Server is not set up for SSL connections during installation. If you need Oracle HTTP Server to use SSL, you can set it up after installation. Refer to Oracle HTTP Server Administrator's Guide for details.

5.18 Setting the Mount Point for the CD-ROM or DVD

The Oracle Application Server CD-ROMs are in RockRidge format. The DVD is in DVD format.

To mount the first disc:

  1. Insert Oracle Application Server disc 1 into the disc drive.

  2. Enter a command similar to the following:

    # /usr/sbin/mount -rv cdrfs /dev/cd0 /cdrom

5.19 Starting Oracle Universal Installer

  1. If your computer does not mount CD-ROMs or DVD automatically, you need to set the mount point manually. Refer to Section 5.18, "Setting the Mount Point for the CD-ROMor DVD" for details.

  2. Log in as the oracle user.

  3. If you are installing Oracle Application Server on a multihomed computer, create the ORACLE_HOSTNAME environment variable. Set this variable to point to the hostname of the computer on which you are installing Oracle Application Server.

  4. CD-ROM users: Insert Oracle Application Server Disk 1 into the CD-ROM drive.

    DVD users: Insert the Oracle Application Server DVD into the DVD drive.

  5. Run the Oracle Universal Installer using the command shown after the notes:


    • Be sure you are not logged in as the root user when you start the Oracle Universal Installer. The installer gives an error message if you try to run it as the root user.

    • 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 following cd command changes your current directory to your home directory.


    prompt> cd
    prompt> mount_point/10.1.2disk1/runInstaller


    prompt> cd
    prompt> mount_point/application_server/runInstaller

This launches Oracle Universal Installer through which you install Oracle Application Server.

5.19.1 Running the Script

If you are installing Oracle software on an AIX computer for the first time:

  1. Log in as the root user.

  2. Insert Oracle Application Server Disc 1 into the disc drive.

  3. Enter the following command:

    # mount_point/rootpre/