Skip Headers

Oracle® Developer Suite Release Notes 10g (9.0.4) for Windows, Linux, Solaris, and HP-UX Part No. B10668-03 |
| Library | Contents | Index

# 4 Known Issues

This chapter discusses issues and workarounds that apply to the entire Oracle Developer Suite product. For component-specific issues and workarounds, please refer to the chapters in Part II, "Component Release Notes".

This chapter is divided into the following sections:

- Section 4.1, "Preinstallation Issues"

- Section 4.2, "Installation Issues"

- Section 4.3, "Postinstallation Issues"

- Section 4.4, "Deinstallation Issues"

- Section 4.5, "Platform-specific Issues"

- Section 4.6, "Configuration Issues"

- Section 4.7, "Administration Issues"

- Section 4.8, "Documentation Errata"

## 4.1 Preinstallation Issues

### 4.1.1 Oracle Business Intelligence Beans

Oracle Business Intelligence Beans (hereinafter referred to as "BI Beans") requires Oracle9i Enterprise Edition Release 2 (9.2.0.3 or later) with the OLAP Option. For specific patch set numbers, see the matrix of supported patch sets in the BI Beans product area on Oracle Technology Network (`http://otn.oracle.com/docs/products/bib/content.html`).

The OLAP Option requires configuration, as follows:

- Basic configuration is described in the Oracle9i OLAP User's Guide. This book is available on OracleMetaLink (`http://metalink.oracle.com`). On the top-level page on OracleMetaLink, click Top Tech Docs, then scroll to the Business Intelligence (BI) & Warehousing heading and click Oracle OLAP. Next, click Documentation, then Oracle OLAP, then the book title.

- For good performance and to ensure that BI Beans works as expected, you must follow the guidelines in Oracle9i OLAP Best Practices for Tabular Cube Aggregation and Query Operations. This document is available as patch set 2529822 on OracleMetaLink (`http://metalink.oracle.com`).

### 4.1.2 Oracle9i Warehouse Builder

Oracle9i Warehouse Builder Release 9.2 is included in the Oracle Developer Suite 10g CD Pack as a separate CD-ROM disk with a separate installation program. All of the documentation for Oracle9i Warehouse Builder is included on its CD-ROM.

## 4.2 Installation Issues

There are no known suite-level installation issues.

## 4.3 Postinstallation Issues

### 4.3.1 Java Versions

The documentation for an individual component of Oracle Developer Suite may list a specific version of the JDK, JRE, J2SE, J2EE or other Java feature that is certified for that component. Nevertheless, the Java version that is supplied with Oracle Developer Suite 10g 9.0.4 is also fully certified for all components.

For example, the Java in Oracle Developer Suite 10g 9.0.4 for Linux is 1.4.2.x, while the Oracle Business Intelligence Beans (BI Beans) documentation says that BI Beans is only certified with 1.4.1. However, BI Beans is also certified with the Java SDK 1.4.2 that is installed with Oracle Developer Suite 10g for Linux.

## 4.4 Deinstallation Issues

There are no known suite-level deinstallation issues.

## 4.5 Platform-specific Issues

### 4.5.1 Linux Issues

#### 4.5.1.1 Revised Linux Operating Environment Software Requirements

The following documented Linux operating environment software requirements have been revised:

- Section 2.3.4 "Linux Operating Environment" of the Oracle Developer Suite Installation Guide 10g (9.0.4) for Windows, Linux, Solaris, and HP-UX. The revisions are listed in Section 4.8.3, "Linux Operating Environment Software Requirements".

- Table 8 "Linux x86 Operating Environment Software Requirements" of the Oracle Developer Suite 10g Quick Installation Guide 10g (9.0.4) for Windows, Linux, Solaris, and HP-UX. The revisions are listed in Section 4.8.3, "Linux Operating Environment Software Requirements".

#### 4.5.1.2 Setting the PATH environment variable in Linux

After you finish installing on a Linux computer, update the PATH variable of any shell that will be relinking Developer Suite executables via Makefiles, by inserting `/usr/bin` as the first entry of the variable.

## 4.6 Configuration Issues

