Oracle8i On-Line Generic Documentation CD-ROM Installation and Usage Notes



Welcome to the Oracle8i Documentation Library on CD-ROM

This CD-ROM contains the on-line generic documentation library for Oracle8i, Release 2. You will also see the release number referred to as "Release 8.1.6" in this document and in some of the generic documentation. The two release designations are equivalent, and in some places this release is referred to as "Release 2 (8.1.6)".

The documentation on this CD-ROM is available in HTML and PDF formats. This document describes the contents of the CD-ROM and provides instructions for installing and viewing the documentation. It also includes information about ordering hardcopy documentation and contacting customer support.

This CD-ROM is a Rock Ridge/Joliet/ISO9660 hybrid CD, which should be readable by all computers which support one of those standards.

For information about new features in this release, see the on-line manual Getting to Know Oracle8i.



CD-ROM Contents and Documentation Part Numbers

This CD-ROM contains all of the the documentation listed in the tables in this section. Each title is preceded by the part number of the manual.

Some manuals which include multiple printed volumes (such as Oracle8i Concepts or Oracle8i SQL Reference) are presented as a single manual in on-line form. The part number included here refers to the multi-volume set.

The documentation on the CD-ROM is divided into the following top-level categories:
*)    Oracle8i Generic Documentation Master Index, Release 8.1.6
*)    Oracle8i Server and Data Warehousing, Release 8.1.6
*)    Oracle8i Server Application Development
*)    Oracle8i Server Networking and Security, Release 8.1.6
*)    SQL*Plus, Release 8.1.6
*)    Oracle8i interMedia, Spatial, Time Series, and Visual Information Retrieval Options, Release 8.1.6
*)    Oracle8i Java Developer's Documentation, Release 8.1.6
*)    Oracle WebDB, Release 2.2
*)    On-Line Generic Documentation Installation and Usage Notes, Release 8.1.6

The final item in the list (the Installation and Usage Notes) is equivalent to this document. It is provided on the CD-ROM in HTML, PDF, and text formats.

Some of the documentation categories are further divided into subcategories. For example, the "Server and Data Warehousing" category is subdivided into the following subcategories: "Concepts, Administration, and Reference," "Backup and Recovery," "Data Warehousing," and "Distributed Databases."

If an asterisk (*) follows a part number in one of the following tables, this indicates that the document in question has not been updated for this release, so the manual on this CD-ROM is the Release 8.1.5 version.

If a double asterisk (**) follows a part number in one of the following tables, this indicates that the documented product is in maintenance mode (bug fixes only) and the documentation on this CD has not been updated. The version provided here is the most recently released version:

*)    The SQL*Module documentation is from release 8.0.4.
*)    The Pro*Fortran documentation (including the generic Precompiler guide and the Pro*Fortran supplement) is from release 7.3.4.

If a part number is enclosed in square brackets ([  ]), this indicates that this is an online-only document (HTML and/or PDF) which is not available as a hard-copy manual.

The following tables list all the documentation on this CD.


Oracle8i Generic Documentation Master Index, Release 8.1.6
a76991    Oracle8i Generic Documentation Master Index


Oracle8i Server and Data Warehousing, Release 8.1.6

Concepts, Administration, and Reference
a76962    Getting to Know Oracle8i
a76956    Oracle8i Administrator's Guide
a76965    Oracle8i Concepts
a76992    Oracle8i Designing and Tuning for Performance
a76999    Oracle8i Error Messages
a76957    Oracle8i Migration
a76966    Oracle8i National Language Support Guide
a76961    Oracle8i Reference
a76989    Oracle8i SQL Reference
a76935    Oracle8i Supplied Java Packages Reference
a76936    Oracle8i Supplied PL/SQL Packages Reference
a76955    Oracle8i Utilities

Backup and Recovery
a76993    Oracle8i Backup and Recovery Guide
a76990    Oracle8i Recovery Manager User's Guide and Reference
a76995    Oracle8i Standby Database Concepts and Administration
a77218    Legato Storage Manager Administrator's Guide

Data Warehousing
a76994    Oracle8i Data Warehousing Guide

Distributed Databases
a76960    Oracle8i Distributed Database Systems
a76959    Oracle8i Replication
a76958    Oracle8i Replication Management API Reference


Oracle8i Server Application Development, Release 8.1.6

