1

IBM Oracle ICC

Installing Oracle 10gR2 (10.2.0.3) on z/OS 1.9

Brent Howe, IBM Oracle International Competency Center

IBM Oracle ICC2

Workshop Information

These slides were generated to support the workshop presented byIBM at the Oracle zSeries SIG. These slides are not intended to stand on their own. Please use these slides along side the Redbook and Oracle installation Documentation.

Redbook► Experiences with Oracle Database 10g on z/OS► http://www.redbooks.ibm.com/abstracts/sg247055.html?Open

Oracle Installation Documentation► Oracle Database 10g Release 2 (10.2) Documentation ► http://www.oracle.com/technology/documentation/database10gr2.html

2

IBM Oracle ICC3

Agenda

Part 1► Prepare z/OS for installation► Installation of the Oracle binaries

Part 2► Create a Database► Patch a database

Part 3► Using WLM – In a separate presentation

IBM Oracle ICC4

Agenda Part 1

Install Preparation► System Access► z/OS USS login Requirements► X-windows Setup► Software Requirements► Define Users and Groups► Define and Format Filesystems► Parmlib updates ► FTP the Oracle code

Execution of the installation

3

IBM Oracle ICC5

Systems Access

System Access Requirements for the install► X-Windows Session for Oracle Universal Installer (OUI) processing► tn3270 session for TSO file, and Database VSAM file maintenance► Telnet connection required to from a client to z/OS USS here are some

popular options, this test used PuTTy from Windows. ● Used PuTTY from Windows client

– Available at– http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

● Telnet from Intel Linux client– Comes within the standard TCP/IP configuration

● TN3270 Client – IBM Personal Communications Telnet– Hummingbird Telnet

IBM Oracle ICC6

Login to MVS USS using Telnet

Logging into to z/OS USS using telnet usually requires a unique port address. This is defined in the system stack a common choice is 1023 for telnet thus reserving port 23 for tn3270 into z/OS itself► telnet mvs09:1023

EZYTE27I login: ibmuserEZYTE28I ibmuser Password:IBMLicensed Material - Property of IBM5694-A01 (C) Copyright IBM Corp. 1993, 2001(C) Copyright Mortice Kern Systems, Inc., 1985, 1996.(C) Copyright Software Development Group, University of Waterloo, 1989.

All Rights Reserved.

U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, orDisclosure restricted by GSA-ADP schedule contract with IBM Corp.

IBM is a registered trademark of the IBM Corp.

IBMUSER:/u/ibmuser: >

4

IBM Oracle ICC7

X-Windows Requirements

X-Windows is required to run the Oracle Universal Installer (OUI) Intel Linux► xhost + <z/OS hostname>VNC can be used► Included in many Linux distributions► Need to start a server on a Linux host

● Start on a separate host – with an assigned port – Allows any X-Windows host to be presented – Export DISPLAY=xx.xx.xx.xx:<assigned port>

● Start on USS ( will require being downloaded and possibly built)Cygwin/Xfree86 on a Windows machine► Must be installed onto client► Start the linux environment► Startxhost.sh invokes the X-Windows server ► xhost + <z/OS hostname>► Export DISPLAY=xx.xx.xx.xx:<assigned port>

IBM Oracle ICC8

XClock on MVS USS

The XClock program is a sample program that can be used to validate the X-Windows connectivity environment. You will need to build the product. This is the procedure to build X-Clock

