4
Installing Oracle8i Enterprise Edition
Bundle and Online Documentation

This chapter describes how to install the Oracle8i Enterprise Edition bundle.

Note:
The examples given represent an Oracle8i Enterprise Edition installation. If you are installing Oracle8i, you will have fewer product selections available to choose from. The Advanced Replication, Object Support, Spatial Data and Data Partitioning options are available only in the Oracle8i Enterprise Edition release. These are not listed or available in the Oracle8i release.

The following steps are in the order that they need to be performed:

Figure 4-1 Installation

Step 1. Logging Into the Oracle8i Database Administrator's Account

Begin the installation of the Oracle8i Enterprise Edition by logging into the Oracle8i database administrator's account. For example:

Username: ORACLE8

Password: <not displayed when entered>

Step 2. Setting the Oracle Root Directory

Once you are logged in, your default directory is set to the device and directory defined in the SYSUAF entry for the ORACLE8 user. If this directory is to become the ORACLE root directory (the directory under which the Oracle products will be installed), proceed to Step 3.

To place the ORACLE root directory in another directory or subdirectory, then issue an appropriate CREATE/DIRECTORY command. For example:

$ CREATE/DIRECTORY/OWNER=[ORACLE8] -

  <disk_device>:[<directory>]

where:

[ORACLE8] is the owner of the directory

<disk_device> is a valid disk device

[<directory>] is a valid directory file specification

Warning:
Make sure that you specify the "/OWNER" switch on the above CREATE/DIRECTORY command.

Note:
The Oracle root directory may only be a top-level directory or one level below a top level directory.

Then set your default to this directory as follows:

$ SET DEFAULT <disk_device>:[<directory>]

Step 3. Mounting the Oracle8i Enterprise Edition Distribution

Mount the Oracle8i Enterprise Edition distribution on your CD-ROM device. For example:

$ MOUNT/OVERRIDE=IDENTIFICATION <ddcn>:

where:

<ddcn> is a valid CD-ROM device

Step 4. Restoring the Oracle8i Enterprise Edition BOOT.BCK

Use the following BACKUP command to restore the BOOT.BCK saveset for the Oracle8i Enterprise Edition product bundle on the CD-ROM to the current directory (which will become ORA_ROOT):

$ BACKUP/LOG <ddcn>:[SERVER]BOOT.BCK/SAVE_SET -
  []/NEW_VERSION/BY_OWNER=PARENT

As the BOOT.BCK saveset is restored, you will see a listing of each file as it is restored. For example:

%BACKUP-S-CREATED, created DKA100:[ORACLE8]DDBOPT.CTL;1
.
.
.
%BACKUP-S-CREATED, created DKA100:[ORACLE8]UTIL.CTL;1
%BACKUP-S-CREATED, created DKA100:[ORACLE8]UTIL.DEF;1

Step 5. Invoking ORACLEINS

From the Oracle8 root directory, invoke ORACLEINS:

	$ @ORACLEINS

The ORACLE Installation Startup Menu appears:

Step 6. Selecting "Create a new ORACLE system"

Follow these steps to select "Create a new ORACLE system."

Select Option 1, "Create a new ORACLE system."

A prompt similar to the following appears:

                  Create ORACLE from distribution media.

                  ---------------------------------------
ORACLE Installation Version 1.0.12.15 - Production on . . .
Copyright (c) 1999, Oracle Corporation, . . . 
Root directory? ( DISK$DEV:[<dir>.<dir>] )

Note:
You should only choose this option the first time you run ORACLEINS on a code tree.

Press [RETURN] since you are already in the root directory.

ORACLEINS assigns the specified directory to the logical name ORA_ROOT and displays the following prompt:

The root directory will be DISK$DEV:[<default_location>].
If you are loading products from savesets, enter the drive/directory where 
the savesets are located (e.g. MUA0: or DISK$A:[ORACLE.SAVE_SETS]). If you 
are loading from a remote device, do not include a username and password 
(you will be prompted instead).
If not loading savesets, press [RETURN]. 

Saveset location or [RETURN]:

The saveset location depends on your installation media.

If you load savesets from a remote location, specify the remote node, device, and directory path using the following format:

<remote_node>::<remote_device>:[<remote_directory_path>]