Application Development
a76939    Oracle8i Application Developer's Guide - Fundamentals
a76976    Oracle8i Application Developer's Guide - Object-Relational Features
a76938    Oracle8i Application Developer's Guide - Advanced Queuing
a76940    Oracle8i Application Developer's Guide - Large Objects (LOBs)
[a77004]  Oracle8i Application Developer's Guide - Large Objects (LOBs) using PL/SQL
[a77003]  Oracle8i Application Developer's Guide - Large Objects (LOBs) using OCI
[a77001]  Oracle8i Application Developer's Guide - Large Objects (LOBs) using Pro*C
[a77000]  Oracle8i Application Developer's Guide - Large Objects (LOBs) using Pro*COBOL
[a77005]  Oracle8i Application Developer's Guide - Large Objects (LOBs) using Visual Basic (OO4O)
[a77002]  Oracle8i Application Developer's Guide - Large Objects (LOBs) using Java
a76937    Oracle8i Data Cartridge Developer's Guide

Language and Interface Documentation

a76975    Oracle Call Interface Programmer's Guide
a77069    PL/SQL User's Guide and Reference
a76942    Pro*C/C++ Precompiler Programmer's Guide
a76951    Pro*COBOL Precompiler Programmer's Guide
A58231**  SQL*Module for ADA Programmer's Guide
A42523**  Programmer's Guide to the Oracle Precompilers
A42525**  Pro*Fortran Supplement to the Oracle Precompilers Guide
    

Oracle8i Server Networking and Security, Release 8.1.6
a76933    Net8 Administrator's Guide
a76932    Oracle Advanced Security Administrator's Guide
a77230    Oracle Internet Directory Administrator's Guide


Oracle8i Parallel Server, Release 8.1.6
[a76972]  Oracle8i Parallel Server Documentation Online Roadmap
a76970    Oracle8i Parallel Server Administration, Deployment, and Performance
a76934    Oracle8i Parallel Server Setup and Configuration Guide
a76938    Oracle8i Parallel Server Concepts


SQL*Plus, Release 8.1.6
a75664    SQL*Plus Quick Reference
a75665    SQL*Plus User's Guide and Reference


Oracle8i interMedia, Spatial, Time Series, and Visual Information Retrieval Options, Release 8.1.6

interMedia Options
a77061    Oracle8i interMedia Text Migration
a77063    Oracle8i interMedia Text Reference
a67296*   Oracle8i interMedia Audio, Image, and Video Java Client User's Guide and Reference
a67299*   Oracle8i interMedia Audio, Image, and Video User's Guide and Reference
a67298*   Oracle8i interMedia Locator User's Guide and Reference

Spatial, Time Series, and Visual Information Retrieval Options
a77132    Oracle Spatial User's Guide and Reference
A67294*   Oracle8i Time Series User's Guide
A67293*   Oracle8i Visual Information Retrieval User's Guide and Reference
A67300*   Oracle8i Visual Information Retrieval Java Client User's Guide and Reference


Oracle8i Java Developer's Documentation, Release 8.1.6
a81356    Oracle8i Enterprise JavaBeans and CORBA Developer's Guide
a81353    Oracle8i Java Developer's Guide
a81358    Oracle8i Java Stored Procedures Developer's Guide
a81354    Oracle8i JDBC Developer's Guide and Reference
a81357    Oracle8i JPublisher User's Guide
a81360    Oracle8i SQLJ Developer's Guide and Reference


Oracle WebDB, Release 2.2
a77075    Oracle WebDB Tutorial
[a77057]  Oracle WebDB Creating and Managing Components - Task Help
[a77055]  Oracle WebDB Creating and Managing Components - Field-Level Help
[a77056]  Oracle WebDB Creating and Managing Sites - Task Help
[a77058]  Oracle WebDB Creating and Managing Sites - Field-Level Help



Tools Requirements

You may choose to install the documentation onto your local system, or you can read the files directly from the CD-ROM without installing them. You need one of the tools listed in the following table to view the documentation from either location.


Table 1-1 Minimum Tools Requirements for Viewing Documentation

On-Line Format    Requires

HTML viewing      Netscape Navigator 3.0 (or higher)
                  Microsoft Internet Explorer 3.0 (or higher)
PDF viewing       Acrobat Reader 3.0 (or higher)
                  Acrobat Reader+Search 3.0 (or higher)
                  Acrobat Exchange 3.0 (or higher)
                  PDFViewer Web browser plug-in 1.0 (or higher)


