Oracle9i Enterprise Edition Installation Guide
Release 1 (9.0.1) for OS/390

Part Number A89900-01
Go To Documentation Library
Library
Go To Product List
Product
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

3
Installation Steps

This chapter discusses the steps required to install Oracle9i for OS/390.

The following topics are included:

Checklist: Installation of Oracle9i for OS/390

Installation Setup and Initialization

Step 1:  Load the Oracle Installation JCL

Step 2:  Create the ISPF Libraries

Step 3:  Invoke the Product Installation and Customization Process

Step 4:  Select Product Set from the Oracle Product Install Menu (Panel OR@PRIM)

Step 5:  Select Installation/Customization Options from the Oracle Primary Option Menu (Panel OR@INST)

Product Installation

Step 1:  Modify Tape Unit and Library Index (Panel ORINIP00)

Step 2:  Select Oracle Products for Installation (Panel ORPRODS)

Step 3:  Select Language Message Modules (Panel ORLANG)

Step 4:  INSTLIB/ISPSLIB File Tailoring Information (Panel ORINIP15)

Step 5:  Define JOB Cards for Install Jobs (Panel ORINIP20)

Step 6:  Define PROCs, CLISTs, Linklist, and Temporary Space (Panel ORINIP25)

Step 7:  Review/Modify Space Specifications for Major Libraries (Panel ORDSN)

Step 8:  Specify VOLSER for Other Libraries (Panel ORDSNO)

Step 9:  Define USS Products Installation Parameters (Panel ORINIP50)

Step 10:  Product Installation Definition Complete (Panel ORINIP60)

Step 11: Generate the Installation Job

Step 12:  Run the Installation Job (ORIJA01)

Step 13:  Run the Generated Installation Jobs

Overview

Installation consists of the following steps:

For installation messages, refer to the Oracle9i Enterprise Edition Messages Guide for OS/390.

For administration and configuration considerations when migrating from an Oracle7 database to an Oracle9i database or upgrading from an Oracle8 or Oracle8i database with MPM to an Oracle9i database, refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390.

Installation Setup and Initialization

The following steps guide you through the process of setting up your user environment to run the Oracle Installation Dialog Facility. If this is your initial installation of this release of Oracle9i for OS/390, then proceed with Step 1:  Load the Oracle Installation JCL. If this release of the Oracle software is already installed, and if you would like to configure an Oracle database, then refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390.

Step 1:  Load the Oracle Installation JCL

The Oracle9i Enterprise Edition for OS/390 distribution tapes are standard-label tapes containing many files, including the one that contains the JCL to start the Oracle installation. You can copy this file to a disk data set with the JCL provided here.

Before using the JCL, you must customize it for your site. The distribution tapes are designed for installations using 3380 type and 3390 type storage devices.

The following job loads the installation JCL:

//INSTAL1 JOB 1,'GETFILE1',CLASS=A,MSGCLASS=X,NOTIFY=DBA1 
//* 
//S1   EXEC PGM=IEBCOPY 
//SYSPRINT  DD   SYSOUT=* 
//SYSUT1    DD   DSN=ORACLE.OORX011.F1, 
//           DISP=OLD,
//           UNIT=tape,
//           VOL=SER=OS011A, 
//           LABEL=(1,SL,EXPDT=98000) 
//SYSUT2    DD  DSN=oran.orav.INSTLIB, 
//           DISP=(NEW,CATLG,DELETE), 
//           UNIT=SYSDA, 
//           VOL=SER=volser, 
//           DCB=(RECFM=FB,LRECL=80,BLKSIZE=27920), 
//           SPACE=(27920,(600,100,20)) 
//SYSIN   DD  * 
  COPY INDD=SYSUT1,OUTDD=SYSUT2
  SELECT MEMBER=OSPIJA00 
