|
Oracle® Application Server 10g Forms and Reports Services Installation Guide
10g (9.0.4) for hp-ux PA-RISC (64-bit) and Linux x86 Part No. B13600-01 |
|
|
|
|
Oracle® Application Server 10g Forms and Reports Services Installation Guide
10g (9.0.4) for hp-ux PA-RISC (64-bit) and Linux x86 Part No. B13600-01 |
|
|
|
|
Before installing Oracle Application Server 10g Forms and Reports Services, you must ensure that your computer meets the requirements described in this chapter.
This chapter contains the following sections:
Table 5–1 lists the system requirements for running Oracle Application Server 10g Forms and Reports Services. The Oracle Universal Installer (OUI) checks many of the requirements at the start of the installation process and warns you if any of them are not met. To save time, you can manually check only the remaining requirements. Refer to Table 5–1 to see which requirements are not checked by the installer.
Table 5-1 Hardware Requirements for HP-UX and Linux Systems
| Item | Minimum Requirement | Checked by Installer |
|---|---|---|
| Disk space | 1 GB
To determine the amount of free disk space, use the prompt> bdf dir For Linux x86, use the prompt> df -k dir Replace |
No |
| IP | The computer IP address must be static. Oracle Application Server 10g Forms and Reports Services does not support HP-UX systems using DHCP.
DHCP is supported on Linux and Microsoft Windows. |
No |
| Memory | 512 MB
To determine the amount of memory, use the # /usr/sbin/dmesg | grep "Physical:" For Linux x86, use the following command: # grep MemTotal /proc/meminfo Note: These values assume you are running only one Oracle Application Server 10g Forms and Reports Services instance per computer. |
Yes |
| Monitor | 256 color display
To determine your monitor display capabilities for HP-UX and Linux x86, run the following command (Before running the command, ensure that the DISPLAY environment variable is set): prompt> /usr/X11R6/bin/xdpyinfo Look for the "Depth" line. You need a depth of at least 8 (bits per pixel). |
Yes |
| Network | The computer must be connected to a network. You cannot install Oracle Application Server 10g Forms and Reports Services on a standalone computer that is not connected to a network.
Installing Oracle Application Server 10g Forms and Reports Services on standalone computers is supported for Linux and Microsoft Windows. |
No |
| Processor speed | 240 MHz or faster | Yes |
| Processor type | 64-bit HP-UX PA-RISC processor
If the processor is 64-bit the following command returns the value # /bin/getconf KERNEL_BITS Pentium (32-bit) for Linux x86 |
No |
| Space in /tmp directory | 256 MB
To determine the amount of free space in the prompt> bdf /tmp To determine the amount of free space in the prompt> df -k /tmp If the |
Yes |
| Swap space | 640 MB of available swap space
To determine the amount of available swap space for HP-UX, use the following command: # /usr/sbin/swapinfo -a To determine the amount of available swap space for Linux x86, use the # grep SwapTotal /proc/meminfo If you do not have enough swap space, perform the following tasks:
|
Yes |
| Supported browsers | The following browsers are supported:
However, Oracle Enterprise Manager is optimized for the following browsers:
For the most current list of supported browsers, check the OracleMetaLink site ( |
No |
If you need to reduce memory consumption:
After installation, if you want to stop services that are not used to reduce the memory usage, you can stop them from the Oracle Enterprise Manager. For details, see the Oracle Application Server 10g Administrator's Guide.
For Oracle Report Services, you can control the JVM heap size by specifying small value through the environment variable REPORTS_JVM_OPTIONS. For details, see Oracle Application Server Reports Services Publishing Reports to the Web.
Depending on the version of HP-UX, check that the software listed in Table 5-2, "Software Requirements for HP-UX 11.0 Systems" or Table 5-3, "Software Requirements for HP-UX 11i Systems" is installed on the system. The procedure that follows the tables describes how to verify that you installed the correct software on the system.
|
Note: Oracle Application Server 10g Forms and Reports Services is certified with the following Operating System specific software. For the most current list of supported Operating System specific software (For example, JDK or Operating System version), check OracleMetaLink (http://metalink.oracle.com).
|
Table 5-2 Software Requirements for HP-UX 11.0 Systems
| Item | Requirements |
|---|---|
| Operating System | HP-UX 11.0 (64-bit) |
| JDK | JDK 1.4.1.05 or higher |
| Patches required for JDK | Install all patches required for JDK 1.4.1.05. This list is constantly under review and is published on the JDK download page on the HP web site. |
| Quality Pack | Sept 2002 Quality Pack (QPK1100 B.11.00.58.5) or higher |
| Patches (or higher versions) |
|
| Packages | Motif 2.1 Development Environment X11MotifDevKit.MOTIF21-PRG:B.11.10.01
Note: This package is not required if you create the symbolic links described in step 6 of the next section. |
|
Note: Oracle Application Server 10g Forms and Reports Services is certified with the following Operating System specific software. For the most current list of supported Operating System specific software (For example, JDK or Operating System version), check OracleMetaLink (http://metalink.oracle.com).
|
Table 5-3 Software Requirements for HP-UX 11i Systems
| Item | Requirements |
|---|---|
| Operating System | hp-ux PA-RISC 11i (11.11) or higher |
| JDK | JDK 1.4.1.05 or higher |
| Patches required for JDK | Install all patches required for JDK 1.4.1.05. This list is constantly under review and is published on the JDK download page on the HP web site |
| Quality Pack | Dec 2001 Consolidate Patches (Dec01GQPK11i_Aux_Patch B.03.02.06) or higher |
| Patches (or higher versions) |
|
| Package | Motif 2.1 Development Environment (X11MotifDevKit.MOTIF21-PRG) B.11.11.01
Note: This package is not required if you create the symbolic links described in step 6 of the next section. |
To ensure that the system meets these requirements, follow the following steps:
To determine which version of HP-UX is installed, enter the following command:
# uname -a HP-UX hostname B.11.11 U 9000/800 109444686 unlimited-user license
In this example, the version of HP-UX 11i is 11.11.
To determine which JDK is installed, enter the following command:
# JDK_location/bin/java -fullversion
If the version displayed is less than 1.4.1.05, download JDK 1.4.1.05 or higher from the following Web site and install it:
To determine whether the Quality Pack is installed, enter the following command:
# /usr/sbin/swlist | grep QPK
If the quality pack is not installed, download it from the following web site and install it:
To determine whether a bundle or product is installed, enter the following command:
# /usr/sbin/swlist -l product | more
If a required product is not installed, you must install it. See your operating system or software documentation for information on installing products.
To determine whether a patch is installed, enter a command similar to the following:
# /usr/sbin/swlist -l patch | grep PHKL_27813
Alternatively, to list all installed patches, enter the following command:
# /usr/sbin/swlist -l patch | more
If a required patch is not installed, download it from the following URL and install it:
If the Motif package listed in Table 5–2 and Table 5–3 is not installed on the computer, create the following symbolic links:
Log in as the root user
Change to the /usr/lib directory:
# cd /usr/lib
Create the required links:
# ln -s libX11.3 libX11.sl # ln -s libXIE.2 libXIE.sl # ln -s libXext.3 libXext.sl # ln -s libXhp11.3 libXhp11.sl # ln -s libXi.3 libXi.sl # ln -s libXm.4 libXm.sl # ln -s libXp.2 libXp.sl # ln -s libXt.3 libXt.sl # ln -s libXtst.2 libXtst.sl
Depending on your distribution of Linux, see one of the following sections for information on checking the software requirements:
Oracle does not support customized kernels or modules not supported by the Linux vendor.
You can install Oracle Application Server 10g Forms and Reports Services 10g (9.0.4) on a Linux system that is not on a network and you can install Oracle Application Server 10g Forms and Reports Services 10g (9.0.4) on a Linux system that is configured to use DHCP. If you want to install Oracle Application Server 10g Forms and Reports Services on a computer that is not on a network, you must configure the computer to use either a static IP address or a loopback IP address. Configure the computer to resolve the hostname of the computer to either a static IP address or a loopback IP address.
Table 5-4 lists the software requirements for Red Hat 2.1 systems and the procedure that follows the table describes how to ensure your system meets these requirements and any additional requirements for installing Oracle Application Server 10g Forms and Reports Services.
|
Note: Oracle Application Server 10g Forms and Reports Services is certified with the following Operating System specific software. For the most current list of supported Operating System specific software (For example, JDK version or Operating System version), check OracleMetaLink (http://metalink.oracle.com).
|
Table 5-4 Software Requirements for Red Hat 2.1 Systems
To ensure that the system meets all the requirements, follow these steps:
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 UnitedLinux 1.0 are certified and supported. For the most current list of supported Linux Operating Systems, check OracleMetaLink (http://metalink.oracle.com). Do not install the software on other versions of Linux.
|
To determine which version of the Red Hat Linux kernel is installed, enter the following command
# uname -r kernel-smp-2.4.9-e.25
In this example, the version shown is 2.4.9 with errata 25. If necessary, see your operating system documentation for information on upgrading the kernel.
For more information on Red Hat patches, see:
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, download it and install it using the following command:
# rpm -i package_name
Table 5-5 lists the software requirements for Red Hat 3.0 systems and the procedure that follows the table describes how to ensure your system meets these requirements and any additional requirements for installing Oracle Application Server 10g Forms and Reports Services.
|
Note: Oracle Application Server 10g Forms and Reports Services is certified with the following Operating System specific software. For the most current list of supported Operating System specific software (For example, JDK and Operating System version), check OracleMetaLink (http://metalink.oracle.com).
|
Table 5-5 Software Requirements for Red Hat 3.0 Systems
To ensure that the system meets all the requirements, follow these steps:
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 Enterprise Linux AS release 3 (Taroon)
|
Note: Red Hat Enterprise Linux AS/ES 2.1, 3.0 and UnitedLinux 1.0 are certified and supported. For the most current list of supported Linux Operating Systems, check OracleMetaLink (http://metalink.oracle.com). Do not install the software on other versions of Linux.
|
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, download it and install it using the following command:
# rpm -i package_name
Check whether the following symbolic links exist:
# cd /usr/bin # ls -l gcc g++ gcc -> gcc296 g++ -> g++296
If these links do not exist, use the following instruction to create them:
Create a backup of the existing files as follows:
# mv /usr/bin/gcc /usr/bin/gcc.backup # mv /usr/bin/g++ /usr/bin/g++.backup
Create the symbolic links as follows:
# ln -s /usr/bin/gcc296 /usr/bin/gcc # ln -s /usr/bin/g++296 /usr/bin/g++
You can restore the original files if required, however you must recreate the links as described in this procedure for Oracle Application Server 10g Forms and Reports Services to relink properly.
If the hugemem kernel is used, set the architecture using following command:
prompt> setarch i386
Apply patch no. 3006854. You can download this patch from OracleMetaLink (http://metalink.oracle.com). This patch creates the /etc/libcwait.so file and appends the following line to the /etc/ld.so.preload file:
/etc/libcwait.so
Table 5-6 lists the software requirements for UnitedLinux 1.0 systems and the procedure that follows the table describes how to ensure your system meets these requirements and any additional requirements for installing Oracle Application Server 10g Forms and Reports Services.
|
Note: Oracle Application Server 10g Forms and Reports Services is certified with the following Operating System specific software. For the most current list of supported Operating System specific software (For example, JDK and Operating System version), check OracleMetaLink (http://metalink.oracle.com).
|
Table 5-6 Software Requirements for UnitedLinux Systems
To ensure that the system meets all the requirements, follow these steps:
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 UnitedLinux 1.0 (i586) - Kernel \r (\l)
|
Note: Red Hat Enterprise Linux AS/ES 2.1, 3.0 and UnitedLinux 1.0 are certified and supported. For the most current list of supported Linux Operating Systems, check OracleMetaLink (http://metalink.oracle.com). Do not install the software on other versions of Linux.
|
To determine the service pack version, enter the following command:
# rpm -qf /boot/vmlinuz
If the kernel version contains the string 2.4.19, SP2a is installed. If the kernel version contains the string 2.4.21, SP3 is installed.
To determine whether any other package is installed, enter a command similar to the following:
# rpm -q package_name
If a package is missing, download it and install it using the following command:
# rpm -i package_name
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
Create the correct compiler environment on UniteLinux 1.0:
Install the gcc_old package. This provides the old compiler GCC 2.95.3 in the /opt/gcc295 directory.
Check whether the following symbolic links exist:
# cd /usr/bin # ls -l gcc cc gcc -> /opt/gcc295/bin/gcc cc -> /opt/gcc295/bin/gcc
If these links do not exist, create a backup of the existing files:
# mv /usr/bin/gcc /usr/bin/gcc.backup # mv /usr/bin/cc /usr/bin/cc.backup
Create the symbolic links:
# ln -s /opt/gcc295/bin/gcc /usr/bin/gcc # ln -s /opt/gcc295/bin/gcc /usr/bin/cc
You can restore the original files if required, however you must recreate the links as described in this procedure for Oracle Application Server 10g Forms and Reports Services to relink properly.
Create the following symbolic link if it does not already exist:
prompt> ln -s /opt/gcc295/lib/gcc-lib/i486-suse-linux/2.95.3/libgcc.a \/lib/libgcc.a
Depending on the UnitedLinux distribution, the first path in the previous command may contain a string other than suse.
If the orarun package was installed on a UnitedLinux system, complete the following steps as the oracle user to reset the environment:
Enter the following commands:
prompt> cd /etc/profile.d prompt> mv oracle.csh oracle.csh.bak prompt> mv oracle.sh oracle.sh.bak prompt> mv alljava.sh alljava.sh.bak prompt> mv alljava.csh alljava.csh.bak
Use any text editor to comment out the following line in the $HOME/.profile file:
. ./.oracle
Log out of the oracle user account.
Log into the oracle user account for the changes to take effect.
If any Java packages are installed on the system, 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 UnitedLinux distribution. |
Check the /etc/services file to make sure 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)
If necessary, remove entries from the /etc/services file and reboot the system. To remove the entries, you can use the perl script included with the patch 3167528. This patch is available from:
If these ports are not available, the associated configuration assistants will fail during the installation.
If you use Network Information Service (NIS):
Make sure that the following line exists in the /etc/yp.conf file:
hostname.domainname broadcast
Make sure that the following line exists in the /etc/nsswitch.conf file:
hosts: files nis dns
Create an operating system user to install and upgrade Oracle products. The operating system user running the installer must have write permission for these 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, you might already have a user for this purpose. Look in the /var/opt/oracle/oraInst.loc file for HP-UX systems and 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, the computer does not have Oracle products installed on it.
If you do not already have a user for installing Oracle products, create a user with the following properties:
Table 5-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.
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 maintaining Oracle products. Never use it for purposes unrelated to the installer. Do not use root as the oracle user.
|
To create a local operating system user:
Switch to the root user.
prompt> su
To create the oracle user, enter a command similar to the following:
# /usr/sbin/useradd -g oinstall oracle
In this command the -g option specifies the primary group, which must be the group that owns the Oracle Inventory, for example, oinstall.
Use the -G option to specify the secondary groups, which can include the OSDBA group, and the OSOPER group if necessary, 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, see your operating system documentation or contact your system administrator.
User IDs are important if you are setting up an OracleAS Active Failover Cluster environment because you need to set up identical users on each node.
The operating system user who will be installing Oracle Application Server 10g Forms and Reports Services needs to set (or unset) the environment variables in Table 5-8. The table also summarizes whether you set or unset an environment variable.
Table 5-8 Environment Variable Summary
| Environment variable | Set or Unset |
|---|---|
| ORACLE_HOME and ORACLE_SID
|
Does not matter (the installer unsets these two environment variables). |
| PATH, CLASSPATH, and Shared Library Path Environment Variables
|
Must not contain references to directories in any Oracle home directories. |
| DISPLAY
|
Set it to the monitor where you want to the installer window to appear. |
| TMP and TMPDIR
|
Optional. If unset, defaults to /tmp.
|
| TNS_ADMIN
|
Unset. |
| ORA_NLS
|
Unset. |
| LD_BIND_NOW (Linux Only)
|
Unset. |
Here are some tips when working with environment variables:
If you set environment variables in the .profile file, 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), 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 - option (su - user).
# /* root user */ #su - oracle%env
It does not matter if these environment variables are set or unset when you start up the installer because the installer unsets these environment variables.
Edit your PATH, CLASSPATH, and shared library path environment variables so that they do not reference any Oracle home directories.
Table 5-9 lists the shared library path environment variables for different platforms
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
The following is an example of setting the DISPLAY environment variable in C shell:
% setenv DISPLAY test.mydomain.com:0.0
The following is an example of setting the DISPLAY environment variable in Bourne or Korn shell:
$ DISPLAY=test.mydomain.com:0.0; export DISPLAY
You can test the display by running the xclock program. For Linux, use the following command:
$ /usr/X11R6/bin/xclock &
For HP-UX, use the following command:
$ /usr/bin/X11/xclock
Oracle Application Server 10g Forms and Reports Services 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 (http://otn.oracle.com) for information about obtaining and installing XVFB or other virtual frame buffer solutions. Search OTN for "frame buffer".
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, the installer uses the /tmp directory.
If you want the installer to use a temporary directory other than /tmp, set the TMP and TMPDIR environment variables to the full path of an alternate directory. The oracle user must have write permission for this directory and the directory must meet the requirements listed in Section 5.1.2, "Checking the Software Requirements for HP-UX" and Section 5.1.3, "Checking the Software Requirements for Linux".
Example (C shell):
% setenv TMP /tmp2 % setenv TMPDIR /tmp2
Example (Bourne or Korn shell):
$ TMP=/tmp2; export TMP $ TMPDIR=/tmp2; export TMPDIR
This section describes two requirements:
The TNS_ADMIN environment variable must not be set.
The /etc and the /var/opt/oracle directories must not contain a tnsnames.ora file.
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 or /var/opt/oracle, do the following steps before installing Oracle Application Server 10g Forms and Reports Services.
If you have the tnsnames.ora file in /etc or /var/opt/oracle, move the file from these directories to a different directory. Alternatively, you can rename the file.
Make sure 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.
To make sure that the Oracle Application Server 10g Forms and Reports Services installation completes successfully, unset the ORA_NLS environment variable.
Example:
$ unset ORA_NLS
