| Oracle9i Enterprise Edition Installation Guide Release 1 (9.0.1) for OS/390 Part Number A89900-01 |
|
This chapter discusses the steps required to install Oracle9i for OS/390.
The following topics are included:
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.
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.
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:
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 KEEPTable 3-1 OSPIJA00 Job Parameters
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.
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:
After your second reply, you are prompted with ***. When you press [Enter], panel OR@PRIM is displayed.
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.
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:
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.
Go to the "Product Installation" section for instructions on when to select this option.
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.
Refer to the Oracle9i Enterprise Edition System Administration Guide for OS/390 for instructions on when to select this option.
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.
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:
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.
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.
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.
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.
This item is showing the file tailoring skeleton member that will be used during the generate step. You cannot change this value.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
When the information in this panel is correct, enter C to continue to the next panel.
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.
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.
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.
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.
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.
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.
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.
This job copies the following customized parameter members to the Oracle database PARMLIB library:
|
FNA file used by various installation and customization jobs |
|
|
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:
|
invokes the Export utility |
|
|
invokes the Import utility |
|
|
invokes the SQL*Loader utility |
|
|
invokes the Recovery Manager utility |
where:
This job copies the following Oracle JCL procedure to the PROCLIB library that was specified during the installation customization process:
|
invokes SQL*Plus |
where:
This job copies the following Oracle JCL procedures to the PROCLIB library that was specified during the installation customization process:
|
invokes Pro*COBOL V1 |
|
|
invokes Pro*COBOL V9 |
|
|
invokes Pro*C |
|
|
invokes Pro*FORTRAN |
|
|
invokes the Object Type Translator |
|
|
invokes Pro*PL/1 |
where:
This job copies the following customized parameter member to the Oracle PARMLIB library:
|
FNA file used by installation and customization jobs |
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.
|
|
![]() Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|