| Oracle9i Application Server Installation Guide Release 2 (9.0.3) for AIX-Based Systems, HP 9000 Series HP-UX, HP Tru64 UNIX, and Linux Intel Part Number B10225-04 |
|
This chapter describes how to start installing Oracle9i Application Server Release 2 (9.0.3) (Oracle9iAS 9.0.3). The topics include:
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.
| Pre-Install Task | Details |
|---|---|
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 increase the number of supported concurrent users.
| Item | Minimum Requirement |
|---|---|
|
AIX CPUFoot 1 |
All AIX compatible processors (64-bit) |
|
HP 9000 Series HP-UX CPU |
HP 9000 Series HP-UX processor for HP-UX 11.0 (64-bit) |
|
Linux CPU |
Pentium II 233 MHZ or better (32-bit) |
|
Tru64 CPU |
Alpha Processor (64-bit) |
|
Memory |
512 MB |
|
Disk spaceFoot 2 for AIX |
1 GB |
|
Disk space for HP-UX |
800 MB |
|
Disk space for Linux |
800 MB |
|
Disk space for Tru64 |
1 GB |
|
TMP or swap space |
256MB |
|
MonitorFoot 3 |
256 color viewing capability |
| 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 |
Oracle9iAS 9.0.3 does not support the following network configurations and scenarios:
For the latest information, refer to OracleMetaLink:
http://metalink.oracle.com
If your system does not meet the requirements in this section, download the operating system patches for AIX-Based Systems, HP 9000 Series HP-UX, HP Tru64 UNIX, and Linux Intel from the vendor web sites.
| Item | Requirement |
|---|---|
|
Operating System |
IBM AIX 4.3.3 (64-bit only) |
|
Software |
This efix is required for any JDK 1.3.1 version earlier than
ftp://service.software.ibm.com/aix/efixes/iy34722
Refer to the README file included with this efix for more information. |
|
Operating System patches for AIX 4.3.3 |
ML10 |
|
Window Manager |
Use any supported IBM AIX window manager that supports Motif, such as |
|
Required Executables |
The following executables must be present: |
| Item | Requirement |
|---|---|
|
Operating System |
IBM AIX 5L |
|
Software |
This efix is required for any JDK 1.3.1 version earlier than
ftp://service.software.ibm.com/aix/efixes/iy34722
Refer to the README file included with this efix for more information. |
|
Operating System patches for AIX 5L |
AIX 5L release 5.1 ML01+ (IY22854), IY26778, IY28766, IY28949, IY29965, IY30150 |
|
Window Manager |
Use any supported IBM AIX window manager that supports Motif, such as |
|
Required Executables |
The following executables must be present: |
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:
Review and complete the following preinstallation tasks before installing Oracle9iAS 9.0.3:
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
Oracle Corporation recommends setting the following ulimit parameters before installation:
| Parameter | Recommended Value |
|---|---|
|
time |
unlimited |
|
file |
unlimited |
|
data |
2097152 |
|
stack |
32768 |
|
memory |
2045680 |
|
coredump |
unlimited |
|
nofiles |
4096 |
|
vmemory |
4194304 |
On Linux, Oracle Corporation recommends setting the swap file size to 3 times the size of RAM before installation.
The following UNIX account and groups are required for the installation process:
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.
The oracle account is the UNIX account that owns Oracle software for the system. You must run Oracle Universal Installer from this account.
Create an oracle account with the properties listed in Table 2-9.
Verify the requirements for the following environment variables before starting Oracle Universal Installer:
Oracle home is the directory in which Oracle software is installed.
Oracle homes are identified by name. The Oracle home name identifies the programs associated with a specific Oracle home and the installed Oracle services associated with the home.
Your Oracle home name must not contain spaces and must not be longer than 127 characters.
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 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:
|
There are limits to the length of the values of the CLASSPATH variable with JDK. If the Oracle home path is long and there are many wrapper.classpath entries in the jserv.conf file, it might cause problems with the jserv process. The workaround is to shorten the Oracle home path.
Make sure the ORACLE_HOME environment variable points to an absolute path directory. That is, make sure there are no symbolic links in the path.
Oracle Management Server (OMS) has known issues with failures in starting services if the value of ORACLE_HOME exceeds a certain length.
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:
This article contains applications-specific X server requirements and configuration information. |
|
See Also:
|
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.
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 |
|
|
Bourne or |
|
|
|
1
Host is the hostname or IP address of the workstation on which you want to display the installer. |
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 and TMPDIR environment variable to locate the temporary directory. If the TMP environment variable is not set, then the installer uses the /tmp directory. If the TMPDIR environment variable is not set, then the installer uses the /var/tmp directory. Set the TMP and TMPDIR environment variable using the following commands.
| C shell | Bourne/Korn shell |
|---|---|
|
|
|
|
$TNS_ADMIN is the directory where Net configuration files are stored.
If TNS_ADMIN is set on your system, that directory setting conflicts with the directory where the Oracle9iAS 9.0.3 Net configuration files are created. Conflicts occur 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 |
|---|---|
|
|
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
Make sure the following entry exists in the /etc/hosts file:
127.0.0.1 loopback localhost
After you have properly configured the hostname information, reboot your computer before starting Oracle9iAS 9.0.3 installation.
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:
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 = 7777Oracle HTTP Server SSL port = 4443Oracle HTTP Server listen port = 7778Oracle HTTP Server SSL listen port = 4444Oracle HTTP Server Jserv port = 8007Enterprise Manager Servlet port = 1810
You can also view the port numbers by using a browser to navigate to the Oracle9iAS Welcome page and selecting the Ports tab.
|
See Also:
|
If you are installing on HP 9000 Series HP-UX, you must manually create some symbolic links before performing the installation. This is due to a known HP-UX problem, Doc. ID. KBRC00003627. To create the required links:
root.
/usr/lib directory:
# cd /usr/lib
# ln -s /usr/lib/libX11.3 libX11.sl # ln -s /usr/lib/libXIE.2 libXIE.sl # ln -s /usr/lib/libXext.3 libXext.sl # ln -s /usr/lib/libXhp11.3 libXhp11.sl # ln -s /usr/lib/libXi.3 libXi.sl # ln -s /usr/lib/libXm.4 libXm.sl # ln -s /usr/lib/libXp.2 libXp.sl # ln -s /usr/lib/libXt.3 libXt.sl # ln -s /usr/lib/libXtst.2 libXtst.sl
On HP Tru64 systems, the group ID of a directory is the same as that of the parent directory (if the parent is not root) and is not controlled by the active group of the current user.
Oracle Corporation recommends that you set the active group of the oracle user to be the same as the group ID of the $ORACLE_HOME directory. If you do not set the active group as recommended above, the Web Cache Configuration Assistant might fail.
Make sure the /etc/sysconfigtab file contains the following lines:
vm: new_wire_method = 0 vfs: fifo_do_adaptive defaults = 0
If you are installing Oracle9iAS on Red Hat Linux, create a link from the /sbin/fuser file to /bin/fuser. This is required to successfully detect whether Oracle Enterprise Manager is running during second and subsequent installations on the same machine.
On Linux, port number 389 is reserved in the /etc/services file. If you want Oracle9iAS to install using the default port number for Oracle Internet Directory, delete the entries in the /etc/services file.
Avoid using the newgrp command on Linux Intel before installation to change the primary group. If you use newgrp before installation, the Web Cache Configuration Assistant might fail to start Web Cache after installation is complete. Using newgrp before installation creates a mismatch between the group identifier in the webcache.xml file (the primary group id) and the group identifier of the installed files (the changed group id).
If you must use the newgrp command, complete the task described in "Correcting Errors Created by Using newgrp Command on Linux Intel" after installation.
If you install Oracle9iAS 9.0.3 using Oracle9iAS 9.0.2.0.1 Infrastructure running on AIX 4.3.3, you will encounter problems while adding Oracle9iAS 9.0.3 J2EE instances to clusters. To fix this issue, install the patch located in the following patch directory on the Oracle9iAS 9.0.3 CD-ROM.
CD_Mount_Point/patch/2640377
To install the patch, follow the instructions in the README file located in the patch directory.
This section describes how Oracle9iAS 9.0.3 uses Oracle Universal Installer for installation. It includes the following topics:
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:
The Oracle Universal Installer automatically checks your computer prior to installation to verify that your system meets operational requirements. Table 2-10 lists the prerequisite checks that are performed.
| Prerequisite Checks | See Also |
|---|---|
|
Check for enough disk space for Oracle home installation |
|
|
Check for TMP and TMPDIR variable and sufficient swap space |
|
|
Check that the install host has enough RAM |
Table 2-3, "Oracle9iAS 9.0.3 Requirements and Recommendation" |
|
Check the |
|
|
Prohibit installation of Oracle9iAS 9.0.3 into an existing Oracle home |
|
|
Check operating system version |
|
|
Ensure that the value of ORACLE_HOME does not contain spaces or is longer than 127 characters |
|
|
Verify the monitor has 256 color viewing capability |
|
|
Verify operational requirements of the CPU |
|
|
Port detection and resolution |
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 fails.
The location of oraInventory is defined in the oraInst.loc file.
Table 2-11 lists the location of the oraInst.loc files for each platform:
| Platform | Location |
|---|---|
|
AIX-Based Systems |
|
|
HP 9000 Series HP-UX |
|
|
Linux Intel |
|
|
HP Tru64 UNIX |
|
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.
This section describes how to mount the Installation CD-ROM for various operating systems:
Mount Disk 1 to begin the installation. Mount the subsequent disk or disks when prompted to do so. Follow these steps to mount the Oracle9iAS 9.0.3 CD-ROM manually:
root user and create a CD-ROM mount point directory, if one does not already exist, by using the following commands:
$ su root # mkdir cdrom_mount_point_directory
# lsdev -Cc cdrom
The output should be similar to the following:
cd0 Available 10-60-00-4, 0 SCSI Multimedia CD-ROM Drive
# mount options device_name cdrom_mount_point_directory
root account:
# exit
Example 2-1 shows how to mount the CD-ROM manually.
$ su root # mkdir /cdrom # mount -rv cdrfs /dev/cd0 /cdrom # exit
In the preceding output, /dev/cd0 is the CD-ROM device and /cdrom is the mount point.
Mount Disk 1 to begin the installation. Mount the subsequent disk or disks when prompted to do so. Follow these steps to mount the Oracle9iAS 9.0.3 CD-ROM manually:
root user and create a CD-ROM mount point directory, if one does not already exist, by using the following commands:
$ su root # mkdir cdrom_mount_point_directory
$ ioscan -fun -C disk
The output should be similar to the following:
disk 10 10/12/5.2.0 sdisk CLAIMED DEVICE TOSHIBA CD-ROM XM-5701TA /dev/dsk/c4t2d0 /dev/rdsk/c4t2d0
/etc/pfs_fstab file for your CD-ROM device, you must add one. As the root user, use a system editor to add a line, in the following format, to the /etc/pfs_fstab file:
device_file mount_point filesystem_type translation_method
In the preceding format, the first entry is the CD-ROM device, the second entry is the mount point, and the third entry indicates that the CD-ROM to be mounted is in ISO9660 format with Rockridge extensions.
The device_file in this example is /dev/dsk/c4t2d0. For a CD-ROM device with the path /dev/dsk/c4t2d0, you would enter the following:
/dev/dsk/c4t2d0 /SD_CDROM pfs-rrip xlat=unix 1 0
root user with the following command:
$ su root
# nohup /usr/sbin/pfs_mountd & # nohup /usr/sbin/pfsd &
# /usr/sbin/pfs_mount /SD_CDROM
# exit
If you run the Installer while the current working directory is the CD-ROM directory, follow these steps to mount the next CD-ROM:
root user:
$ cd / $ su root
# /usr/sbin/pfs_umount /SD_CDROM
# /usr/sbin/pfs_mount /SD_CDROM
Mount Disk 1 to begin the installation. Mount the subsequent disk or disks when prompted to do so.
If you are using auto mounting software, the CD-ROM is mounted automatically to the directory specified in your auto mount configuration when you insert it into the CD-ROM drive.
To check whether you have auto mounting software, enter the following command:
$ ps -aux | grep automount
If you have auto mounting software, the output must be similar to the following:
root 628 0.0 0.2 1148 588 ? S 17:32 0:00 /usr/sbin/automount /misc file /etc/auto.misc
In the preceding output, the /etc/auto.misc section defines the directory under the /misc file where the CD-ROM will be mounted.
Follow these steps to mount subsequent CD-ROMs:
$ cd / $ eject
To mount the Oracle9iAS 9.0.3 CD-ROM manually, use the following steps:
root user and, if necessary, create a CD-ROM mount point directory by using the following commands:
$ su root # mkdir cdrom_mount_point_directory
# mount options device_name cdrom_mount_point_directory
root account.
# exit
If you are unsure of the correct device name, consult your system administrator. Typically, the device name is /dev/cdrom.
Example 2-2 shows how to mount the CD-ROM manually.
$ su root # mkdir /cdrom # mount -t iso9660 /dev/cdrom /cdrom # exit
If you run the Installer while the current working directory is the CD-ROM directory, follow these steps to mount the next CD-ROM:
root user by using the following commands:
$ cd / $ su root
# umount cdrom_mount_point_directory
Follow these steps to mount the Oracle9iAS 9.0.3 CD-ROM manually:
root user and create a CD-ROM mount point directory, if one does not already exist, by using the following commands:
$ su root # mkdir cdrom_mount_point_directory
$ ls /dev/disk/cdrom*c
The command should return a line similar to the following:
/dev/disk/cdrom0c
# mount options device_name cdrom_mount_point_directory
root account.
# exit
Example 2-3 shows how to mount the CD-ROM manually.
$ su root # mkdir /cdrom # mount -t cdfs -r -o nodefperm,noversion,rrip /dev/disk/cdrom0c /cdrom # exit
If you run the Installer while the current working directory is the CD-ROM directory, follow these steps to mount the next CD-ROM:
root user by using the following commands:
$ cd / $ su root
# umount cdrom_mount_point_directory
Follow these steps to start Oracle Universal Installer and install Oracle9iAS 9.0.3:
oracle user.
prompt>mount_point/9ias_903disk1/runInstaller
This launches Oracle Universal Installer through which you can install Oracle9iAS 9.0.3.
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:
Oracle recommends reviewing the installation sequence for a better understanding of the Oracle9iAS 9.0.3 installation process.
The following screens appear during installation of Oracle9iAS 9.0.3:
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.
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.
ias_admin user's password created from the previous installation.
After the installer finishes, you must perform the tasks in Section 3.2, "Postinstallation" to complete your Oracle9iAS 9.0.3 installation.
Note:
Please review the following installation considerations for Oracle9iAS 9.0.3:
If you want to use 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.
During installation, you are prompted for the iAS instance name, and password. If you enter the incorrect password on HP-UX and an active Enterprise Manager (EMD) home location is already present in the /etc/emtab file, the Oracle Universal Installer will hang and will not respond.
To continue the installation, you need to exit or kill the installer process and start the installer again.
Oracle recommends reviewing the following before performing additional Oracle9iAS 9.0.3 installations on the same host:
/var/opt/oracle directory for subsequent Oracle9iAS 9.0.3 installations.
URL not found errors.
|
|
![]() Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|