There are no known suite-level configuration issues.

## 4.7 Administration Issues

There are no known suite-level administration issues.

## 4.8 Documentation Errata

### 4.8.1 Oracle Developer Suite 10g Installation Guide

In Table A-1, footnote 2 states that "Oracle9i Warehouse Builder Release 2 (9.0.4) is now available separately from Oracle Developer Suite." Oracle Developer Suite 10g now includes Oracle9i Warehouse Builder Release 9.2. as a separate CD-ROM. For more information, see Section 4.1.2, "Oracle9i Warehouse Builder".

In section 2.9.4.2.2, "Mounting CD-ROMs and DVDs to HP-UX", make the following changes:

- In step 2, change "ioscan" to "/etc/ioscan" so that the line reads

      # /etc/ioscan -fun -C disk

- In the Note within step 3, replace "an empty `/mnt/cdrom` directory" with "an empty `/SD_CDROM` directory".

- In step 5, replace "mount the CD-ROM" with "mount the CD-ROM or DVD".

### 4.8.2 Oracle Developer Suite 10g Quick Installation Guide

In Table 9 "Information Needed During Installation", make the following change:

- For the item "Java SDK Directory", change the value of "Install Type" from "All" to "All (HP-UX only)."

### 4.8.3 Linux Operating Environment Software Requirements

Note: This section replaces the following sections: Section 2.3.4 "Linux Operating Environment" of the Oracle Developer Suite 10g Installation Guide 10g (9.0.4) for Windows, Linux, Solaris, and HP-UX. Table 8 "Linux x86 Operating Environment Software Requirements" of the Oracle Developer Suite 10g Quick Installation Guide 10g (9.0.4) for Windows, Linux, Solaris, and HP-UX. Please refer to Section 4.5.1.1, "Revised Linux Operating Environment Software Requirements" for more information.

This section describes the Linux operating environment software requirements for the following supported Linux distributions:

- Section 4.8.3.1, "Red Hat Linux 2.1 Requirements"

- Section 4.8.3.2, "Red Hat Linux 3.0 Requirements"

- Section 4.8.3.3, "UnitedLinux 1.0 Requirements"

Note: Oracle does not support customized kernels or modules not supported by the Linux vendor.

You can install Oracle Developer Suite 10g on a Linux computer that is not on a network, and you can install Oracle Developer Suite 10g on a Linux computer that is configured to use DHCP. If you want to install Oracle Developer Suite 10g 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 its hostname to either a static IP address or a loopback IP address.

#### 4.8.3.1 Red Hat Linux 2.1 Requirements

Table 4-1, "Red Hat 2.1 Operating Environment Software Requirements" lists the operating environment software requirements for Red Hat 2.1. The procedure that follows the table describes how to ensure your computer meets these requirements.

Note: Check OracleMetaLink (`http://metalink.oracle.com`) for the most current list of supported operating environment software.

Table 4-1 Red Hat 2.1 Operating Environment Software Requirements

Item | Requirement
--- | ---
Operating System | Red Hat Enterprise Linux AS/ES 2.1 (for more information, see `http://www.redhat.com`)
Patches | Errata 25 kernel or a higher errata patch approved by Red Hat For example, you should have one of the following, depending on the type of Red Hat installation you have: kernel-2.4.9-e.25 kernel-smp-2.4.9-e.25 kernel-enterprise-2.4.9-e.25 The minimum supported version of the glibc package is glibc-2.2.4-32
Packages (check that the specified version or higher is installed.) | gcc-2.96-108.1 pdksh-5.2.14-13 openmotif-2.1.30 compat-glibc-6.2-2.1.3.2 libstdc++-2.96-108.1

To ensure that your computer meets these requirements:

1. Log in as `root`.

2. Determine which distribution and version of Linux is installed, by entering the following command:

   `#` `cat /etc/issue`

   This will list out the version. For example, the response

   `Red Hat Linux Advanced Server release 2.1AS/\m (Pensacola)`

   indicates that you have Red Hat Linux AS version 2.1.