>mkdir xclock>cp /usr/lpp/tcpip/X11R6/Xamples/clients/xclock/* xclock>cd xclock>make

c89 -c -D_ALL_SOURCE -W c,dll xclock.c c89 -c -D_ALL_SOURCE -W c,dll Clock.c c89 -o xclock xclock.o Clock.o /usr/lib/Xaw.x /usr/lib/SM.x /usr/lib/ICE.x /usr/lib/X11.x

>export DISPLAY= < Display IP Address: port number >>xclock

5

IBM Oracle ICC9

Software Pre-Requisites

z/OS Operating System► z/OS 1.4 is the minimum requirement► We used z/OS 1.9, validated using the uname –a command

>uname –aOS/390 OS/390 MVS09 19.00 03 2084

PERL► Now packaged with z/OS ► Validated with the perl command

$ perl -vThis is perl, version 5.004_03

Make ► packaged with z/OS ► Validated with the make command

$ make -Vmake - Version z/OS Shell and Utilities v1.9

IBM Oracle ICC10

Java 1.4.2 Pre-requisite

Java 1.4.2 is a pre-requisite for Oracle database 10.2.0.3 running on Z/OS 1.9. This is the verification of the release level.

MVS09:/u/demo1>java -versionjava version "1.4.2"Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2)Classic VM (build 1.4.2, J2RE 1.4.2 IBM z/OS Persistent Reusable VM build

cm142-20080122 (SR10) (JIT enabled: jitcMVS09:/u/demo1>

The correct level of Java can be obtained of the z/OS Java Website. ► http://www-03.ibm.com/servers/eserver/zseries/software/java/

► If the following error is received after installing the correct Java Version the resolution is listed below:● FSUMF073 J1.4/bin/libawt.so: user not authorized to restore extended attribute

● created a generic RACF profile BPX.FILEATTR.* in the RACF FACILITY class, and granted the userid access to this profile.

6

IBM Oracle ICC11

USS .Profile validation

User that does the install must have write access to /var/opt/oracleSet DISPLAY variable

EXPORT DISPLAY= < Client IP Address: port # for x-windows displays >verify variables► JAVA_HOME ● Should be set to Java 1.4.2 as described previously

► PATH_JAVAexport PATH_JAVA=$JAVA_HOME/bin

► PATHexport PATH=$PATH_JAVA:$PATH

► LIBPATHexport LIBPATH=$JAVA_HOME/lib:$PATHJAVA:$LIBPATH

► $ORACLE_HOME should be empty

IBM Oracle ICC12

Define Oracle User ID and Groups

The Oracle Userids are needed for both the install and runtime processes. These are the recommended ID’s and their attributes. You will need the appropriate authority to execute this job.

//S0 EXEC PGM=IKJEFT01,DYNAMNBR=75,TIME=100,REGION=0M //SYSPRINT DD SYSOUT=* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD *

ADDGROUP OINSTALL SUPGROUP(SYS1) OMVS(GID(100)) ADDGROUP ORADBA SUPGROUP(OINSTALL) OMVS(GID(101)) ADDUSER ORACLE DFLTGRP(OINSTALL)AD ORACLE.* UACC(READ) ALU oracle OMVS(HOME('/u/oracle') PROGRAM('/bin/sh') UID(100)) ALU oracle PASSWORD(ORACLE) PERMIT ACCT# CLASS(ACCTNUM) ACCESS(READ) ID(ORACLE) PERMIT ISPFPROC CLASS(TSOPROC) ACCESS(READ) ID(ORACLE) SETROPTS RACLIST(TSOPROC) REFRESH RDEFINE STARTED ORA1NET.** STDATA(USER(oracle)) RDEFINE STARTED ORA1DB.** STDATA(USER(oracle)) SETROPTS RACLIST(STARTED) REFRESH

7

IBM Oracle ICC13

Define and Format the File Systems

The File System needs to be defined to z/OS

//S1 EXEC PGM=IDCAMS,REGION=0M //SYSPRINT DD SYSOUT=*

DEFINE CLUSTER -(NAME(ZFS.ORACLE) -VOLUMES(ORA001) -MEGABYTES(2500 500) -LINEAR -SHAREOPTIONS(2))

DEFINE CLUSTER -(NAME(ZFS.U.ORACLE) -VOLUMES(ORA001) -MEGABYTES(10 5) -LINEAR -SHAREOPTIONS(2))

Once Defined the file system needs to be formatted

//S1 EXEC PGM=IOEAGFMT,REGION=0M, // PARM='-aggregate ZFS.ORACLE -compat' //SYSPRINT DD SYSOUT=* //STDOUT DD SYSOUT=* //STDERR DD SYSOUT=* //CEEDUMP DD SYSOUT=* //S2 EXEC PGM=IOEAGFMT,REGION=0M, // PARM='-aggregate ZFS.U.ORACLE -compat' //SYSPRINT DD SYSOUT=* //STDOUT DD SYSOUT=* //STDERR DD SYSOUT=* //CEEDUMP DD SYSOUT=*

IBM Oracle ICC14

Mount Filesystems

It is recommended that you follow both steps to mount the file systems

1. Dynamic for immediate access> mount -f ZFS.ORACLE -t ZFS /oracle > mount -f ZFS.U.ORACLE -t ZFS /u/oracle

2. Update BPXPRMxx for auto mount in subsequent IPL’s

FILESYSTYPE TYPE(ZFS) ENTRYPOINT(IOEFSCM) ASNAME(ZFS)

MOUNT FILESYSTEM('ZFS.ORACLE') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/oracle')

MOUNT FILESYSTEM('ZFS.U.ORACLE') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/u/oracle')

8

IBM Oracle ICC15

Additional Parmlib Member Updates

1. SCHED00PPT PGMNAME(ORARASC) /* PROGRAM NAME */ NOCANCEL /* NOT CANCELABLE */ KEY(7) /* PROTECTION KEY 7 FOR DB */ NOSWAP /* PROGRAM IS NOT SWAPABLE */ SYST /* SYSTEM TASK, NOT TIMED */ PPT PGMNAME(ORANET) /* PROGRAM NAME */ NOCANCEL /* NOT CANCELABLE */ NOSWAP /* PROGRAM IS NOT SWAPABLE */ SYST /* SYSTEM TASK, NOT TIMED */

