|Oracle® Application Server Installation Guide
10g (10.1.4.0.1) for IBM zSeries Based Linux
Part Number B32085-01
This chapter contains the following sections:
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.
Notes:Spaces are not allowed anywhere in the Oracle home directory path. For example, you cannot install in "
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.
Tip: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.
Generally, you cannot install Oracle Application Server in an existing Oracle home. See "Oracle home directory" for a list of combinations that are not allowed.
You cannot install Oracle Application Server in a directory that already contains some files, except for the cases mentioned in Section 3.1.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. See Section F.3.4, "Message About Installing in a Non-Empty Directory" for instructions on how to clean up the directory.
You can create symbolic links before installing Oracle Application Server and use them during installation. For example, if you run the following commands:
prompt> mkdir /home/basedir prompt> ln -s /home/basedir /home/linkdir
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.
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,
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. See Section 2.8, "Operating System User".
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. See Section F.3.10, "User Interface Does Not Display in the Desired Language, or Does Not Display Properly".
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.
When you install the infrastructure, 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". 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
infra1.c1.mydomain.com, assuming the domain name is
Instance names can consist only of the alphanumeric characters (
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:
hostname or IP address of any computer in the OracleAS Cluster
Oracle home of any Oracle Application Server installation in the OracleAS Cluster
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. See the 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. See the Distributed Configuration Management Administrator's Guide for details about
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
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:
If you are using the Oracle Internet Directory that is shipped with this release of Oracle Application Server and you did not change the default password policy, passwords have the following restrictions:
The minimum length is five alphanumeric characters.
At least one of the characters must be a number.
If you are using any other version of Oracle Internet Directory (for example, you are using an existing Oracle Internet Directory), your Oracle Internet Directory administrator might have defined a different password policy. The password you enter for the
ias_admin user must conform to the existing 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:
Passwords must be shorter than 30 characters.
Passwords can contain only alphanumeric characters from your database character set, the underscore (
_), the dollar sign (
$), and the number sign (
Passwords must begin with an alphabetic character. Passwords cannot begin with a number, the underscore (
_), the dollar sign (
$), or the number sign (
Passwords cannot be Oracle reserved words. The Oracle Database SQL Reference lists the reserved words. You can find this guide on Oracle Technology Network (
http://www.oracle.com/technology/documentation). Or you can just avoid using words that sound like they might be reserved words.
Note: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:
When you log on to Application Server Control to manage Oracle Application Server, you log on as the
For middle-tier installations: if you want to install a larger middle tier in an ORACLE_HOME that already contains a middle tier (for example, you want to install the Portal and Wireless type over an existing J2EE and Web Cache type), you must enter the existing password during the installation.
If you forget the password, you can reset it. See the Oracle Application Server Administrator's Guide for details.
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. See the Oracle Application Server Administrator's Guide for details.
The installer writes files to the following directories:
Table 3-1 Directories Where the Installer Writes Files
Oracle home directory
This directory contains Oracle Application Server files. You specify this directory when you install Oracle Application Server.
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.
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.
The installer writes files needed only during installation to a "temporary" directory. By default, the "temporary" directory is
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
The installer prompts you to run the
root.sh 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
root.sh 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
root.sh, you may see warnings that begin with "chmod: WARNING: Corresponding set-ID also disabled..." You may ignore these warnings.
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.
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. See the Oracle HTTP Server Administrator's Guide for details.
You can obtain Oracle products from Oracle E-Delivery at
http://edelivery.oracle.com/. 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-ROM.
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.
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.
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.
All Oracle E-Delivery files have been archived using Info-ZIP's highly portable Zip utility. After downloading one or more of the archives, you will need the UnZip utility to extract the files.You must unzip the archive on the platform for which it was intended. For example, if you download the file for the Solaris Operating System (SPARC) version of Oracle Application Server, you must unzip the file on a Solaris Operating System (SPARC) computer. If you unzip the file on a Windows computer, and then move the stage area to a Solaris Operating System (SPARC) machine, the stage area files will be corrupted because Windows will not preserve the case sensitivity or the permission bits of UNIX file names.
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 structure called oraAS10g on your hard drive:
Then create a new directory for each Zip file you downloaded:
If you plan 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 3.15, "Starting theOracle Universal Installer".
On most Linux systems, the disk mounts automatically when you insert it into the disk drive. To mount the first disk, follow these steps:
Insert Oracle Application Server disk 1 into the disk drive.
To verify that the disk mounted automatically, enter the following command:
# ls /mnt/cdrom
SUSE Linux Enterprise Server:
# ls /media/cdrom
If the command in step 2 fails to display the contents of the disk, enter the following command:
# mount -t iso9660 /dev/cdrom /mnt/cdrom
SUSE Linux Enterprise Server:
# mount -t iso9660 /dev/cdrom /media/cdrom
If you are installing from a CD-ROM or DVD-ROM and your computer does not mount CD-ROMs or DVDs automatically, you need to set the mount point manually. See Section 3.14, "Setting the Mount Point for the CD-ROMor DVD-ROM" for details.
Log in as the
If you are installing Oracle Application Server on a multihomed computer, create the
OUI_HOSTNAME environment variable. Set this variable to point to the hostname of the computer on which you are installing Oracle Application Server.
If you are installing from your hard drive, go to the next step.
CD-ROM users: Insert Oracle Application Server Disk 1 into the CD-ROM drive.
DVD-ROM users: Insert the Oracle Application Server DVD-ROM into the DVD-ROM drive.
Run the Oracle Universal Installer using the command shown after the notes:
prompt> cd prompt> mount_point/10.1.4disk1/runInstaller
prompt> cd prompt> mount_point/application_server/runInstaller
prompt> cd disk1_directory prompt> runInstaller
where disk1_directory is the directory where you unzipped the Disk 1 file.
This launches Oracle Universal Installer, through which you install Oracle Application Server.