3. Determine which version of the Red Hat Linux kernel is installed, by entering the following command:

   `#` `uname -r`

   This lists the kernel version. For example, the response

   `kernel-smp-2.4.9-e.25`

   shows that you have kernel 2.4.9 with errata 25. If you need to upgrade your kernel, refer to your operating system documentation for instructions.

   Note: For more information on Red Hat patches, see `http://www.redhat.com`.

4. Check that the required software packages are installed. To do this, enter the command:

   `#` `rpm -q` `package_name`

   for each package listed in the "Packages" entry in Table 4-1, "Red Hat 2.1 Operating Environment Software Requirements".

   If a package is missing, download it and install it using the following command:

   `#` `rpm -i` `package_name`

#### 4.8.3.2 Red Hat Linux 3.0 Requirements

Table 4-2, "Red Hat 3.0 Operating Environment Software Requirements" lists the operating environment software requirements for Red Hat 3.0. The procedure that follows the table describes how to ensure your computer meets these requirements.

Note: Check OracleMetaLink (`http://metalink.oracle.com`) for the most current list of supported operating environment software.

Table 4-2 Red Hat 3.0 Operating Environment Software Requirements

Item | Requirement
--- | ---
Operating System | Red Hat Enterprise Linux AS/ES 3.0 (for more information, see `http://www.redhat.com`)
Patches | The minimum supported kernel and glibc versions are: 2.4.21-4-EL glibc-2.3.2-95.3
Packages (check that the specified version or higher is installed.) | gcc-3.2.3-20 setarch-1.3-1 pdksh-5.2.14 openmotif21-2.1.30-8 gnome-libs-1.4.1.2.90-34.1 compat-glibc-7.x-2.2.4.32.5 compat-gcc-7.3-2.96.122 compat-libstdc++-7.3-2.96.122 compat-libstdc++-devel-7.3-2.96.122 compat-gcc-c++-7.3-2.96.122

Note: For Red Hat Linux 3.0, the equivalent version of openmotif 2.1.30-8 is openmotif21-2.1.30-8. Install the openmotif21-2.1.30-8 package from disk number 3 of the Red Hat Linux 3.0 distribution by entering: `$` `rpm -ivh openmotif21-2.1.30-8`

To ensure that your computer meets these requirements:

1. Log in as `root`.

2. Determine which distribution and version of Linux is installed, by entering the following command:

   `#` `cat /etc/issue`

   This will list out the version. For example, the response

   `Red Hat Enterprise Linux AS 3 (Taroon)`

   indicates that you have Red Hat Linux AS version 3.0.

3. Check that the required software packages are installed. To do this, enter the command:

   `#` `rpm -q` `package_name`

   for each package listed in the "Packages" entry in Table 4-2, "Red Hat 3.0 Operating Environment Software Requirements".

   If a package is missing, download it and install it using the following command:

   `#` `rpm -i` `package_name`

4. Check for required symbolic links:

   1. Change to the directory `/usr/bin`:

      `#` `cd /usr/bin`

   2. List these symbolic links:

      `#` `ls -l gcc g++`

      The response should be:

      `gcc -> gcc296`

      `g++ -> g++296`

5. If the symbolic links do not exist, back up the existing files and then create the links:

   1. Back up the existing files:

      `#` `mv /usr/bin/gcc /usr/bin/gcc.backup`

      `#` `mv /usr/bin/g++ /usr/bin/g++.backup`

   2. Create the symbolic links:

      `#` `ln -s /usr/bin/gcc296 /usr/bin/gcc`

      `#` `ln -s /usr/bin/g++296 /usr/bin/g++`

      Note: After you have finished installing Oracle Developer Suite 10g, you can restore the original files. The installer requires the symbolic links during the relink phase of installation.

6. If you are using the `hugemem` kernel, set the architecture by running the following command:

   `#` `setarch i386`

7. Apply Oracle patch no. 3006854. You can download this patch from OracleMetaLink (`http://metalink.oracle.com`). This patch creates the file `/etc/libcwait.so` and appends the following line to the file `/etc/ld.so.preload`:

   `/etc/libcwait.so`

#### 4.8.3.3 UnitedLinux 1.0 Requirements