2. PROGxx APF FORMAT(DYNAMIC) APF ADD DSNAME(DEMO01.V10203.AUTHLOAD) VOLUME(DEMO01)

IBM Oracle ICC16

DEMOSubSystem NameDEMO01VOLUME

For our installation3390SYSDAMust be ID in RACFDEM1N10Started task name

DEMO1N10Service name NetMust be ID in RACFDEM1S10Started task name

DEMO1S10Service name DBDEMO1.V10203HLQ

4 charactersDEM1SIDCommentsValue usedName

Decide on the Names you will use for each item before you start the OUI. These values will be used during the installation processes, the database definitions, and the subsystem definitions.

TSO Dataset Conventions and Parameters

9

IBM Oracle ICC17

Check for Previous Installations of Oracle

You can use the DEINSTALL option to remove the ORACLE_HOME files on OMVS or you can rm –rf * to manually remove the files in USS.

USS► Rename or remove

● OraInventory – Pointed to from within /var/opt/oracle/oraInst.loc

● oraInst.loc from /var/opt/oracle● Oratab from /var/opt/oracle

TSO► Remove the previous files from TSO based on the high level qualifier that you plan

to use for this installation.

If using RAC, check the metalink notes on cleaning up RAC

IBM Oracle ICC18

Starting the Oracle Universal Installer (OUI)

Change to the directory that the Installer has been staged into and issue the following command. Ensure the user executing does nothave root attributes. ► ./runInstaller

>./runInstaller>Starting Oracle Universal Installer...

Checking requirements...

Checking operating system version: must be 14.00, 15.00,16.00, 17.00,18.00 or 19.00. Actual 19.00

Passed

Checking the version of Perl: must be 5.004,5.6.1 Perl is version 5.6.1 Passed

All requirements met.

10

IBM Oracle ICC19

Initial Splash Screen for the Oracle 10.2.0.3 on z/OS Install

IBM Oracle ICC20

Oracle Inventory and Product De-installation selection

11

IBM Oracle ICC21

Oracle Inventory Location Specification

IBM Oracle ICC22

Product Selection This test selected the complete Oracle Database

12

IBM Oracle ICC23

Installation Type Selection

IBM Oracle ICC24

Specify the Oracle Home Location and Name

13

IBM Oracle ICC25

High Level Qualifier Selection

Though this is specified during the installation on USS this is the High level qualifier for the TSO datasets for both installation and run-time.

