Oracle8i Release Notes
Release 3 (8.1.7) for Intel UNIX (DG/UX Intel and SCO UnixWare)



Release Notes

Release 3 (8.1.7) for Intel UNIX (DG/UX Intel and SCO UnixWare)

April 2001


These release notes contain important last minute information not included in the documentation library of your Oracle8i for Intel UNIX (DG/UX Intel and SCO UnixWare) Online Documentation CD-ROM.

This document contains the following topics:

Hardware Requirements

The following hardware is required to install Oracle8i release 3 (8.1.7) on Intel Unix systems.

System Requirements

Hardware  Requirements 


A minimum of 128 MB is required to install Oracle8i products. Oracle8i Client products require 64 MB. 

Swap Space 

Twice the amount of RAM or at least 400 MB, whichever is greater, is recommended for most systems. 

CD-ROM Device  

A CD-ROM drive supported by UNIX is required. Oracle uses ISO 9660 format CD-ROM disks with RockRidge extensions. 

Unix System Configuration (SCO UnixWare only)

In addition to the parameters listed in the Oracle8i Installation Guide Release 3 (8.1.7) for Intel UNIX (DG/UX Intel, SCO UnixWare, Solaris Intel), set the STRTHRESH parameter to 0x0. This setting removes the limit on STREAMS resources being used by the operating system kernel.

Java Runtime Environment (JRE)

The JRE shipped with Oracle8i is used by Oracle Java applications such as Oracle Universal Installer and is the only one supported to run with these applications. Customers should not modify this JRE, unless it is done through a patch provided by Oracle Support Services.


This section contains information on Oracle8i documentation.

Additional README Files

Additional product README files are located in the product subdirectories in the Oracle home directory or in the $ORACLE_HOME/relnotes directory.

Online Support

The following websites have the most current information about products included with this release:

SPX Protocol Adapter

Oracle8i release 3 (8.1.7) does not include an SPX protocol adapter for Intel UNIX. Intel UNIX clients cannot connect to an Oracle8i database using the Novell SPX protocol.

Default JDBC Driver Behavior

In Oracle8i release 3 (8.1.7), the default behavior for the ResultSet::getXXXStream() APIs have been modified to comply with the JDBC specification. They return null values for database null LONG or LONG RAW values. In earlier versions of the JDBC drivers, the default behavior was to return the empty stream for database null values. To restore the previous JDBC default behavior when using the release 8.1.7 drivers, you must use the Java property jdbc.backward_compatible_to_8.1.6. For example, to cause the release 8.1.7 JDBC drivers to return empty streams from calls to ResultSet::getXXXStream(), set the following command at the virtual machine:

java -Djdbc.backward_compatible_to_8.1.6 myJavaProgram

The jdbc.backward_compatible_to_8.1.6 Java property applies to the release 8.1.7 JDBC Thin driver and the OCI driver.

Single-Task Linking for Large Exports/Imports and SQL*Loader Jobs

It is efficient to use the single-task architecture to transfer large amounts of data between the user and Oracle8i. To make the single-task import (impst), export (expst), and SQL*Loader (sqlldrst) executables, use the make file in the $ORACLE_HOME/rdbms/lib directory. Enter the following:

$ cd $ORACLE_HOME/rdbms/lib
$ make -f singletask


Linking Oracle executables as single-task allows a user process to directly access the entire system global area (SGA). In addition, running single-task requires more memory because the oracle executable text is no longer shared between the front-end and background processes. 

Installation Issues

This section contains information on installation issues.

Using Hummingbird Exceed

If you are using the Hummingbird Exceed X-windows server while installing and using Oracle8i, set the window manager to Native so that Microsoft windows functions as the window manager. See the Exceed documentation for instructions on configuring the window manager.

While Oracle supports the use of Exceed for installing and configuring products, be aware of the following common installations problems with using this X Windows server:

  1. There is a bug in the way Exceed handles screen coordinates. The Installer window and related Installer dialog boxes or configuration assistants may not display correctly when run through the Exceed server. These display problems may include:

    • Truncation of the main window when you click the [Next] button, making the screen unreadable.

    • Expansion of an Installer window, causing the dialog buttons to be displayed off the screen. If this happens, you cannot use a mouse to select the buttons.

    To fix either problem, you must exit the entire X Windows session and start a new session. You cannot fix the problem by opening a new shell and re-running the Installer from the shell.

  2. To correct problems with hidden dialog box fields, perform the following:

    1. Select Program>Exceed>xconfig> from the Windows Start menu.

      The Xconfig window appears.

    2. Select the Font applet.

      The Font Settings dialog box appears.

    3. Click [Font Database...].

      The Font Database dialog box appears.

    4. De-select the Automatic Font Substitution option.

    5. Click [Add...].

      The Add Font Directory dialog box appears.

    6. Select the Server option.

    7. Enter the host name for your system in the Host Name field. Leave the default settings for all other entries.

    8. Click [OK] or [Close] on all dialog boxes to save the settings.

    9. Close the Xconfig window.