Table Table 4-3, "UnitedLinux 1.0 Operating Environment Software Requirements" lists the operating environment software requirements for UnitedLinux 1.0. The procedure that follows the table describes how to ensure your computer meets these requirements.

Note: Check OracleMetaLink (`http://metalink.oracle.com`) for the most current list of supported operating environment software.

Table 4-3 UnitedLinux 1.0 Operating Environment Software Requirements

Item | Requirement
--- | ---
Operating System | UnitedLinux 1.0 (For more information, see `http://www.unitedlinux.com`)
Patches | SP2a and SP3 are certified for Oracle Developer Suite 10g. For UnitedLinux 1.0 SP2a, the minimum supported kernel and glibc versions are: 2.4.19 glibc-2.2.5-179 For UnitedLinux 1.0 SP3, the minimum supported kernel and glibc versions are: 2.4.21 glibc-2.2.5-213
Packages (check that the specified version or higher is installed.) | gcc_old-2.95.3 pdksh-5.2.14 openmotif-2.1.30MLI4 libstdc++-3.2.2-38

To ensure that your computer meets these requirements:

1. Log in as `root`.

2. Determine which distribution and version of Linux is installed, by entering the following command:

   `#` `cat /etc/issue`

   This will list out the version. For example, the response

   `Welcome to UnitedLinux 1.0 (i586) - Kernel \r (\l)`

   indicates that you have UnitedLinux version 1.0.

3. Determine the service pack version by entering 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.

4. Check that the required software packages are installed. To do this, enter the command:

   `#` `rpm -q` `package_name`

   for each package listed in the "Packages" entry in Table 4-3, "UnitedLinux 1.0 Operating Environment Software Requirements".

   If a package is missing, download it and install it using the following command:

   `#` `rpm -i` `package_name`

5. Create the following symbolic link for the Perl program if it does not already exist:

   `#` `ln -sf /usr/bin/perl /usr/local/bin/perl`

6. Create the following symbolic link for the `fuser` program if it does not already exist:

   `#` `ln -sf /bin/fuser /sbin/fuser`

7. Set up the compiler environment:

   1. Install the package `gcc_old-2.95.3`. This installs GCC compiler version GCC 2.95.3 in the directory `/opt/gcc295`.

   2. Display the symbolic links for `gcc` and `cc` by entering the following commands:

          # cd /usr/bin
          # ls -l gcc cc
          gcc -> /opt/gcc295/bin/gcc
          cc -> /opt/gcc295/bin/gcc

   3. If these symbolic links do not exist, back up the existing files and then add the symbolic links:

          # mv /usr/bin/gcc /usr/bin/gcc.backup
          # mv /usr/bin/cc /usr/bin/cc.backup
          # ln -s /opt/gcc295/bin/gcc /usr/bin/gcc
          # ln -s /opt/gcc295/bin/gcc /usr/bin/cc

      You must create these links so that Oracle Developer Suite 10g can relink during installation. Once your installation is complete, you can remove the links and restore the original files.

   4. Create the following symbolic link if it does not already exist:

          # ln -s /opt/gcc295/lib/gcc-lib/i486-suse-linux/2.95.3/libgcc.a \
          /lib/libgcc.a

      Note: The actual path to `libgcc.a` that is listed in this command may be different for your UnitedLinux installation. You may need to replace the string "`suse`" with another value.

8. If the package `orarun` was installed, complete the following steps as user `oracle` to reset your environment:

   1. 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

   2. Using a text editor, edit the file `$HOME/.profile` and comment out the following line:

      `. ./.oracle`

   3. Log out of the `oracle` user account.

   4. Log in as user `oracle`. The changes now take effect.

9. If any Java packages are installed on the computer, unset Java environment variables such as `$JAVA_HOME`.

   Note: Oracle recommends that you do not install any of the Java packages supplied with your UnitedLinux distribution.

10. If you use Network Information Service (NIS):

    1. Ensure that the file `/etc/yp.conf` contains the following line:

       `hostname.domainname` `broadcast`

    2. Ensure that the file `/etc/nsswitch.conf` contains the following line:

       `hosts: files nis dns`