IBM Oracle ICC26

TSO Dataset allocation selection

This provides the option of manual; SMS or to not pre-allocate the TSO datasets.

14

IBM Oracle ICC27

File Allocation parametersIf the selection was made to manually allocate TSO datasets this screen is displayed. This test required update the unit as well as the volume parameter.

IBM Oracle ICC28

Insure the installation specifications are up to date.

15

IBM Oracle ICC29

The installation will proceed and status will be displayed here

IBM Oracle ICC30

Root Configuration Scripts

This displayed necessary scripts must be run as root…to complete this portion of the installation

16

IBM Oracle ICC31

Completion of the initial phase

This panel signifies that the initial phase of the installation complete.

IBM Oracle ICC32

Agenda Part 2

Database and the Subsystem Definition► Pre Installation Steps► Run the OUI using runInstaller► Setup and define the Subsystem► Create the database

Using OPatch► Pre patch requirements► Applying Opatch► Post Patch requirements

17

IBM Oracle ICC33

The Database and Subsystem Definitions

Prior to executing this ensure the following have been accomplished● Started task names must be in RACF with OMVS segment ● Ensure the dataset that will be used for AUTHLOAD is an AFP authorized

library● Have the PPT entries in the PARMLIB file● Have access to use the SETSSI and SETPROG commands or a person who

can ● Obtain a High Level Qualifier for the TSO dataset that is in the catalog – we

used DEMO01.V10203● Obtain disk space for the TSO datasets – we had 2 3390 Mod 9 – should

have at least 2 different volumes● Have write access to a PROCLIB and LINKLIB● Verify the valul\e for ORACLE_HOME

This step of the installation requires execution of the Oracle OUI ► ./runInstaller► This will install and cusomize the fields in Parmlib and Instlib

IBM Oracle ICC34

Database and Subsystem Initial Splash Screen

18

IBM Oracle ICC35

Product Selection

This panel has been displayed before, select the Database and Subsystem Configuration to continue with the installation.

IBM Oracle ICC36

Home Details

The Installation should provide the correct details here, verify the accuracy and correct as necessary

19

IBM Oracle ICC37

High Level Qualifiers

The installation software should again fill in the correct information; This needs to be verified prior to proceeding.

IBM Oracle ICC38

Parmlib DefinitionIn this installation the Instlib was previously allocated, Parmlib will be allocated as a result of the specifications listed here

20

IBM Oracle ICC39

Subsystem Definition

The Subsystem definition is next, these parameters need to be based on input on System programmer. This panel also defines the service name and the procedure name for managing Oracle database on z/OS

IBM Oracle ICC40

The Subsystem definition – Network InterfaceThis panel requires the input of the network interfaces that will manage the TNS interface for the z/OS Oracle Database.

21

IBM Oracle ICC41

OSDI Server DefinitionsThis panels requires validation of the HLQ parameters. Otherwise the defaults should work.

IBM Oracle ICC42

File definitionsThe ORA$FPS file definitions panel will manage the dynamic allocation of datasets bases on this panel. The installation was executed by overriding the defaults to Site specific requirements.

22

IBM Oracle ICC43

The Summary

IBM Oracle ICC44

The Install Commences

23

IBM Oracle ICC45

CompletionThe database configuration and Subsystem definition parameters have now been successfully installed. See the next slide for verification of the successful installation.

IBM Oracle ICC46

Check the Telnet Session

Validate that the Installation process completed without any errorsEZYTE27I login: demo1MVS09:/demo/install>./runInstallerMVS09:/demo/install>Starting Oracle Universal Installer...

Checking installer requirements...

Checking operating system version: must be 14.00, 15.00, 16.00, 17.00, 17.01, 18.00 or 19.00. Actual 19.00

Passed

All installer requirements met.Running java out of :/demo/J1.4//bin/javaOracle Universal Installer, Version 10.2.0.3.0 ProductionCopyright (C) 1999, 2006, Oracle. All rights reserved.

LISTCAT ENTRIES('DEMO1.V10203.PARMLIB')NONVSAM ------- DEMO1.V10203.PARMLIB