Note: Acrobat Reader is available for free download from the Adobe web site (http://www.adobe.com/) for the following platforms: Mac OS, Windows 95, Windows 98, Windows NT, Windows 3.1x, Sun Solaris SPARC, Sun Solaris x86, DEC Alpha, HP-UX, IBM AIX, SGI IRIX, Linux, and OS/2 Warp.



Disk Space Requirements

The disk space requirements for installing the on-line documentation are listed in the table below. For Release 8.1.6, the only installation option is to install the complete HTML and PDF documentation set. It is not possible to customize the installation.


Table 1-2 Installation Disk Space Requirements

Format        Disk Space Required for Installation

HTML & PDF    386 MB




Installing Documentation

You can install the documents on this CD-ROM in either of two ways:

1.	By copying the files from the CD-ROM to your local system.
2.	By using the Oracle Universal Installer included with your Release 8.1.6 software distribution, which provides a GUI interface for installation.

Note: The installation components on this CD-ROM are not compatible with pre-Oracle8i versions of the Oracle Installer. You must use the Oracle Universal Installer, which is new with Oracle8i.


File Copy Installation

The simplest installation method is a direct file copy from the CD-ROM to your local system. Use your operating system's commands to copy the contents of the DOC directory on the CD-ROM to the appropriate installation directory on your system.

Note: If you use this installation mechanism, your on-line documentation will not be automatically integrated with other documentation installations on your system.


Installing With the Oracle Universal Installer

See the Oracle8i Installation Guide for your platform for instructions on how to install and launch the Oracle Universal Installer.

When the installer prompts you to select a product to install, navigate to the CD-ROM and locate the file /INSTALL/docs_816.jar. Use this file as the basis for your installation.

The location of the installed documentation files is determined according to the following rules:

*)    If ORACLE_DOC is defined in the environment, the files are installed in that directory.
*)    If ORACLE_DOC is not defined, but ORACLE_BASE is defined, the files are installed under the $ORACLE_BASE/doc directory.
*)    If neither ORACLE_DOC nor ORACLE_BASE is defined in the environment, the files are installed under the $ORACLE_HOME/doc directory.



Viewing Documentation

You can install the documentation on this CD-ROM onto your local system, or you can view the documentation directly from the CD-ROM. See "Tools Requirements" on page 6 for information about the tools necessary to view the documentation.

The Oracle Information Navigator (OIN) is a Java Applet which is provided both on the CD-ROM and as part of the installed documentation. It provides a "tree" view of the documentation library for random file access and allows you to perform searches across the library. For more information on using OIN, see "Using the Oracle Information Navigator (OIN)" on page 9.

To view the HTML and PDF documentation from a local installation or from the CD-ROM, follow these steps:

1.    Use your browser to open the top-level index.htm file within the installed documentation directory, or within the /DOC directory on the CD-ROM. 
Note: If you do not wish to launch the Information Navigator Java applet, open the file products.htm instead of index.htm.
2.    Click on the category of documentation you wish to view (Server and Data Warehousing, Application Development, Networking and Security, Parallel Server, interMedia, Java, or WebDB).
3.    On the resulting product-level index file, click on the HTML or PDF link corresponding to the book you wish to view. Clicking the HTML link takes you to the table of contents for that book; clicking the PDF link displays the appropriate document using your installed Acrobat products or your browser's Acrobat plug-in.
Note: The "PDF Directory" bookmark at the top of each manual's PDF bookmark list is only valid if you have opened the file directly, using Acrobat, or have navigated to it using the PDF index. See "Viewing PDF Documentation Without a Browser" on page 9 for more information.



Using the Oracle Information Navigator (OIN)

You can randomly access files in the documentation library using the Oracle Information Navigator's "tree" view. You can also use the OIN's search capabilities to search through the documentation library . The OIN requires a frames-enabled, Java-enabled web browser. To start using the Information Navigator, point your browser to:

*)    /DOC/index.htm on the CD-ROM
*)    $ORACLE_DOC/index.htm for installed documentation. If you did not install the documentation in ORACLE_DOC, adjust the path accordingly.

When you open one of these pages in your browser, the OIN applet loads, and the OIN utility displays in a separate window. If the OIN window is not visible after loading, it may be behind the main browser window.

