|
Oracle® Application Server Installing and Getting Started with Standard Edition One
10g Release 2 (10.1.2) for Linux x86 B16043-02 |
|
![]() Previous |
![]() Next |
This chapter lists the requirements for installing and running Oracle Application Server Standard Edition One. It covers the following sections:
Table 2-1 lists the hardware requirements for running Oracle Application Server Standard Edition One. The installer checks many of these requirements at the start of the installation process and warns you if any of them is not met. To save time, you can manually check only the ones that are not checked by the installer. Refer to the appropriate table to view which requirements are not checked by the installer.
You can also run the system checks performed by the installer without doing an installation, by running the runInstaller command as shown. The runInstaller command is on the Oracle Application Server CD-ROM (Disk 1) or DVD (in the application_server directory).
CD-ROM:
prompt> mount_point/1012disk1/runInstaller -executeSysPrereqs
DVD:
prompt> mount_point/application_server/runInstaller -executeSysPrereqs
Table 2-1 Hardware Requirements for Linux Systems
| Item | Minimum Requirements | Checked by Installer |
|---|---|---|
| Processor type | Pentium (32-bit) | No |
| Processor speed | 450 MHz or faster | Yes |
| Network | You can install Oracle Application Server on a standalone computer that is not connected to a network. If you change the network configuration later, then refer to the Oracle Application Server Administrator's Guide for information about reconfiguring Oracle Application Server. | No |
| IP | The computer's IP address can be static or allocated using DHCP. If you later change the IP configuration, then refer to Oracle Application Server Administrator's Guide for information about reconfiguring Oracle Application Server. | No |
| Memory | The memory requirements provided for the various installation types represents enough physical memory to install and run Oracle Application Server. However, for most production sites, you should configure at least 1 GB of physical memory. For sites with substantial traffic, increasing the amount of memory further may improve your performance. For Java applications, you should either increase the maximum heap allocated to the OC4J processes, or configure additional OC4J processes to utilize this memory. Refer to Oracle Application Server Performance Guide for details.
In determining the optimal amount of memory for your installation, the best practice is to load test your site. Resource requirements can vary substantially for different applications and different usage patterns. In addition, some operating system utilities for monitoring memory can overstate memory usage (partially due to the representation of 7shared memory). The preferred method for determining memory requirements is to monitor the improvement in performance resulting from the addition of physical memory in your load test. Refer to your platform vendor documentation for information about how to configure memory and processor resources for testing purposes. Oracle Application Server 10g Release 2 (10.1.2.0.1): 1 GB To determine the amount of memory, enter the following command: # grep MemTotal /proc/meminfo |
Yes |
| Disk space | OracleAS Infrastructure, J2EE, and WebCache with Portal: 4 GB
The installer may display inaccurate disk space requirement figures. Refer to the figures listed for disk space requirements. To determine the amount of free disk space, use the
Replace |
No |
Space in the /tmp directory
|
400 MB
To determine the amount of free disk space in the
If the |
Yes |
| Swap space | 1.5 GB of available swap space
To determine the amount of available swap space, enter the following command: # grep SwapTotal /proc/meminfo Refer to the operating system documentation for information about how to configure additional swap space. |
Yes |
| Monitor | 256 color display
To determine the display capabilities of the monitor, run the following command: prompt>
Look for the |
Yes |
Depending on your distribution of Linux, refer to one of the following sections for information about checking the software requirements:
Section 2.2.1, "Software Requirements for Red Hat Enterprise Linux AS/ES 2.1 Systems"
Section 2.2.2, "Software Requirements for Red Hat Enterprise Linux AS/ES 3.0 Systems"
Section 2.2.3, "Software Requirements for SUSE Linux Enterprise Server 8 Systems"
Section 2.2.4, "Software Requirements for SUSE Linux Enterprise Server 9 Systems"
Oracle does not support customized kernels or modules not supported by the Linux vendor.
You can install Oracle Application Server 10g Release 2 (10.1.2) on a Linux system that is not on a network, and you can install Oracle Application Server 10g Release 2 (10.1.2) on a Linux computer that is configured to use DHCP. If you want to install Oracle Application Server on a computer that is not on a network, then you must configure the computer to use either a static IP address or a loopback IP address. Configure the computer to resolve the host name of the computer to either a static IP address or a loopback IP address.
Table 2-2 lists the software requirements for Red Hat Enterprise Linux AS/ES 2.1 systems and the procedure that follows the table describes how to ensure that your computer meets these requirements and any additional requirements for installing Oracle Application Server.
|
Note: Oracle Application Server 10g Release 2 (10.1.2) is certified with the following operating system specific software. For the most current list of supported operating system specific software, for example JDK version, operating system version, check OracleMetaLink at |
Table 2-2 Software Requirements for Red Hat Enterprise Linux AS/ES 2.1 Systems
| Item | Description |
|---|---|
| Operating System | Red Hat Enterprise Linux AS/ES 2.1 For more information about Red Hat, refer to |
| Red Hat Update | Update 5 |
| Red Hat Patches | Errata 49 kernel or a higher errata patch approved by Red Hat For example, one of the following, depending on the type of Red Hat installation:
|
| Software packages
(check that these versions or higher versions are installed) |
glibc-2.2.4-32.17 glibc-common-2.2.4-32.17 gcc-2.96-128.7.2 gcc-c++-2.96-128.7.2 pdksh-5.2.14-22 openmotif-2.1.30-12 sysstat-4.0.1-15.2.1as compat-glibc-6.2-2.1.3.2 compat-libstdc++-6.2-2.9.0.16 libstdc++-2.96-128.7.2 gnome-libs-1.2.13-16 binutils-2.11.90.0.8-12.4 make-3.79.1-8 db1-1.85-7 db3-3.3.11-5 |
To ensure that the system meets all the requirements:
Log in as the root user.
To determine which distribution and version of Linux is installed, enter the following command:
# cat /etc/issue Red Hat Linux Advanced Server release 2.1AS/\m (Pensacola)
|
Note: Red Hat Enterprise Linux AS/ES 2.1, 3.0 and SUSE Linux Enterprise Server 8 and 9 are certified and supported. For the most current list of supported Linux operating systems, check OracleMetaLinkhttp://metalink.oracle.com
|
To check that Update 5 is installed:
# cat /etc/redhat-release Red Hat Linux Advanced Server release 2.1AS/\m (Pensacola Update 5)
If Update 5 is installed, then errata 49 is installed and all the required software packages are installed.
To determine which version of the Linux kernel is installed, enter the following command:
# uname -r kernel-smp-2.4.9-e.49
In this example, the version shown is 2.4.9 with errata 49. Refer to the operating system documentation for information about upgrading the kernel if necessary.
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, then download and install it using the following command:
# rpm -i package_name
When installing a package, ensure that you are using the correct architecture and optimization rpm file. To check the architecture of an rpm file, run the following command:
# rpm -q package_name --queryformat "%{arch}\n"
In the following example, the glibc rpm file is suitable for an Intel architecture
# rpm -q glibc --queryformat "%{arch}\n"
i686
Table 2-3 lists the software requirements for Red Hat Enterprise Linux AS/ES 3.0 systems and the procedure that follows the table describes how to ensure that your computer meets these requirements and any additional requirements for installing Oracle Application Server Standard Edition One.
|
Note: Oracle Application Server 10g Release 2 (10.1.2) is certified with the following operating system specific software. For the most current list of supported operating system specific software, for example JDK version, operating system version, check OracleMetaLink at |
Table 2-3 Software Requirements for Red Hat Enterprise Linux AS/ES 3.0 Systems
| Item | Description |
|---|---|
| Operating System | Red Hat Enterprise Linux AS/ES 3.0 For more information about Red Hat, refer to http://www.redhat.com
|
| Red Hat Update | Update 3 |
| Red Hat Patches | One of the following, depending on the type of Red Hat installation:
|
| Software packages
(check that these versions or higher versions are installed) |
glibc-2.3.2-95.27 glibc-common-2.3.2-95.27 binutils-2.14.90.0.4-35 compat-glibc-7.x-2.2.4.32.6 compat-libstdc++-7.3-2.96.128 compat-libstdc++-devel-7.3-2.96.128 gcc-3.2.3-42 gcc-c++-3.2.3-42 libstdc++-3.2.3-42 libstdc++-devel-3.2.3-42 openmotif21-2.1.30-8 pdksh-5.2.14-21 setarch-1.3-1 make-3.79.1-17 gnome-libs-1.4.1.2.90-34.1 sysstat-4.0.7-4.EL3.3 compat-db-4.0.14-5 control-center-2.2.0.1-13.i386.rpm xscreensaver-4.10-8.i386.rpmNote: For Red Hat Enterprise Linux AS/ES 3.0, the equivalent version of openmotif 2.1.30-8 is openmotif21-2.1.30-8. The openmotif 21-2.1.30-8 package can be installed from disk number 3 of the Red Hat Enterprise Linux AS/ES 3.0 distribution by entering: $ rpm -ivh openmotif21-2.1.30-8 |
To ensure that the system meets all the requirements:
Log in as the root user.
To determine which distribution and version of Linux is installed, enter the following command:
# cat /etc/issue Red Hat Linux Advanced Server release 3 (Taroon)
|
Note: Red Hat Enterprise Linux AS/ES 2.1, 3.0 and SUSE Linux Enterprise Server 8 and 9 are certified and supported. For the most current list of supported Linux operating systems, check OracleMetaLinkhttp://metalink.oracle.com.
|
To check that Update 3 is installed:
# cat /etc/redhat-release Red Hat Enterprise Linux AS release 3 (Taroon Update 3)
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, then download it and install it using the following command:
# rpm -i package_name
When installing a package, ensure that you use the correct architecture and optimization rpm file. To check the architecture of an rpm file, run the following command:
# rpm -q package_name --queryformat "%{arch}\n"
In the following example, the glibc rpm file is suitable for an Intel architecture
# rpm -q glibc --queryformat "%{arch}\n"
i686
If the hugemem kernel is used, then set the architecture using the following command:
prompt> setarch i386
Table 2-4 lists the software requirements for SUSE Linux Enterprise Server 8 systems and the procedure that follows the table describes how to ensure that your system meets these requirements and any additional requirements for installing Oracle Application Server.
|
Note: Oracle Application Server 10g Release 2 (10.1.2) is certified with the following operating system specific software. For the most current list of supported operating system specific software, for example JDK version, operating system version, check OracleMetaLink (http://metalink.oracle.com).
|
Table 2-4 Software Requirements for Red Hat Enterprise Linux AS/ES 2.1 Systems
| Item | Requirements |
|---|---|
| Operating System | SUSE Linux Enterprise Server 8
For more information about SUSE Linux Enterprise Server, refer to SP3 is certified for Oracle Application Server 10g Release 2 (10.1.2). For SUSE Linux Enterprise Server 8 SP3, the minimum supported kernel versions are:
|
| Software Packages
(check that these versions or higher versions are installed) |
glibc-2.2.2-124 gcc-3.2.2-38 gcc-c++-3.2.2-38 pdksh-5.2.14 openmotif-2.1.30MLI4 sysstat-4.0.3 libstdc++-3.2.2 make-3.79.1-407 binutils-2.12.90.0.15-50 compat-2003.1.10-0 |
To ensure that the system meets all the requirements:
Log in as the root user.
To determine which distribution and version of Linux is installed, enter the following command:
# cat /etc/issue Welcome to SUSE Linux Enterprise Server 8 (i586) - Kernel \r (\l)
|
Note: Red Hat Enterprise Linux AS/ES 2.1, 3.0 and SUSE Linux Enterprise Server 8 and 9 are certified and supported. For the most current list of supported Linux operating systems, check OracleMetaLink athttp://metalink.oracle.com.
|
To determine the service pack version, enter the following command:
# uname -r k_smp-2.4.21-138
If the kernel version contains the string 2.4.21, then SP3 is installed. SP3 is certified for Oracle Application Server 10g Release 2 (10.1.2).
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, then download it and install it using the following command:
# rpm -i package_name
When installing a package, ensure that you are using the correct architecture and optimization rpm file. To check the architecture of an rpm file, run the following command:
# rpm -q package_name --queryformat "%{arch}\n"
In the following example, the glibc rpm file is suitable for an Intel architecture
# rpm -q glibc --queryformat "%{arch}\n"
i686
Create the following symbolic link for the Perl executable if it does not already exist:
# ln -sf /usr/bin/perl /usr/local/bin/perl
Create the following symbolic link for the fuser executable if it does not already exist:
# ln -sf /bin/fuser /sbin/fuser
If the orarun package was installed on a SUSE Linux Enterprise Server system, then complete the following steps as the oracle user to reset the environment:
Enter the following commands:
prompt>cd /etc/profile.dprompt>mv oracle.csh oracle.csh.bakprompt>mv oracle.sh oracle.sh.bakprompt>mv alljava.sh alljava.sh.bakprompt>mv alljava.csh alljava.csh.bak
Use any text editor to comment out the following line from the $HOME/.profile file:
. ./.oracle
Log out of the oracle user account.
Log in to the oracle user account for the changes to take effect.
If any Java packages are installed on the system, then unset the Java environment variables, for example JAVA_HOME.
|
Note: Oracle recommends that you do not install any of the Java packages supplied with the SUSE Linux Enterprise Server distribution. |
Check the /etc/services file to ensure that the following port ranges are available on the computer:
ports 3060-3129 required for Oracle Internet Directory
ports 3130-3199 required for Oracle Internet Directory (SSL)
ports 1812-1829 required for Oracle Enterprise Manager (console)
ports 1830-1849 required for Oracle Enterprise Manager (agent)
ports 1850-1869 required for Oracle Enterprise Manager (RMI)
Remove entries from the /etc/services file and restart the computer, if necessary. To remove the entries, you can use the perl script included in the utils/3167528/ directory of CD-ROM Disk 1 or in the application_server/utils/3167528/ directory on the DVD. Run the script as the root user. This script is also available as patch 3167528. This patch is available at
If these ports are not available, then the associated configuration assistants will fail during the installation.
If you use Network Information Service (NIS):
Ensure that the following line exists in the /etc/yp.conf file:
hostname.domainname broadcast
Ensure that the following line exists in the /etc/nsswitch.conf file:
hosts: files nis dns
Ensure that the localhost entry in the /etc/hosts file is an IPv4 entry. If the IP entry for localhost is in IPv6 format, installation cannot succeed. The following example shows an IPv6 entry:
# special IPv6 addresses ::1 localhost ipv6-localhost ipv6-loopback ::1 ipv6-localhost ipv6-loopback
To correct this example /etc/hosts file, comment the localhost entry as follows:
# special IPv6 addresses # ::1 localhost ipv6-localhost ipv6-loopback ::1 ipv6-localhost ipv6-loopback
To comment the entries, you can use the perl script included in the utils/4015045/ directory of CD-ROM Disk 1 and in the application_server/utils/4015045/ directory on the DVD. Run the script as the root user. This script is also available as patch 4015045. This patch is available at
Table 2-5 lists the software requirements for SUSE Linux Enterprise Server 9 systems and the procedure that follows the table describes how to ensure that your system meets these requirements and any additional requirements for installing Oracle Application Server.
|
Note: Oracle Application Server 10g Release 2 (10.1.2) is certified with the following operating system specific software. For the most current list of supported operating system specific software, for example JDK version, operating system version, check OracleMetaLink (http://metalink.oracle.com).
|
Table 2-5 Software Requirements for SUSE Linux Enterprise Server 9 Systems
| Item | Description |
|---|---|
| Operating System | SUSE Linux Enterprise Server 9
For more information about SUSE Linux Enterprise Server, refer to For SUSE Linux Enterprise Server 9, the minimum supported kernel versions are:
|
| Software Packages
(check that these versions or higher versions are installed) |
glibc-2.3.3-98.28 gcc-3.3.3-43.24 gcc-c++-3.3.3-43.24 libstdc++-3.3.3-43.24 libstdc++-devel-3.3.3-43.24 openmotif21-libs-2.1.30MLI4-119.1 pdksh-5.2.14-780.1 make-3.80-184.1 gnome-libs-1.4.1.7-671.1 gnome-libs-devel-1.4.1.7-671.1 sysstat-5.0.1-35.1 binutils-2.15.90.0.1.1-32.5 db1-1.85-85.1 compat-2004.7.1-1.2 |
To ensure that the system meets all the requirements:
Log in as the root user.
To determine which distribution and version of Linux is installed, enter the following command:
# cat /etc/issue Welcome to SUSE Linux Enterprise Server 9 (i686) - Kernel \r (\l)
|
Note: Red Hat Enterprise Linux AS/ES 2.1, 3.0 and SUSE Linux Enterprise Server 8 and 9 are certified and supported. For the most current list of supported Linux operating systems, check OracleMetaLink athttp://metalink.oracle.com.
|
To determine the service pack version, enter the following command:
# uname -r kernel-bigsmp-2.6.5-7.97
If the kernel version contains the string 2.4.21, then SP3 is installed. SP3 is certified for Oracle Application Server 10g Release 2 (10.1.2).
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, then download it and install it using the following command:
# rpm -i package_name
When installing a package, ensure that you are using the correct architecture and optimization rpm file. To check the architecture of an rpm file, run the following command:
# rpm -q package_name --queryformat "%{arch}\n"
In the following example, the glibc rpm file is suitable for an Intel architecture
# rpm -q glibc --queryformat "%{arch}\n"
i686
Create the following symbolic link for the Perl executable if it does not already exist:
# ln -sf /usr/bin/perl /usr/local/bin/perl
Create the following symbolic link for the fuser executable if it does not already exist:
# ln -sf /bin/fuser /sbin/fuser
If the orarun package was installed on a SUSE Linux Enterprise Server system, then complete the following steps as the oracle user to reset the environment:
Enter the following commands:
prompt>cd /etc/profile.dprompt>mv oracle.csh oracle.csh.bakprompt>mv oracle.sh oracle.sh.bakprompt>mv alljava.sh alljava.sh.bakprompt>mv alljava.csh alljava.csh.bak
Use any text editor to comment out the following line from the $HOME/.profile file:
. ./.oracle
Log out of the oracle user account.
Log in to the oracle user account for the changes to take effect.
If any Java packages are installed on the system, then unset the Java environment variables, for example JAVA_HOME.
|
Note: Oracle recommends that you do not install any of the Java packages supplied with the SUSE Linux Enterprise Server distribution. |
Check the /etc/services file to ensure that the following port ranges are available on the system:
ports 3060-3129 required for Oracle Internet Directory
ports 3130-3199 required for Oracle Internet Directory (SSL)
ports 1812-1829 required for Oracle Enterprise Manager (console)
ports 1830-1849 required for Oracle Enterprise Manager (agent)
ports 1850-1869 required for Oracle Enterprise Manager (RMI)
Remove entries from the /etc/services file and restart the computer, if necessary. To remove the entries, you can use the Perl script included in the utils/3167528/ directory of CD-ROM Disk 1 and in the application_server/utils/3167528/ directory on the DVD. Run the script as the root user. This script is also available as patch 3167528. This patch is available at
If these ports are not available, then the associated configuration assistants will fail during the installation.
If you use Network Information Service (NIS), then:
Ensure that the following line exists in the /etc/yp.conf file:
hostname.domainname broadcast
Ensure that the following line exists in the /etc/nsswitch.conf file:
hosts: files nis dns
Enure that the localhost entry in the /etc/hosts file is an IPv4 entry. If the IP entry for localhost is IPv6 format, then installation cannot succeed. The following example shows an IPv6 entry:
# special IPv6 addresses ::1 localhost ipv6-localhost ipv6-loopback ::1 ipv6-localhost ipv6-loopback
To correct this sample /etc/hosts file, comment the localhost entry as follows:
# special IPv6 addresses # ::1 localhost ipv6-localhost ipv6-loopback ::1 ipv6-localhost ipv6-loopback
To comment the entries, you can use the perl script included in the utils/4015045/ directory of CD-ROM Disk 1 or in the application_server/utils/4015045/ directory on the DVD. Run the script as the root user. This script is also available as patch 4015045. This patch is available at
The following section provides information about checking the kernel parameter values and shell limits:
|
Note:
|
The computers on which you plan to install OracleAS Metadata Repository or OracleAS Web Cache require the kernel parameters to be set to the minimum values. In addition, you need to set the shell limits to improve the performance of the software.
This section provides information about the kernel parameter settings for OracleAS Metadata Repository and OracleAS Web Cache. It covers the following topics:
Section 2.3.1.1, "Kernel Parameter Settings for OracleAS Web Cache"
Section 2.3.1.2, "Kernel Parameter Settings for OracleAS Metadata Repository"
This section is applicable if you are installing OracleAS Web Cache.
|
Note:
|
To check or reset the kernel parameters for OracleAS Web Cache:
Run the following command to check that the nofile kernel parameter is set to at least 65536:
prompt> ulimit -Hn
Add the following line to the /etc/security/limits.conf file (use a text editor to edit the file) if the command returns a value that is less than 65536:
* hard nofile 65536
You need to be the root user to edit the /etc/security/limits.conf file.
Restart the computer for the new value to take effect.
Verify that the kernel parameters shown in the following table are set either to the formula shown, or to values greater than or equal to the recommended value shown. The procedures following the table describe how to verify and set the values.
|
Note: The Linux threads model creates a process for each thread. Oracle Application Server is highly multi-threaded to improve performance. On Linux, this requires that the kernel can handle many hundreds of processes. |
| Parameter | Value | File |
|---|---|---|
semmsl
|
256
32000 100 142 |
/proc/sys/kernel/sem
|
shmall
|
2097152 | /proc/sys/kernel/shmall
|
shmmax
|
2147483648 | /proc/sys/kernel/shmmax
|
shmmni
|
4096 | /proc/sys/kernel/shmmni
|
msgmax
|
8192 | /proc/sys/kernel/msgmax
|
msgmnb
|
65535 | /proc/sys/kernel/msgmnb
|
msgmni
|
2878 | /proc/sys/kernel/msgmni
|
file-max
|
131072 | /proc/sys/fs/file-max
|
ip_local_port_range
|
10000 65000 | /proc/sys/net/ipv4/ip_local_port_range
|
|
Note:
|
To view the current value specified for these kernel parameters and to change them if necessary:
Enter commands similar to the following to view the current values of the kernel parameters:
|
Note: Make a note of the current values and identify any values that you must change. |
| Parameter | Command |
|---|---|
semmsl, semmns, semopm, and semmni
|
# /sbin/sysctl -a | grep sem
This command displays the value of the semaphore parameters in the order listed. |
shmall, shmmax, and semmni
|
# /sbin/sysctl -a | grep shm
|
msgmax, msgmnb, and msgmni
|
# /sbin/sysctl -a | grep msg
|
file-max
|
# /sbin/sysctl -a | grep file-max
|
ip_local_port_range
|
# /sbin/sysctl -a | grep ip_local_port_range
This command displays a range of port numbers. |
If the value of any kernel parameter is different from the recommended value, then complete the following steps:
Using any text editor, create or edit the /etc/sysctl.conf file and add or edit lines similar to the following:
|
Note: Include lines only for the kernel parameter values that you want to change. For the semaphore parameters (kernel.sem), you must specify all four values. However, if any of the current values are larger than the recommended value, specify the larger value.
|
kernel.shmall = 2097152 kernel.shmmax = 2147483648 kernel.shmmni = 4096 # semaphores: semmsl, semmns, semopm, semmni kernel.sem = 256 32000 100 142 fs.file-max = 131072 net.ipv4.ip_local_port_range = 10000 65000 kernel.msgmni = 2878 kernel.msgmax = 8192 kernel.msgmnb = 65535
By specifying the values in the /etc/sysctl.conf file, these lines persist when you restart the computer.
Enter that the following command to change the current values of the kernel parameters:
# /sbin/sysctl -p
Review the output from this command to verify that the values are correct. If the values are incorrect, then edit the /etc/sysctl.conf file and enter this command again.
On SUSE Linux Enterprise Server only, enter the following command to cause the system to read the /etc/sysctl.conf file when it restarts:
# chkconfig boot.sysctl on
To improve the performance of the software on Linux systems, you must increase the following shell limits for the oracle user, depending on the default shell. The following table lists the limits different shells:
| Bourne or Bash Shell Limit | Korn Shell Limit | C or tcsh Shell Limit | Hard Limit |
|---|---|---|---|
| nofile | nofile | descriptors | 65536 |
| noproc | processes | maxproc | 16384 |
To increase the shell limits:
Add the following lines to /etc/security/limits.conf file:
* soft nproc 2047 * hard nproc 16384 * soft nofile 2048 * hard nofile 65536
Add the following line to the /etc/pam.d/login file, if it does not already exist:
session required /lib/security/pam_limits.so
Depending on default shell of the oracle user, make the following changes to the default shell startup file:
For the Bourne, Bash, or Korn shell, add the following lines to the /etc/profile file:
if [ $USER = "oracle" ]; then
if [ $SHELL = "/bin/ksh" ]; then
ulimit -p 16384
ulimit -n 65536
else
ulimit -u 16384 -n 65536
fi
fi
For the C or tcsh shell, add the following lines to the /etc/csh.login file:
if ( $USER == "oracle" ) then
limit maxproc 16384
limit descriptors 65536
endif
You need to create operating system groups in the following situations:
If you plan to install Oracle Application Server on a computer that does not have Oracle products, then create a group to own the inventory directory. Refer to Section 2.4.1, "Create a Group for the Inventory Directory" for more information.
If you plan to install the OracleAS Metadata Repository in a new database (that is, one created by the installer), then create groups for database administrators. Refer to Section 2.4.2, "Create Groups for Database Administrators" for more information.
|
Note: For more information about operating system users and groups, refer to your operating system documentation or contact your system administrator. |
If you plan to install Oracle Application Server on a computer that does not have Oracle products, then create a group to own the inventory directory. The installer writes its files in the inventory directory to keep track of the Oracle products installed on the computer.
This guide uses the name oinstall for this operating system group.
By having a separate group for the inventory directory, you allow different users to install Oracle products on the computer. Users need write permission for the inventory directory. They can achieve this by belonging to the oinstall group.
For the first time installation of any Oracle product on a computer, the installer displays a screen where you enter a group name for the inventory directory, and a screen where you enter the location of the inventory directory.
The default name of the inventory directory is oraInventory.
If you are not sure whether there is already an inventory directory on the computer, then look in the /etc/oraInst.loc file. This file lists the location of the inventory directory and the group who owns it. If the file does not exist, then the computer does not have Oracle products installed on it.
This section applies only if you plan to install the OracleAS Metadata Repository in a new database created by the installer.
When the database is not mounted and database authentication is unavailable, the database uses operating system groups to determine user privileges. The database recognizes these groups and privileges:
Table 2-6 Privileges for the OSDBA and OSOPER Groups
| Group | Description |
|---|---|
OSDBA
|
This is the database administrator group. Users in this group are granted SYSDBA privileges.
|
OSOPER
|
Users in this group are granted SYSOPER privileges, which comprise privileges required for basic maintenance. These include database startup and shutdown, and other privileges required for database operation. SYSOPER privileges are a subset of SYSDBA privileges.
|
You need to create operating system groups for these groups.
If you want an operating system group called dba to have SYSDBA privileges, then:
Create the dba group.
Ensure that the user running the installer is a member of the dba group.
If you want a different operating system group to have SYSDBA privileges, or if you want to associate SYSDBA and SYSOPER privileges with different groups, then ensure the user running the installer does not belong to the dba group.
If the user running the installer does not belong to the dba group, then the installer displays a screen where you can enter the names of groups to have the database administrator privileges. The screen has two fields: one for the OSDBA group and one for the OSOPER group (refer to Table 2-6). You can enter the same operating system group for both fields.
Create an operating system user to install and upgrade Oracle products. This guide refers to this user as the oracle user. The oracle user running the installer must have write permission for the following directories:
The Oracle home directory, which contains files for the product you are installing
The inventory directory, which is used by the installer for all Oracle products
If the computer contains other Oracle products, then you might already have a user for this purpose. Look in the /etc/oraInst.loc file on Linux systems. This file lists the location of the inventory directory and the group who owns it. If the file does not exist, then the computer does not have Oracle products installed on it.
Create a user with the following properties if you do not already have a user for installing Oracle products:
Table 2-7 Properties of the Operating System User Who Runs the Installer
| Item | Description |
|---|---|
| Login name | You can use any name for the user. This guide refers to the user as the oracle user.
|
| Group identifier | The primary group of the oracle user must have write permission for the oraInventory directory. Refer to Section 2.4.1, "Create a Group for the Inventory Directory" for more information about this group.
You can use any name for the group. This guide uses the name |
| Home directory | The home directory for the oracle user can be consistent with the home directories of other users.
|
| Login shell | The default login shell can be the C, Bourne, or Korn shell. |
|
Note: Use theoracle user only for installing and running Oracle products. Do not use root as the oracle user.
|
To create a local operating system user:
To create the oracle user, enter a command similar to the following:
# /usr/sbin/useradd -g oinstall -G dba[,oper] oracle
In this command:
The -g option specifies the primary group, which must be the Oracle Inventory group, for example oinstall
The -G option specifies the secondary groups, which must include the OSDBA group and if required, the OSOPER group, for example dba or dba,oper
Set the password of the oracle user:
# passwd oracle
Linux x86:
To create the oracle user, enter a command similar to the following:
# /usr/sbin/useradd -g oinstall -G dba[,oper] oracle
In this command:
The -g option specifies the primary group, which must be the Oracle Inventory group, for example oinstall
The -G option specifies the secondary groups, which must include the OSDBA group and if required, the OSOPER group, for example dba or dba,oper
Set the password of the oracle user:
# passwd oracle
To check which groups an operating system user belongs to, run the groups command with the name of the user. For example:
prompt> groups oracle
For more information about operating system users and groups, refer to your operating system documentation or contact your system administrator.
The operating system user who will be installing Oracle Application Server needs to set (or unset) the following environment variables:
These environment variables must not be set.
PATH, CLASSPATH, and LD_LIBRARY_PATH
Edit your PATH, CLASSPATH, and LD_LIBRARY_PATH environment variables so that they do not reference any Oracle home directories.
Set the DISPLAY environment variable to point to the X server that will display the installer. The format of the DISPLAY environment variable is:
hostname:display_number.screen_number
Example (C shell):
% setenv DISPLAY test.mydomain.com:0.0
Example (Bourne or Korn shell):
$ DISPLAY=test.mydomain.com:0.0; export DISPLAY
You can test the display by running the xclock program:
$ /usr/openwin/bin/xclock &
Oracle Application Server requires a running X server during installation only. The frame buffer X server installed with your operating system requires that you remain logged in and have the frame buffer running during installation. 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).
Visit Oracle Technology Network at
http://www.oracle.com/technology
for information about obtaining and installing XVFB or other virtual frame buffer solutions. Search OTN for frame buffer.
This section describes two requirements:
The TNS_ADMIN environment variable must not be set. If set, then it can cause errors during installation. Section G.3.14, "Database Configuration Assistant (DBCA) Failures" shows such an error.
These requirements are necessary to prevent conflicts between the Net configuration files for different Oracle products.
If you need to set TNS_ADMIN or if you have the tnsnames.ora file in /etc directory, then perform the following steps before installing Oracle Application Server.
If you have the tnsnames.ora file in /etc, then move the file from these directories to a different directory. Alternatively, you can rename the file.
Ensure that the TNS_ADMIN environment variable is not set.
Example (C shell):
% unsetenv TNS_ADMIN
Example (Bourne or Korn shell):
$ unset TNS_ADMIN
After installation, you can merge the contents of the newly created tnsnames.ora file with your existing tnsnames.ora file.
TMP and TMPDIR
The installer uses a temporary directory for swap space. The installer checks for the TMP and TMPDIR environment variables to locate the temporary directory. If this environment variable does not exist, then the installer uses the /tmp directory.
If you want the installer to use a temporary directory other than /tmp, then set the TMP and TMPDIR environment variables to the full path of an alternate directory. The oracle user must have right permission for this directory and the directory must meet the requirements listed in Section 2.1, "Hardware Requirements for Linux Systems".
Example (C shell):
% setenv TMP /tmp2 % setenv TMPDIR /tmp2
Example (Bourne or Korn shell):
$ TMP=/tmp2; export TMP $ TMPDIR=/tmp2; export TMPDIR
If you do not set this environment variable, and the default directory does not have enough space, then the installer displays an error message that says the environment variable is not set. You can either set the environment variable to point to a different directory or free up enough space in the default directory. In either case, you have to restart the installation.
To ensure that the Oracle Application Server installation completes successfully, unset this environment variable.
Example:
$ unset ORA_NLS
To ensure that the Oracle Application Server installation completes successfully on Linux systems, unset this environment variable.
Example:
$ unset LD_BIND_NOW
Here are some tips when working with environment variables:
If you set environment variables in the .profile file, then they might not be read. To ensure environment variables are set to the correct values, check their values in the shell where you will be running the installer.
To check the value of environment variables, use the env command. This displays all the currently defined environment variables and their values.
% env
If you use the su command to switch users (for example, switching from the root user to the oracle user), then check the environment variables when you are the new user because the environment variables might not be passed to the new user. This can happen even if you run su with the - parameter (su - user).
# /* root user */ #su - oracle%env
Although the contents of the /etc/hosts file affect the items mentioned in the following sections, the installer provides alternative methods for you to enter the values that you want without editing the hosts file:
Section 2.7.1, "Location of the Default Identity Management Realm"
Section 2.7.2, "Host Name for Oracle Application Server Single Sign-On"
The installer reads the hosts file to construct the location of the default Identity Management realm. It displays this location in the Specify Namespace in Internet Directory screen.
The hosts file should use the following format:
ip_address fully_qualified_hostname short_hostname
Example:
123.45.67.89 primaryHost.mydomain.com primaryHost
In the preceding example, the location of the default Identity Management realm would look like dc=mydomain,dc=com.
If the file uses a different format, then the installer displays an incorrect value on the screen. For example, if the hosts file contains:
123.45.67.89 primaryHost primaryHost.mydomain.com <--- incorrect format
The installer would display dc=primaryHost,dc=com as the default Identity Management realm. This is probably not the value that you want for the default Identity Management realm.
|
Tip: If you need thehosts file to use a different format, then you can edit the file to use the required format, perform the installation, then revert the file back to its original format after installation.
If you are unable or unwilling to edit the |
If you are installing Oracle Application Server Single Sign-On, and your hosts file contains only the host name of your computer, without the domain name, then you will only be able to sign on to the Single Sign-On server using the host name by itself (without the domain name).
If you want to require a domain name when connecting to the Single Sign-On server, then you can edit the hosts file to include the domain name. If you do not want to edit the file, then you can use the OUI_HOSTNAME command-line parameter to the installer to override the value in hosts. For example:
prompt> mount_point/1012disk1/runInstaller OUI_HOSTNAME=myserver.mydomain.com
Typically, the computer on which you want to install Oracle Application Server is connected to the network, has local storage to contain the Oracle Application Server installation, has a display monitor, and has a CD-ROM or DVD drive.
This section describes how to install Oracle Application Server on computers that do not meet the typical scenario. It covers the following cases:
Section 2.8.1, "Installing on Multihomed (Multi-IP) Computers"
Section 2.8.2, "Copying CD-ROMs or DVD to Hard Drive, and Installing from the Hard Drive"
Section 2.8.3, "Installing from a Remote CD-ROM or DVD Drive"
If you are installing Oracle Application Server on a computer with multiple network cards, then the installer uses the first name in the /etc/hosts file. If this is not the name that you want to use, then you can do one of the following:
Reorder the lines in the /etc/hosts file so the desired host name appears first, run the installer, then revert the file to its original state after installation.
If you do not want to edit the /etc/hosts file, then you can start up the installer with the OUI_HOSTNAME parameter. Specify the host name that you want to use in this parameter. For example:
prompt> mount_point/1012disk1/runInstaller OUI_HOSTNAME=myserver.mydomain.com
Instead of installing from the Oracle Application Server CD-ROMs or DVD, you can copy the contents of the CD-ROMs or DVD to a hard drive and install from there. This might be easier if you plan to install many instances of Oracle Application Server on your network, or if the computers where you want to install Oracle Application Server do not have CD-ROM or DVD drives.
(You can install from remote CD-ROM or DVD drives. Refer to Section 2.8.3, "Installing from a Remote CD-ROM or DVD Drive".)
When you install from the hard drive, the installer does not prompt you to swap CD-ROMs. It can find all the files if they are in the proper locations (refer to Figure 2-1).
Space Requirement
Ensure that the hard drive contains enough space to hold the contents of the CD-ROMs or the application_server directory on the DVD. Each CD-ROM contains approximately 650 MB. This means that if you are copying three CD-ROMs, you need approximately 1.9 GB of disk space.
On the DVD, the application_server directory is approximately 1.6 GB.
This space is in addition to the space required for installing Oracle Application Server (listed in Table 2-1).
To Copy the CD-ROMs:
Create a directory structure on your hard drive as shown in Figure 2-1.
You need to create a parent directory (called OracleAS_10g_10_1_2 in the example, but you can name it anything you like), and, under the parent directory, create subdirectories called Disk1, Disk2, and so on. The names of the subdirectories must be DiskN, where N is the CD-ROM number.
Figure 2-1 Directory Structure for Copying CD-ROMs to Disk
Copy the contents of each CD-ROM into the corresponding directory.
prompt> cp -pr /cdrom_mount_point/10.1.2disk1/* /path/to/hard/drive/Disk1/ prompt> cp -pr /cdrom_mount_point/10.1.2disk2/* /path/to/hard/drive/Disk2/ ... Repeat for each CD-ROM.
To run the installer from the copied files, invoke the runInstallersetup.exe executable from the Disk1 directory. Run it from the computer that will be running Oracle Application Server.
prompt> /path/to/hard/drive/Disk1/runInstaller
To Copy the application_server Directory from the DVD
Perform the following steps to copy the application_server directory using the command line:
(optional) Create a directory to contain the application_server directory.
Copy the application_server directory from the DVD to your hard disk.
prompt> cp -pr /dvd_mount_point/application_server /path/to/hard/drive
The following example assumes /dvdrom is the DVD drive, and /> application_server is the destination directory:
/> cp -rp /dvdrom/application_server /application_server
To run the installer from the copied files, invoke the runInstaller script executable from the computer that will be running Oracle Application Server:
prompt> /path/to/hard/drive/application_server/runInstaller
/> cd /application_server
/> ./runInstaller
If the computer where you want to install Oracle Application Server does not have a CD-ROM or DVD drive, then you can copy the discs to the hard drive of a computer with the proper disc drive as described in Section 4.9.2 and then perform a remote installation from that computer using the instructions described in Section 2.8.4, "Installing on Remote Computers".
You can run the installer on a remote computer (remote_computer) but have the installer screens display on your local computer (local_computer). The installer will install Oracle Application Server on the remote computer.
To perform a remote installation:
Allow remote_computer to display on local_computer. You need to run this command on the console of the local computer.
local_computer> xhost +remote_computer
If you do not run xhost, then you might get an Xlib error similar to Failed to connect to server, Connection refused by server, or Can't open display when starting the installer.
On local_computer, perform a remote login (using telnet or rlogin) to remote_computer. Log in as the oracle user, as described in Section 2.5, "Operating System User". Ensure that the user has set the environment variables correctly, as described in Section 2.6, "Environment Variables".
local_computer> rlogin -l oracle remote_computer.mydomain.com - OR - local_computer> telnet remote_computer.mydomain.com
Set the DISPLAY environment variable on remote_computer to point to local_computer.
Example (C shell):
remote_computer> setenv DISPLAY local_computer.mydomain.com:0.0
Example (Bourne or Korn shell):
remote_computer> DISPLAY=local_computer.mydomain.com:0.0; export DISPLAY
Run the installer. Refer to Section 5.2, "Starting Oracle Universal Installer".
|
Note: You can use a PC X emulator to run the installer 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. |
To run Oracle Application Server on NFS systems, you have to use a certified NFS-mounted storage system.
Currently, Oracle Application Server is certified to run on the following NFS systems:
The NetApp system should be exported to at least the remote install user and remote root user. You can do this using exportfs command:
prompt> exportfs -i /vol/vol1
To check the latest certification list for any updates, visit Oracle Technology Network (http://www.oracle.com/technology).
Oracle Application Server components are intended to be run only on the computer where they are installed. You cannot run the components on remote computers, even though the computers can access the files through NFS.
Figure 2-2 Run Oracle Application Server Only on the Computer Where It Is Installed
You can install and run Oracle Application Server in Network Information Service (NIS) and NIS+ environments.
If you are installing Oracle Application Server Standard Edition One in a DHCP network, then you must use a loopback configuration. To access the Oracle Application Server Standard Edition One, you need to use a local browser. Perform the following steps to install Oracle Application Server in a DHCP network:
Find the IP address allocated from the DHCP server by running the following command:
$ /sbin/ifconfig -a
The IP address is associated with the interface configured to use DHCP.
Configure the host to resolve host name to loopback IP address:
Configure the host to resolve host name to loopback IP address, by modifying the /etc/hosts file to contain the following entries:
127.0.0.1 hostname.domainname hostname
127.0.0.1 localhost.localdomain localhost
Check that the host name resolves to the loopback IP address by entering the following command:
$ /bin/ping hostname.domainname
Complete the Oracle Application Server installation as described in this guide using the host name used in step 2
Table 2-8 lists the checks performed by the installer:
Table 2-8 Prerequisite Checks Performed by the Installer
| Item | Description |
|---|---|
| Processor | Refer to Section 2.1, "Hardware Requirements for Linux Systems" for the processor speed requirements. |
| Operating system version | Refer to Section 2.2, "Software Requirements for Linux" for supported versions. |
| Operating system patches | Refer to Section 2.2, "Software Requirements for Linux" for a list of required patches. |
| Operating system kernel parameters | Refer to Section 2.3, "Check Kernel Parameters and Shell Limits" for a list of required kernel parameters. |
| Memory | Refer to Section 2.1 for recommended values. |
| Swap space | Refer to Section 2.1 for recommended values. |
| TMP space | Refer to Section 2.1 for recommended values. |
| Instance name | The installer checks that the computer on which you are installing Oracle Application Server does not already have an instance of the same name. |
| Oracle home directory name | The installer checks that the Oracle home directory name does not contain any spaces. |
| Path to Oracle home directory | The installer checks that the path to the Oracle home directory is not longer than 127 characters. |
| Oracle home directory contents | The installer checks that the Oracle home directory does not contain any files that might interfere with the installation. |
| Oracle home directory | You should install Oracle Application Server in a new directory, unless you are expanding a middle tier (refer to Section 3.2, "Adding the OracleAS Portal Components After Installing J2EE and Web Services") or installing a middle tier in an Oracle home that contains Oracle Developer Suite 10g Release 2 (10.1.2) (refer to Section 1.4.2, "Oracle Home Directory"). Here are some examples of installations that are not allowed:
|
| Port 1521 | The installer displays a warning if port 1521 is in use by any application, including database listeners of any version. You need to stop the application that is using port 1521, then click Retry in the warning dialog box.
If it is a database listener that is using port 1521, then you might be able to use it for the metadata repository database. Refer to Section 1.4.8, "If Port 1521 is Already in Use" for details. If it is another application that is using port 1521, then you need to stop it or configure it to use a different port. Alternatively, you can change the database listener to use a port other than 1521, but you can do this only after installation. Refer to the Oracle Application Server Administrator's Guide for details. |
| Static port conflicts | The installer checks the ports listed in the staticports.ini file, if specified. Refer to Section 1.4.7.4, "Using Custom Port Numbers (the "Static Ports" Feature)".
|
| Monitor | The installer checks that the monitor is configured to display at least 256 colors. |
| Display permission | The installer checks that the user has permissions to display on the monitor specified by the DISPLAY environment variable.
|
DISPLAY environment variable
|
The installer checks that the DISPLAY environment variable is set.
|
TNS_ADMIN environment variable
|
The TNS_ADMIN environment variable must not be set.
There must not be a |
DBCA_RAW_CONFIG environment variable
|
If you are installing the OracleAS Infrastructure in a database or Oracle Application Server Active Failover Cluster environment, then you need to set this environment variable to point to a file that describes the locations of your raw partitions. |
| Cluster file system | The installer checks that you are not installing Oracle Application Server in a cluster file system (CFS). |
| Oracle Enterprise Manager directories are writable | The installer runs this check only if you are expanding a middle tier or if you are reinstalling Oracle Application Server in the same Oracle home. The installer checks that these directories are writable by the operating system user running the installer:
|
| Oracle Enterprise Manager files exist | The installer runs this check only if you are expanding a middle tier or if you are reinstalling Oracle Application Server in the same Oracle home. The installer checks that these files exist:
|
| Kernel check on Linux systems | The installer runs this check only if you are installing on Linux. The installer makes sure that the kernel version contains the string 2.4.9-e.49 or higher for Red Hat Enterprise Linux AS/ES 21, the string 2.4.21-20.EL for Red Hat Enterprise Linux AS/ES 3.0, the string 2.4.21 for SUSE Linux Enterprise Server 8 and the string 2.6.5-7.97 for SUSE Linux Enterprise Server 9.
|
| glibc version check on Linux | The installer runs this check only if you are installing on Linux. The installer makes sure that the glibc version is glibc-2.2.4-32.17 or higher on Red Hat Enterprise Linux AS/ES 2.1, glibc-2.3.2-95.27 or higher on Red Hat Enterprise Linux AS/ES 3.0, glibc-2.2.2-124 or higher on SUSE Linux Enterprise Server 8, and glibc-2.3.3-98.28 or higher on SUSE Linux Enterprise Server 9. |
| Packages check on Linux | The installer runs this check only if you are installing on Linux.The installer makes sure that the mandatory packages are installed. For example, it checks the gcc, sysstat and openmotif packages as specified in Table 2-2 for Red Hat Enterprise Linux AS/ES 2.1, Table 2-3 for Red Hat Enterprise Linux AS/ES 3.0, Table 2-4 for SUSE Linux Enterprise Server 8 and Table 2-5 for SUSE Linux Enterprise Server 9. |