IN-CAT --- CATALOG.TSOAllocate: Dataset DEMO1.V10203.PARMLIB already exists, Bypassing allocate.

24

IBM Oracle ICC47

Define the Database

Run the following from < High Level Qualifier >.INSTLIB These jobs will pre-allocate the VSAM database files. ► Member DEFINE● This job allocates the VSAM files for the database.

– If you find ???????? In place of valid volume parameters you will need to specify the volumes you want to use,

– All the files in this test were put on one volume, It is recommended that you should at least put LOG2, CONTROL2, and UNDO2 on separate volumes.

● Error warning – The job is generated with comment commands “/* */” starting in

column 1. – The resolution for this is to shift all of these characters into column

3 or greater.

IBM Oracle ICC48

Subsystem Definition

Run the following from < High Level Qualifier >.INSTLIB These jobs will setup the Oracle Subsystem. ► Member COPYPROC

– This job copies the jobs to start and stop the address space to the system PROCLIB. This may need to be executed by the system programmer if you cannot write into the PROCLIB data set. These job names have to be in the RACF started task list.

► Member CPLNKLST– You must put some of the members of AUTHLOAD in the system

LINKLIST library. This job should be done by the system programmer . The JCL needs to be modified to the correct file names. The lowercase letters are there to prevent you from submitting the job without reviewing the JCL.

► Member ORASRVC – Execute the job ORASRVC, This runs the SETSSI command. If you make

an error in this, you must IPL the system to execute it a second time

25

IBM Oracle ICC49

Create the Database

Run these jobs from <HLQ>.INSTLIB to create the database, The xxx is the first 3 letters of the subsystem name.

SQLxxx11

SQLxxx12

SQLxxx13

SQLxxx14

SQLxxx15

The functions installed in the remaining four jobs were unnecessary for this exercise

Database and listener should be up and running

IBM Oracle ICC50

Using Opatch

OPatch is an Oracle-supplied utility that assists you with the process of applying interim patches to Oracle's software and rolling back interim patches from Oracle's software.

The process for installing patch 6646861:► The Patch was downloaded from Oracle Metalink

► Pre-installation requirements were met and installed

► The Patch was successfully applied

► The post application steps were executed

► The Patch process was completed

26

IBM Oracle ICC51

Opatch

OPatch is an Oracle-supplied utility that assists you with the process of applying interim patches to Oracle's software and rolling back interim patches from Oracle's software.

Opatch Commands► View the OPatch documentation as delivered in

$ORACLE_HOME/OPatch/docs► The General usage of the OPatch command include the following ● $ 'opatch apply ...' is to apply a patch● $ 'opatch rollback ...' is to roll back a patch● $ 'opatch lsinventory' is to show inventory on an Oracle Home● $ 'opatch query ...' is to query a given patch from specific details● $ 'opatch version' is to show the version of the OPatch being used.

► Adding –help behind any of these commands displays the extended help information

IBM Oracle ICC52

Determine if any Patches are pending MVS09:/demo/demo1/OPatch>opatch lsinventory -invPtrLoc $ORACLE_HOME/oraInst.locInvoking OPatch 10.2.0.3.0Oracle interim Patch Installer version 10.2.0.3.0Copyright (c) 2005, Oracle Corporation. All rights reserved..Oracle Home : /demo/demo1Central Inventory : /demo/oraInventory from : /demo/demo1/oraInst.locOPatch version : 10.2.0.3.0OUI version : 10.2.0.3.0OUI location : /demo/demo1/ouiLog file location : /demo/demo1/cfgtoollogs/opatch/opatch2008-05-30_17-44-48PM.logLsinventory Output file location : /demo/demo1/cfgtoollogs/opatch/lsinv/lsinventory2008-05-30_17-44-48PM.txt--------------------------------------------------------------------------------Installed Top-level Products (2):Oracle z/OS Database 10g 10.2.0.3.0Oracle z/OS Database and Subsystem Configuration 10.2.0.3.0There are 2 products installed in this Oracle Home.There are no Interim patches installed in this Oracle Home.--------------------------------------------------------------------------------OPatch succeeded.