/* 
// 

where:

tape

is the tape drive on which you mount the tapes.

oran.orav

are the high-level and second-level data set name qualifiers chosen for this installation.

volser

is the DASD volume serial number on which the Oracle INSTLIB library is to be allocated. The Oracle INSTLIB library contains installation-related material, including most of the jobs that you run during the installation process.

Step 2:  Create the ISPF Libraries

The Partitioned Data Set (PDS), which is created when the first file is downloaded from the tape, contains member OSPIJA00. This member is a batch job that creates and loads (from the same tape) the Oracle ISPF libraries that are used during the Oracle installation. If these libraries already exist on your system, then they are deleted before the new data sets are created.

Member OSPIJA00 loads the following ISPF libraries:

ISPCLIB

contains the Oracle installation CLISTs. This library also contains a CLIST called NEWDSRPT that produces a report listing the default library sizes for the data sets corresponding to the products that you selected during your installation. Refer to Appendix A, "Data Set Names and Space Allocations" for more information about using this CLIST.

Oracle Corporation requires you to unload the Oracle CLIST library into a data set with a record format (RECFM) of fixed block (FB) and a LRECL of 80 characters.

If you prefer to use variable block (VB) records for system CLISTs, then use ISPF option 3.3 to copy all of the library members into a VB data set with the same logical record length (LRECL) and block size as your existing CLIST libraries. Ensure that the new VB data set has the name oran.orav.ISPCLIB, where you substitute the high-level and second-level qualifiers of your installation for the oran.orav qualifiers in the ISPCLIB data set name.

ISPMLIB

contains the Oracle installation messages.

ISPPLIB

contains the Oracle installation panels.

ISPSLIB

contains the Oracle installation skeletons.

ISPTLIB

contains the Oracle installation tables.

In ISPF EDIT, modify the following items in the OSPIJA00 job to run on your system:

The last four symbolic parameters supply the data set names of existing ISPF libraries in your system. These parameters reference the associated DCB (data control block) attributes so that the created Oracle libraries can be assigned matching attributes. Ensure that the default data sets exist on your system. If they do not exist, replace the data set names with the correct names for your system.

If you are uncertain about the correct data set names in your system, issue the following TSO command from ISPF option 6 (TSO Command Processor) to view the current session allocations:

LISTALC STATUS 

Use the first data set name that is listed above each of the following DDnames for each of the symbolic parameters in the job:

In the following example, the bold data set names are the ones that you specify in the symbolic parameters:

--DDNAME---DISP-- 
SYS1.USER.ISFPLIB 
  ISPPLIB  KEEP 
SYS2.USER.ISPLIB 
           KEEP 
TSO1.USER.ISPF.ISPLIB 
           KEEP 
SYS1.ISPF.CLIB 
  SYSPROC  KEEP 
SYS1.ISPF.ISPSLIB 
  ISPSLIB  KEEP 
SYS3.ISPF.MLIB 
  ISPMLIB  KEEP 
SYS2.V21.ISPMLIB 
           KEEP  
Table 3-1 OSPIJA00 Job Parameters

Parameter  Default  Description 

INDEX 

ORACLE.ORALIBV 

High-level qualifiers for the four created data sets. These should normally be changed to the high-level and second-level qualifiers that you used in Step 1 for the INSTLIB data set. 

TPUNIT 

TAPE 

Tape unit specification for the distribution tapes 

TPVOL 

OS011A  

Volume serial number specification for the first distribution tape. Do not change this parameter. 

PDASD 

SYSDA 

Disk unit specification for the created data sets  

PDVOL 

XXXXXX 

Volume serial number specification for the created data sets  

TDASD 

SYSDA 

Temporary disk space unit name  

DCBPLIB 

ISP.SISPPENU 

DCB data set model of the first ISPF panel library 

DCBMLIB 

ISP.SISPMENU 

DCB data set model of the first ISPF message library 

DCBSLIB 

ISP.SISPSENU 

DCB data set model of the first ISPF skeleton library 

DCBCLIB 

ISP.SISPCLIB 

DCB data set model of the first ISPF CLIST library 

When you have completed your changes to member OSPIJA00, save and submit the job. OS/390 requests a tape mount for the first Oracle distribution tape on the device that is specified in the TPUNIT symbolic parameter. When the job ends, examine the output to confirm successful execution before proceeding to Step 3:  Invoke the Product Installation and Customization Process.

Step 3:  Invoke the Product Installation and Customization Process

After you successfully create the ISPF installation libraries, invoke ORIPO01 to start the customization process.

To invoke the ORIPO01 CLIST, logon to TSO, enter ISPF, and select option 6 (TSO Command Processor) from the main ISPF menu. From option 6, use the EXEC command to invoke the ORIPO01 CLIST from the ISPCLIB data set that was created in "Step 2:  Create the ISPF Libraries":

-------------------- ISPF COMMAND SHELL --------------------
Enter TSO or Workstation commands below:
===> EXEC 'oran.orav.ISPCLIB(ORIPO01)'

Substitute your high-level and second-level qualifiers for oran.orav in the following examples.

During the CLIST execution, you are prompted three times:

  1. At the first prompt, enter the high-level and second-level data set name qualifiers for the ISPF data sets that were copied from the tapes. These values should match those that you specified in the INDEX parameter in "Step 2:  Create the ISPF Libraries".

  2. At the second prompt, enter C to confirm the qualifiers you entered.

After your second reply, you are prompted with ***. When you press [Enter], panel OR@PRIM is displayed.

Step 4:  Select Product Set from the Oracle Product Install Menu (Panel OR@PRIM)

Place an S in front of Oracle9i Server and enter the high-level and second-level qualifiers that you want used for this product set, for example, ORAN.ORAV. Generally, these qualifiers match the corresponding qualifiers used in Step 1 of the Installation Set Up and Initialization. Refer to "Data Set Name Qualifier Rules" in Appendix C, "Installation Reference" for more information.

When you select Oracle9i Server on panel OR@PRIM and press [Enter], panel OR@INST is displayed. You are led through a series of panels that let you select and customize the Oracle server and tools for your installation.

Step 5:  Select Installation/Customization Options from the Oracle Primary Option Menu (Panel OR@INST)

Different installation and customization options may be performed from this panel. In general, they should be performed in the order shown. However, you may choose not to perform some of the customization options. You select the option that you want to perform by entering the option number on the panel command line.

These options go in pairs - a definition option, which takes you through a series of ISPF panels, and a generate option, which produces a job stream based on the information provided on the ISPF panels, to further populate the Oracle INSTLIB library. (The generate option is typically followed by other tasks to complete the installation or customization that you are performing.)

From the Oracle Primary Option Menu, select the task that you want to perform:

  1. Define Oracle Products Installation Parameters

    This is the option that will begin the product installation process. Because this is the process that actually unloads the Oracle products from the distribution tapes, it must be performed before any of the other options.

    Go to the "Product Installation" section for product installation instructions.

  2. Generate Installation Job "ORIJA01"

    Go to the "Product Installation" section for instructions on when to select this option.

  3. Define New Oracle Database Parameters

    This is the option that will begin the customization process for a new Oracle database. Refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390 for information on how to complete the database customization process.

  4. Generate Database Job "ORDJA01"

    Refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390 for instructions on when to select this option.

  5. Reset all Product and Language selections

    This option relates only to option 1. It can be used to nullify all product and language selections made by the user on panels ORPRODS and ORLANG.

    Refer to Appendix C, "Installation Reference" for more information about option 5.

X. Exit ORACLE Install Dialog facility.

Product Installation

After selecting the product installation option from the Primary Option Menu, you will see panel ORPRIM0, Define Installation Parameters. This panel shows a list of the various installation parameters that must be provided in order to complete the product installation. Press [ENTER] on the panel to begin specifying the installation parameters. You will be presented with the customization panels for the installation of the Oracle9i software.

The following rules apply to the customization panels:

Step 1:  Modify Tape Unit and Library Index (Panel ORINIP00)
  1. Oracle Distribution Library

    Identify the OS/390 tape unit name on which you intend to mount the Oracle distribution tapes during the installation jobs. The tape volume serial numbers that appear on this panel should not be changed unless you are instructed to do so by Oracle Support Services.

  2. Oracle Library Index

    Identify the high-level and second-level data set qualifiers to be used for the Oracle product libraries. The default values for these come from the information that you supplied on panel OR@PRIM. Enter new names if you want to change the default values.

When the information on this panel is correct, enter C to continue to the next panel.

Step 2:  Select Oracle Products for Installation (Panel ORPRODS)

This panel shows a list of all the products on the distribution tapes. Enter S next to the products that you want to install. All product prerequisites are chosen automatically. If you select a product that has optional products associated with it (which were not already selected), then you will see this panel displayed a second time with the optional product list.

When the information in this panel is correct, enter C to continue to the next panel.

Step 3:  Select Language Message Modules (Panel ORLANG)

This panel shows a list of the National Language Support (NLS) language message modules available with this release. Enter S next to the modules that you want to install. American English is the standard message module set provided with Oracle9i for OS/390 and is always installed. The more language module sets that you install, the greater your installation disk requirements are.

When the information in this panel is correct, enter C to continue to the next panel.

Step 4:  INSTLIB/ISPSLIB File Tailoring Information (Panel ORINIP15)
  1. Oracle ISPSLIB (skeleton) Library member

    This item is showing the file tailoring skeleton member that will be used during the generate step. You cannot change this value.

  2. Oracle Installation Library

    Provide information about the INSTLIB library in which the installation jobs are built. This is normally the same data set that is created when the first file is downloaded from the Oracle distribution tapes (in "Installation Setup and Initialization" step 1). However, you may change the Oracle INSTLIB library name if required. Enter NEW or SHR for DATA SET DISPOSITION. The DATA SET DISPOSITION defaults to SHR. If the data set is new, then specify a VOLUME SERIAL and DEVICE TYPE.

When the information in this panel is correct, enter C to continue to the next panel.

Step 5:  Define JOB Cards for Install Jobs (Panel ORINIP20)

This panel allows you to define the JOB card structure that will be used with each of the generated installation jobs. The additional lines can be used to add JES subsystem control cards or similar requirements. The JOBNAME parameter and the NOTIFY parameter default to your TSO logon userid. Change the default information as needed.

When the information in this panel is correct, enter C to continue to the next panel.

Step 6:  Define PROCs, CLISTs, Linklist, and Temporary Space (Panel ORINIP25)
  1. Define Oracle Procedure and CLIST Target Libraries

    Provide the data set names for the target libraries where the Oracle JCL procedures (cataloged procedures) and TSO CLISTs will reside. You also provide a suffix for the Oracle JCL procedures. Because the suffix is appended to the end of each installation procedure, you can load the new version of Oracle JCL procedures to the same target library as a prior release without replacing the older procedures. The suffix is required and defaults to XX.

  2. Define Oracle Linklist Library

    Several modules in the Oracle product set must reside in the system linklist. These modules take approximately 64K bytes of space. Provide the name of the system linklist library that you want these modules to be copied into.

  3. Oracle Temporary Disk Space Unit Name

    Provide the unit name for the temporary disk work space. The default, SYSDA, is acceptable in most systems.

When the information in this panel is correct, enter C to continue to the next panel.

Step 7:  Review/Modify Space Specifications for Major Libraries (Panel ORDSN)

Provide the volume serial number, device type, SMS classes, and space information for each of the major Oracle library data sets listed on this panel. You should discuss your SMS configuration with your system programmer to determine appropriate values for this panel.


Note:

The Oracle AUTHLOAD and CMDLOAD libraries are the PDSE (Partitioned Data Set - Extended) type, which must go to an SMS managed volume unless appropriate OS/390 software maintenance has been applied. Refer to IBM APAR II12221 for information regarding that maintenance. 


Refer to Appendix A, "Data Set Names and Space Allocations", for information about the Oracle data sets, their space allocations, and the NEWDSRPT CLIST, which produces a report listing default library sizes. The default space figures in this panel are for the entire product set. These allocations are too large for a product subset.

When the information in this panel is correct, enter C to continue to the next panel.

Step 8:  Specify VOLSER for Other Libraries (Panel ORDSNO)

Provide the volume serial number, device type, and/or SMS classes for all other Oracle library data sets. The information specified in this panel applies to all other Oracle data sets, in other words, those not listed on panel ORDSN. You should discuss your SMS configuration with your system programmer to determine appropriate values for this panel.

When the information in this panel is correct, enter C to continue to the next panel.

Step 9:  Define USS Products Installation Parameters (Panel ORINIP50)
  1. Unix System Services directory path for ORACLE_HOME

    Provide the OS/390 Unix System Services (USS) directory into which you want the Oracle USS products installed. This directory is known as ORACLE_HOME. This directory does not need to exist prior to completing the USS products installation.


    Note:

    Oracle Corporation recommends that you use a separate file system for ORACLE_HOME. Approximately 700 cylinders of DASD space are required if you choose to install all of the USS products. 


  2. Unix System Services directory path for temporary files

    Provide a Unix System Services directory path that will be used as a temporary staging directory for files that are required by the USS products installation. This directory path defaults to /tmp. However, you may change it if doing so is appropriate for your site.


    Note:

    The temporary staging directory must exist prior to running the ORIJU01 job. Approximately 300 cylinders of DASD space are required in the temporary staging directory if you choose to install all of the USS products. 


When the information in this panel is correct, enter C to continue to the next panel.

Step 10:  Product Installation Definition Complete (Panel ORINIP60)

The appearance of this panel indicates that you have completed the Product Installation Definition process. You may use [PF3] to back up through the previous panels to make any corrections that you need. If you are satisfied with all of the parameter values in the customization panels, you may use [PF4] to return to the Primary Option Menu panel.

Step 11: Generate the Installation Job

Select option 2 (Generate Installation Job) from the Oracle Primary Option Menu panel. The installation CLISTs generate a job stream in a new member, ORIJA01, in the Oracle INSTLIB library.

The output displays as the generate step is executing. When you see the GENERATION PROCESS COMPLETED message, press [Enter] to return to the Oracle Primary Option Menu. Then press [PF3] to exit the install dialog.

Step 12:  Run the Installation Job (ORIJA01)

You do not need to edit the generated job, ORIJA01, although you might want to change the jobname. Submit this job after you have made any changes appropriate for your site.

ORIJA01 creates multiple members in the INSTLIB library, including a series of installation jobs with member names ORIJB00 through ORIJU01.

Examine the output from the ORIJA01 job to confirm its successful execution. The return code from ORIJA01 should be 0, indicating successful execution.

Step 13:  Run the Generated Installation Jobs

Submit each job in the order shown below. Some jobs might not be present in your installation depending on the installation options that you selected.


Caution:

Even if the basic JOB card and related data are specified properly in the associated customization panel, you might need to change information such as the jobname in each job before submitting it for execution. 


Before running these jobs, ensure that the Oracle PROCLIB and TSO CLIST libraries that were specified in panel ORINIP25 already exist. Otherwise, you receive JCL errors.

The following list describes the purpose of each job and any special considerations for its execution.

ORIJB00

This job deletes the Oracle distribution libraries (if any), reallocates new ones, and downloads the libraries for the selected products from the distribution tapes. This job requires that the Oracle distribution tapes be mounted.

The delete, reallocate, and copy operations are performed only for those data sets corresponding to the products that you selected to install.

ORIJC00

This job copies several modules from the Oracle AUTHLOAD library to the system linklist library that you specified on panel ORINIP25. These modules take approximately 64K bytes of space.

After this job has been successfully run, if you plan to start your OSDI subsystem before the next IPL, then you must refresh the system linklist by issuing the following system operator command:

F LLA,REFRESH

After issuing the foregoing command, message CSV210I should appear after a brief delay.

ORIJD00 (for Oracle server)

This job copies the following customized parameter members to the Oracle database PARMLIB library:

  • SERVFNA

FNA file used by various installation and customization jobs

  • ORAENV

Environment variable file containing the ORACLE_HOME specification for the USS products

This job also copies the following Oracle JCL procedures to the PROCLIB library that was specified during the installation customization process:

  • ORAEXPxx

invokes the Export utility

  • ORAIMPxx

invokes the Import utility

  • ORALDRxx

invokes the SQL*Loader utility

  • ORARMNxx

invokes the Recovery Manager utility

where:

  • xx

is the procedure suffix specified on panel ORINIP25 .

ORIJE00 (for SQL*Plus)

This job copies the following Oracle JCL procedure to the PROCLIB library that was specified during the installation customization process:

  • ORASQLxx

invokes SQL*Plus

where:

  • xx

is the procedure suffix specified on panel ORINIP25.

ORIJF00 (for Oracle Precompilers)

This job copies the following Oracle JCL procedures to the PROCLIB library that was specified during the installation customization process:

  • ORACOBxx

invokes Pro*COBOL V1

  • ORACB2xx

invokes Pro*COBOL V9

  • ORACxx

invokes Pro*C

  • ORAFORxx

invokes Pro*FORTRAN

  • ORAOTTxx

invokes the Object Type Translator

  • ORAPLIxx

invokes Pro*PL/1

where:

  • xx

is the procedure suffix specified on panel ORINIP25 .

ORIJG00 (for Oracle9i Text)

This job copies the following customized parameter member to the Oracle PARMLIB library:

  • CTXFNA

FNA file used by installation and customization jobs

ORIJU01 (for USS Products)

This job copies the USS Products installation scripts and tar files from OS/390 data sets to the temporary USS directory that was specified on the installation panel.

After this job has run successfully, you must complete the OS/390 USS products installation by logging into Unix System Services and executing the ussinst.sh script that is located in the temporary directory:

. /tmp/ussinst.sh

This shell script will install the USS portions of the Oracle server and each of the USS products that you selected into the ORACLE_HOME directory that you specified on panel ORINIP50.

If you selected Oracle Enterprise Manager Intelligent Agent during the product selection process, you will need to run an interactive configuration script called customize.sh. Refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390 for instructions.

This completes the Oracle Product Installation process. Refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390 for information on how to configure the products installed.


Go to previous page Go to next page
Oracle
Copyright © 2001 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Library
Go To Product List
Product
Go To Table Of Contents
Contents
Go To Index
Index