New Oracle Home Directory

Oracle Corporation recommends that you install Oracle8i release 3 (8.1.7) into a new Oracle home directory. Do not install Oracle8i release 3 (8.1.7) into an Oracle home directory that already contains Oracle products.

If you must install Oracle8i release 3 (8.1.7) into an Oracle home directory that contains release 8.1.5 or release 8.1.6 products, use the Installer to remove the release 8.1.5 or release 8.1.6 products before beginning the new installation.

Non-Interactive Installation

Be aware of the following issues when running the Oracle Universal Installer in non-interactive mode.

Character Mode

Oracle no longer provides a character mode installer. However, you can configure the Oracle Universal Installer to perform a non-interactive installation of Oracle products. You can run the Installer in non-interactive mode directly from your system's X-windows console or through an X-terminal or PC X-Windows server on a remote system.

For more information on the non-interactive installation of Oracle products, see the Oracle8i Installation Guide Release 3 (8.1.7) for Intel UNIX (DG/UX Intel, SCO UnixWare, Solaris Intel).

Required Support Files Compatibility

Oracle8i release 3 (8.1.7) client-side libraries are compatible with release 2 (8.1.6) client-side libraries if the libraries are used with Oracle applications and tools. The libraries are not compatible when used by a database or listener. This means that applications and tools running in the same Oracle home directory as these 8.1.6 client-side libraries will not encounter runtime errors if the libraries are upgraded to 8.1.7 during an installation. If you upgrade the 8.1.6 client-side libraries in the same Oracle home directory as an Oracle8i release 2 (8.1.6) database or listener, and the database or listener is not also upgraded to release 8.1.7, the release 8.1.6 versions of the database or listener do not work. To keep the older versions of the database or listener intact, you must install Oracle8i release 3 (8.1.7) in a new Oracle home directory.

Known Upgrade Issues

Review the following known upgrade issues before upgrading Oracle8i.

Bug 1344446

If you attempt to upgrade an Oracle8i release 2 (8.1.6) database to a release 3 (8.1.7) database in the same Oracle home directory, you will receive ignorable installation runtime errors that occur when the release 8.1.6 software is de-installed.

Oracle Universal Installer upgrades software by first de-installing the old software, then installing the new software. The errors that occur during an upgrade in the same Oracle home directory appear as relinking errors during the RDBMS and Net8 Server installation. Because these errors are relinking errors that occur during the de-installation of the release 8.1.6 software and because the affected files are replaced and relinked again when the release 8.1.7 software is installed, you can safely ignore these errors.

While upgrading the software, Oracle Universal Installer displays error dialog boxes with the following messages:

Click [Ignore] on each of these dialog boxes to allow the installation to continue. To avoid these errors, install the release 3 (8.1.7) software into a new Oracle home directory, then perform the database upgrade.

Enabling and Disabling System Triggers

Before performing either a manual database upgrade or an automated database upgrade using Oracle Data Migration Assistant, you must first set the _SYSTEM_TRIG_ENABLED parameter in the initialization parameter file to FALSE. After upgrading the database, you must either remove the _SYSTEM_TRIG_ENABLED parameter from the initialization parameter file or set it to TRUE before attempting to upgrade any other products, for example Oracle JServer. Refer to the Oracle8i Migration guide for more information on upgrade and migration.

Oracle Universal Installer Known Problems, Restrictions, and Workarounds

Review the following known problems, restrictions, and workarounds before using the Oracle Universal Installer:

Ejecting the Software CD-ROM

In X-windows environments, you can launch the Oracle Universal Installer by selecting the runInstaller script in the File Manager window. You can also launch the Oracle Universal Installer by executing the runInstaller script from a shell.

If you launch the Oracle Universal Installer by selecting the runInstaller script in the File Manager window, you cannot eject the CD until you terminate the installation session. However, you must eject the CD to continue with multi-CD installations. To successfully install products that require you to insert multiple CDs, you must execute the runInstaller script from a shell.