Note: The OIN may not be fully compatible with all browser, platform, and Java environment configurations. If you run into difficulties, you may choose to view the documentation without the OIN. The OIN also uses HTML frames, so if you wish to view the documentation without frames, you should view the documentation without OIN. To view the documentation without launching OIN, load the top-level file products.htm instead of index.htm.

For information on how to use the Information Navigator, click on the Help button in the Information Navigator window. The help screens display in the main browser window.



Viewing PDF Documentation Without a Browser

It is possible to view the PDF documentation without using a web browser. To do so, follow these steps:

1.	Open Acrobat Reader or Acrobat Exchange.
2.	Choose the File > Open menu option.
3.	In the resulting dialog navigate to the /DOC/index.pdf file on the CD-ROM, or the top-level index.pdf file in your installed documentation. From this index file you can navigate to all of the PDF documentation on the CD-ROM.

Each of the PDF files also contains a "PDF Directory" bookmark at the top of the bookmark list. Clicking on this bookmark takes you up one level in the PDF index hierarchy.

The documentation in the PDF index files is divided into the same categories as the HTML documentation. See "CD-ROM Contents and Documentation Part Numbers" on page 1 for information about the different categories.

You can also open an individual PDF file directly without browsing through the PDF index pages. To do so, follow these steps:

1.	Open Acrobat Reader or Acrobat Exchange.
2.	Choose the File > Open menu option.
3.	In the resulting dialog navigate to the file you wish to view, select it, and click the Open button. PDF files are named for the part number of the manual (e.g., a12345.pdf). A list of the part numbers is available in the section "CD-ROM Contents and Documentation Part Numbers" on page 1. PDF files are located within the following directories:

On the CD-ROM:
*)    /DOC/mix.816 for the Master Index
*)    /DOC/server.816 for Server and Data Warehousing documentation
*)    /DOC/appdev.816 for Application Development documentation
*)    /DOC/network.816 for Networking and Security documentation
*)    /DOC/paraserv.816 for Parallel Server documentation
*)    /DOC/sqlplus.816 for SQL*Plus documentation
*)    /DOC/inter.816 for interMedia, Spatial, Time Series and Visual Information Retrieval documentation
*)    /DOC/java.816 for Java documentation
*)    /DOC/webdb.816 for WebDB documentation

Installed on your local system:
*)    $ORACLE_DOC/mix.816 for the Master Index
*)    $ORACLE_DOC/server.816 for Server and Data Warehousing documentation
*)    $ORACLE_DOC/appdev.816 for Application Development documentation
*)    $ORACLE_DOC/network.816 for Networking and Security documentation
*)    $ORACLE_DOC/paraserv.816 for Parallel Server documentation
*)    $ORACLE_DOC/sqlplus.816 for SQL*Plus documentation
*)    $ORACLE_DOC/inter.816 for interMedia, Spatial, Time Series and Visual Information Retrieval documentation
*)    $ORACLE_DOC/java.816 for Java documentation
*)    $ORACLE_DOC/webdb.816 for WebDB documentation

Note: If you did not install the documentation in ORACLE_DOC, adjust the path accordingly.

So, for example, if you want to view the Oracle8i SQL Reference directly, without using a browser or the index.pdf files, you would first look up the category and part number of the document in the tables earlier in this document. That manual is in the "Server and Data Warehousing" category, and the part number is a76989. So you would then open the /DOC/server.816/a76989.pdf file on your CD, or the corresponding file in your installed documentation.



Ordering Hard Copy Documentation or CD-ROMs

To order printed documentation or additional copies of this CD-ROM, visit the online Oracle Store at http://oraclestore.oracle.com.



Contacting Oracle Support Services

If you need to contact Oracle Support Services, you have a variety of web-based information sources:

*)    Web-based technical support from Oracle Support Services:
http://www.oracle.com/support/

*)    Support offerings and processes:
http://www.oracle.com/support/welcome/index.html 

*)    Global Support contact numbers:
http://www.oracle.com/support/contact_us/sup_hot_phone.html 



Sending Comments 

If you have questions or comments about this CD-ROM, please e-mail your feedback to doc_talk@us.oracle.com.

If you have comments about the content of a particular book, please use the e-mail address provided on the book's reader comment form. Use the "Send Us Your Comments" link from the book's table of contents to reach the reader comment form.