If you specify a remote load location, ORACLEINS warns you that it cannot verify that the remote device actually exists. It also asks you to specify a remote OpenVMS username and password. If you do not need to specify a username or password (for example, because OpenVMS proxies have been established), press [RETURN]. Otherwise, enter the username and password, separated by a space.

For example, if the remote location is owned by the OpenVMS user ORACLE, with password FRIDAY, then the following message appears:

WARNING: The saveset location that you specified is on a remote device. We 
can only do minimal checking to see if the device is available.

Enter the remote VMS username and password needed to access this location, 
or [RETURN] if one is not required: ORACLE FRIDAY

If you are loading savesets from a local disk or CD-ROM, enter the device name and the directory path and press [RETURN], for example, DKA400:[SERVER].

The logical name ORA_SOURCE is set to the saveset location you entered.

ORA_ROOT:[INSTALL] is created by ORACLEINS and is assigned the logical name ORA_INSTALL. The contents of the BOOT.BCK saveset are moved to the INSTALL subdirectory of the Oracle8 root directory.

The logical ORA_SOURCE now points to the default load location for product 
savesets. ORA_SOURCE has the following definition: DKA400:[SERVER]
                 --- Doing some setup - please wait... ---
 - Creating ORA_UTIL:ORAUSER.COM.

 - Adding INSTALLUSER.COM to ORAUSER.COM.

 - Linking INSDRV.EXE for Install version 1.0.12.15 on VMS 7.2-1
Press [RETURN] to continue:

Press [RETURN].

After the contents of the saveset have been moved, the Main Menu appears:

Step 7. Selecting Products to Load

Follow these steps to select products to load.

Select Option 1, "Software Installation and Upgrade Menu."

The Software Installation and Upgrade Menu appears:

Select Option 1,"Select Licensed Products to Load."

A list of Oracle products appears. For example:

Select the products for which you have a license.

If you are preparing a client only installation, you must select the following products to run Oracle8:
- NETCONFIG
- UTIL
In addition, if you are preparing a server for a client/server installation, you must select the following products:
- RDBMS
Note:
When installing the 8.1.7 Server, ensure that a unique image identifier per software tree is chosen on the RDBMS configuration menu.
- Any of the server extensions for which you have a license, such as DDBOPT (distributed database option) or HOOPT (advanced replication option)
- SVRMGR (Server Manager)
To fit all the product names on the screen, ORACLEINS displays the short, abbreviated names for some products. For example, it displays "SVRMGR" instead of "Server Manager".

For each product you selected, you are prompted to specify the location from where it is loaded with a message similar to the following:
```
Copy from ( ORA_SOURCE:NETCONFIG.BCK )
```

To accept the default, press [RETURN].

Accepting the default means you are loading the product savesets from the location you assigned to the ORA_SOURCE logical name.

To specify a different location, enter the correct location and the saveset name at the "Copy from" prompt, and press [RETURN].

The product you selected for loading is marked with -load.

Note:
This step only selects which products are to be loaded. Only after you select Option 3 from the Software Installation and Upgrade Menu ("Load and Build Selected Licensed Products") does ORACLEINS actually load the products you selected.

After locations for all licensed products are entered, enter E.

Select the products and return to the Software Installation and Upgrade Menu.

Step 8. Configuring Products

Follow these steps to configure products.

Configure all products.
- If you are reconfiguring products that are already installed, you must access the configuration menu of each product selected in the "Select Licensed Products to Load" step, even if you accept only the defaults. Only those products whose configuration menus are accessed and products that depend on the selected ones will be built.
- If you are installing a product for the first time, access its configuration menu, even if you accept only the defaults.
- If you are installing the RDBMS for the first time, use the configuration menu to change its default image identifier if another Oracle Server on the system is using the default.
  
  Note:
  Each image identifier should be unique per software tree. It can be set or changed in the RDBMS configuration menu.
To begin configuring the products you have loaded, select Option 2, "Select Build Configuration Options."

Select the Configuration Options Menu.

The Select Configuration Options Menu appears below:
Consider each configuration option carefully.
Enter the number of each product you need to configure.

Each product appears in turn with its default configuration options. For example, here is the Server Manager Configuration Menu:

Note:
Do not simply select the current values. The configuration options you select will have serious consequences in the way your Oracle system works. For more information about configuration options, see Appendix A, "Oracle8i Products".

To enter a new value, enter the number of the option you want to change and press [RETURN]:
```
Enter the number of the option that you want to change: 1
```