Installing the Pro*COBOL Release 8.1.7 Precompiler

In Oracle8i release 3 (8.1.7) you must set the COBDIR environment variable to a valid path before running the Oracle Universal Installer. If you do not set this environment variable before starting the installation session, the Pro*COBOL release 8.1.7 precompiler is not available for selection during installation.


You cannot de-install Oracle JServer separately from other products installed with Oracle8i release 3 (8.1.7).

De-installing Oracle JServer causes Oracle Universal Installer to remove Oracle8i and other products dependent on Oracle JServer from your system.

System Management Products

This section describes issues about system management products.

Oracle Intelligent Agent

In Oracle8i release 3 (8.1.7), you can install the Oracle Intelligent Agent extensions (Oracle Applications Extensions, Oracle HTTP Server Extensions, Oracle EBusiness Management Tool Extensions, and so on) separately.

This means that during installation, you can select the Oracle Intelligent Agent and separately select any of the Oracle Intelligent Agent extensions. Oracle Data Gatherer is installed as part of the basic Oracle Intelligent Agent.

OEM_MONITOR Database Role

You can grant the OEM _MONITOR database role to any database user as a "preferred credential" when registering advanced (database) events available with the Oracle Enterprise Manager Diagnostics Pack.

This role is defined in the $ORACLE_HOME/rdbms/admin/catsnmp.sql script which is called by the catalog scripts at database creation time. In addition to the OEM_MONITOR role, the database user requires quota on their default tablespace within the monitored database, to have some of the advanced events evaluated. If you fail to do this, an insufficient privilege message appears.

Reinstalling Oracle8i Server

If you reinstall Oracle8i Server into an Oracle home directory where Oracle8i Server release 3 (8.1.7) is already installed, you must also reinstall any product options, such as Oracle Partitioning, that were enabled before you began the reinstallation.

Oracle Internet Directory

Several products included with Oracle8i release 3 (8.1.7) are now directory-enabled and can take advantage of an LDAP version 3 directory server such as Oracle Internet Directory. However, Oracle Internet Directory Server is not released with Oracle8i release 3 (8.1.7) for Intel UNIX (DG/UX Intel and SCO Unixware).

Oracle Advanced Security

If you use the Custom installation type of Oracle8i Enterprise Edition to install Oracle Advanced Security into an existing Oracle home directory that already contains Oracle8i Enterprise Edition, you must install Oracle Advanced Security separately from any other product options, or the installation fails. To use the Radius adapter configured for CHAP (challenge-response) mode, you must relink the oracle executable and the Oracle svrmgrl and sqlplus clients with JDK release 1.1.7.

Oracle Database Configuration Assistant

When you use Oracle Database Configuration Assistant to create a custom database that includes Oracle JServer, it can take over an hour to finish loading Oracle JServer into the database depending on your system's hardware configuration.

Net8 Configuration Assistant

In a Typical, silent installation of Oracle8i release 3 (8.1.7), Net8 Configuration Assistant does not configure an IIOP listening end point to provide access to Oracle JServer. After installation, start the Net8 Configuration Assistant from the command line and configure an IIOP end point for the listener called LISTENER. For more information, see the Net8 Administrator's Guide.

Heterogeneous Services Agent Control Utility

The Heterogeneous Services Agent Control Utility (agtctl) incorrectly reports its version as The correct version of this utility is

Oracle Parallel Server (DG/UX Only)

This section contains the following topics:

Creating Raw Devices and the SYSTEM Tablespace

When creating a database for use with Oracle Parallel Server, you must set the SYSTEM tablespace size to 274 MB. If you are creating a custom database with the Oracle Database Configuration Assistant, you must change the SYSTEM tablespace size from the default of 260 MB to 274 MB before creating the database. In addition, the size of the raw device that you create for the SYSTEM tablespace must also be at least 275 MB. This requirement supersedes the corresponding file size requirement listed in the Oracle8i Parallel Server Setup and Configuration Guide. For more information on creating raw devices on Intel UNIX systems, see the Oracle8i Administrator's Reference.

Parallel Server Manager and Parallel Server Management

Be aware of the following differences between Oracle Parallel Server Manager and Oracle Parallel Server Management:

Starting Listeners on Remote Nodes

When running in Cluster mode and creating new listeners, the Net8 Configuration Assistant sometimes fails to start the newly created listeners on all nodes of the cluster. To work around this problem, log in to each node and enter the command: lsnrctl start listenername.

Copyright © 2001 Oracle Corporation.

All Rights Reserved.