27

IBM Oracle ICC53

Prepare the environment and the patch for installation

Prepare to install the patch with OPatch● unzip -a p6646861_10203_MVS.zip

………

inflating: 6646861/files/olap/admin/xumuts.plb [binary]inflating: 6646861/files/olap/admin/olapiboo.plb [binary]inflating: 6646861/files/olap/admin/olapimod.plb [binary]inflating: 6646861/files/olap/admin/olapimov.plb [binary]creating: 6646861/readmes/inflating: 6646861/readmes/README-ebcdic.txt [binary]inflating: 6646861/readmes/README.txt [binary]

► Set the Environment Variables for executing Opatch● export ORACLE_HOME=/your_installation_directory ● export ORACLE_HLQ_PDS=YOUR.HLQ

IBM Oracle ICC54

Pre-allocate TSO Datasets

3390

3390

3390

Device

30DEMO1.P664861.V10203.MESG

1122DEMO1.P664861.V10203.CMDLOAD

4696DEMO1.P664861.V10203.AUTHLOAD

TracksDataset Name

28

IBM Oracle ICC55

Apply the Patch

From within the patch directory execute the patch apply/demo/demo1/OPatch/opatch applyInvoking OPatch 10.2.0.3.0

Oracle interim Patch Installer version 10.2.0.3.0Copyright (c) 2005, Oracle Corporation. All rights reserved..

Oracle Home : /demo/demo1Central Inventory : /demo/oraInventory

from : /var/opt/oracle/oraInst.locOPatch version : 10.2.0.3.0OUI version : 10.2.0.3.0OUI location : /demo/demo1//ouiLog file location : /demo/demo1/cfgtoollogs/opatch/opatch2008-06-02_17-00-54PM.log

ApplySession applying interim patch '6646861' to OH '/demo/demo1'Invoking fuser to check for active processes....Invoking fuser on "/demo/demo1/bin/wrap"OPatch detected non-cluster Oracle Home from the inventory and will patch the local system only.Backing up files and inventory (not for auto-rollback) for the Oracle Home..,Return Code = 0...……Patch applied successfully

IBM Oracle ICC56

Patch Post Installation Steps

Run the Post installation scripts► For each database instance running on the Oracle home being

patched, connect to the database using SQL*Plus. Connect as SYSDBA and run the catcpu.sql script as follows:

cd $ORACLE_HOME/cpu/CPUJan2008 sqlplus /nolog SQLSQL> CONNECT / AS SYSDBA SQL> STARTUP SQL> @catcpu.sql SQL> QUIT

► Check the log files for errors, if any occur, reference the readme for resolution.

29

IBM Oracle ICC57

Patch Post Installation Scripts – Recompile

► This particular patch requires a recompile of views within the database. ● Use the following patch delivered scripts to perform the re-compile. There is more detail on

each of these scripts in the delivered read-me. ► Run the pre-check script, which reports the maximum number of views and objects that may be

recompiled:cd $ORACLE_HOME/cpu/view_recompile sqlplus /nolog SQL> CONNECT / AS SYSDBA SQL> @recompile_precheck_jan2008cpu.sql– The purpose of this step is to help you determine whether view recompilation should be

done at the same time as the CPU install, or scheduled later.► Run the view recompilation script. Note that this script is run with the database in upgrade

mode, which restricts connections as SYSDBA.cd $ORACLE_HOME/cpu/view_recompile sqlplus /nolog SQL> CONNECT / AS SYSDBA SQL> STARTUP UPGRADE SQL> @view_recompile_jan2008cpu.sql SQL> SHUTDOWN; SQL> STARTUP;

► Check the log file for any errors. The log file is in the current directory and is named: vcomp_<sid>_<timestamp>.log

IBM Oracle ICC58

Summary

At this point we have:► Installed the Oracle Binaries► Configured the Subsystem► Created a database► Patched the database to the latest level

Review the WLM presentation to set up for best performance