The following screen appears:

System or Group installation? [S/G]

   Original Default:  S
   Current Value   :  S
   New Value        >

When the option is displayed at the bottom of the screen, enter the new value and press [RETURN].

The following screen appears:

System or Group installation? [S/G]

   Original Default:  S
   Current Value   :  S
   New Value        > G

To save any changes made to the configuration options and to mark a product for rebuilding, type E to exit the menu screen.

The Select Configuration Menu appears with -rebuild beside the products you selected.

If needed, select another product to configure from the Configuration Menu.

When you have configured all products you want to install, enter E to exit to the Select Configuration Options menu and press [RETURN].

Note:
If you expect more than one Oracle Installation on your system make sure you specify a unique string value of up to 6 chars to the following RDBMS config option: 2. Oracle Image Identifier

Step 9. Loading and Building Configured Products

After configuring the products, you are returned to the Software Installation and Upgrade Menu.

Select Option 3, "Load and Build Selected Licensed Products."

The system loads the products you selected and configured. This step takes several minutes. You will see several messages as the products are loaded.

You will eventually see a message similar to this one:

- Creating NETCONFIG directories.
- Loading NETCONFIG files into ORA_ROOT: [NETCONFIG].
%BACKUP-S_CREATED, created ORA_ROOT:[NETCONFIG]. . .
.
.
.
The products you requested have been loaded.

You have the following options:

1. Build the Oracle products loaded.

2. Return to the Software Installation and Upgrade Menu
(to choose new configuration values or to load
additional products from another tape or directory.)

Enter the number of option you want [2]:

The next step depends on your situation:
- If you have additional product bundles to load, press [RETURN].
- If you have additional products to load from a second CD-ROM, enter 2 and press [RETURN].
- If you decide to change the configuration options you just entered, then reconfigure the products.
- If you have no more products to load, enter 1 and press [RETURN].
  
  All selected products are now built. You will see a message similar to this:
```
	12 products have been successfully built.

Note: If you want to create known file entries for some 

of the linked products using the VMS INSTALL utility, 

run ORA_INSTALL:ORA_INSUTL.COM. Refer to the appropriate 

ORACLE for OpenVMS Administrator's Guide for details.

	

	Press [RETURN] to continue:
```
1. Press [RETURN] to return to the Software Installation and Upgrade Menu.
2. Press E to return to the Main Menu.
3. Press E to return to the DCL prompt.
Step 10. Installing Online Documentation

Oracle8i Release 3 (8.1.7) includes online documentation for the following OpenVMS-specific guides:
- Oracle8i for Alpha OpenVMS Installation Guide (this manual)
- Oracle8i for Alpha OpenVMS Server and Tools Administrator's Guide
- SQL*Net for Alpha OpenVMS Configuration and User's Guide
- Oracle8i Parallel Server Addendum for Alpha OpenVMS
Beginning with Oracle7 Release 7.3.2, online documents were distributed in HTML format and could be viewed using an HTML browser on OpenVMS (or another system in your environment if you prefer). Oracle has successfully tested viewing of the HTML files using Enhanced Mosaic V2.10. Note that Enhanced Mosaic V2.10 is bundled with Motif 1.2-4.

Online documentation installation and usage instructions are as follows:
1. Create a root level directory named ORACLEDOC. The documentation will need approximately 2MB of disk space.
```
$ CREATE/DIRECTORY/OWNER=[ORACLE8] -

<disk_device>:[ORACLEDOC]/PROTECTION=WORLD:RE
```
  where:
  
  [ORACLE8] is the owner of the directory
  
  <disk_device> is a valid disk device
1. Make ORACLEDOC your default directory.
```
$ SET DEFAULT <disk_device>:[ORACLEDOC]
```
1. Mount the Product media.
```
$ MOUNT/OVERRIDE=IDENTIFICATION <ddcn>:
```
where:

<ddcn> is a valid CD-ROM device.
1. Copy the entire oracledoc directory structure contents to the disk.
```
$ COPY/LOG <ddcn>:[ORACLEDOC...]*.*[]
```
where:

<ddcn>: is the CD-ROM device.
1. To view the Oracle documentation, invoke your HTML browser and open the following URL:
```
FILE:/<disk_device>/ORACLEDOC/PRODUCTS.HTM
```

4 Installing Oracle8i Enterprise EditionBundle and Online Documentation