Sun Cluster Data Service for Oracle Application Server Guide for Solaris OS

Planning the Sun Cluster HA for Oracle Application Server Installation and Configuration

This section contains the information you need to plan your Sun Cluster HA for Oracle Application Server installation and configuration.

Configuration Restrictions

This section provides a list of software and hardware configuration restrictions that apply to Sun Cluster HA for Oracle Application Server only.

Caution –

Your data service configuration might not be supported if you do not observe these restrictions.

For restrictions that apply to all data services, see the Sun Cluster Release Notes.

Installing Oracle Application Server onto Cluster File Systems — The Oracle Application Server can be installed onto a Global File System or Failover File System.

Note –
It is considered best practice when mounting Global File Systems to mount them with the /global prefix and to mount Failover File Systems with the /local prefix.

Configuration Requirements

The requirements in this section apply to the Sun Cluster HA for Oracle Application Server only.

These requirements are setup in configuration and registration files within /opt/SUNWsc9ias/util. These files allow you to register the Oracle Application Server components with Sun Cluster, with appropriate dependencies applied.

You must use these files to register the Sun Cluster HA for Oracle Application Server resources.

Files within /opt/SUNWsc9ias/util that are prefixed 9ias should be used for the Oracle 9iAS Infrastructure components and files prefixed 10gas should be used for the Oracle 10g AS Infrastructure components.

Caution –

Your data service configuration might not be supported if you do not adhere to these requirements.

Oracle Application Server components and their dependencies –

Table 1–5 Oracle 9iAS Infrastructure components and their dependencies (via -> symbol)


Component	Description
Oracle Internet Directory Monitor (OIDMON)	-> SUNW.HAStoragePlus resource -> Oracle Database Server resource -> Oracle Database Listener resource
Oracle Internet Directory Process (OIDLDAP)	-> Oracle Internet Directory Monitor (OIDMON) resource
Oracle Process Management and Notification (OPMN)	-> Oracle Internet Directory Process (OIDLDAP) resource
Enterprise Manager (EM)	-> Oracle Process Management and Notification (OPMN)resource

Table 1–6 Oracle 10g AS Infrastructure components and their dependencies (via -> symbol)


Component	Description
Oracle Process Management and Notification (OPMN)	-> SUNW.HAStoragePlus resource -> Oracle Database Server resource -> Oracle Database Listener resource
Enterprise Manager (EM)	-> Oracle Process Management and Notification (OPMN)resource

The Sun Cluster HA for Oracle Application Server configuration and registration files within /opt/SUNWsc9ias/util define these dependencies . Example 1–1 lists the Oracle 10g AS configuration and registration files.

Example 1–1 Oracle 10g AS Infrastructure configuration and registration files for Sun Cluster

# cd /opt/SUNWsc9ias/util
#
# ls -l 
total 24
-rwxr-xr-x   1 root     sys         1516 Jul 14 12:33 10gas_config
-r-xr-xr-x   1 root     sys         2738 Jul 14 12:33 10gas_register
-rwxr-xr-x   1 root     sys         1671 Jul 14 12:33 9ias_config
-r-xr-xr-x   1 root     sys         4383 May 27 09:48 9ias_register
# more 10g*
::::::::::::::
10gas_config
::::::::::::::
#
# Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# This file will be sourced in by 10gas_register and the parameters
# listed below will be used.
#
# These parameters can be customized in (key=value) form
#
#            RG - name of the SC resource group containing the resources
#       RS_OPMN - name of the SC Oracle Process Monitor Notification resource
#         RS_EM - name of the SC Enterprise Manager Web site resource
#
#   ORACLE_HOME - name of the Oracle home directory
#    ORACLE_SID - name of the Oracle SID
#    OIAS_LHOST - name of the Oracle 10gAS Infrastructure logical hostname
#     OIAS_USER - name of the Oracle 10gAS Infrastructure userid
#    OIAS_ADMIN - name of the Oracle 10gAS Internet Directory Admin password
#    OIAS_INFRA - name of the Oracle 10gAS Infrastructure /var/opt/oracle
#     OIAS_FQDN - name of the Oracle 10gAS fully qualified domainname
#     OIAS_OPMN - name of the Oracle 10gAS ias-components
#               e.g. OIAS_OPMN=OID/HTTP_Server/OC4J or OIAS_OPMN=all
#
#       ALL indicates all the installed ias-components
#
#         RS_LH - name of the SC Logical Hostname resource
#        RS_HAS - name of the SC Oracle 10gAS HAStoragePlus resource
#     RS_ORACLE - name of the SC Oracle resource
#     RS_ORALSR - name of the SC Oracle Listener resource
#
 
RG=
RS_OPMN=
RS_EM=
 
ORACLE_HOME=
ORACLE_SID=
OIAS_LHOST=
OIAS_USER=
OIAS_ADMIN=
OIAS_INFRA=
OIAS_FQDN=
OIAS_OPMN=
 
RS_LH=
RS_HAS=
RS_ORACLE=
RS_ORALSR=

::::::::::::::
10gas_register
::::::::::::::
#
# Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
 
. `dirname $0`/10gas_config
 
PORT=10000
OIAS_ADMIN=dummy
OIAS_FQDN=dummy
 
validate_registration()
{
St=$?
RS=$1
RG=$2
ORACLE_HOME=$3
ORACLE_SID=$4
OIAS_LHOST=$5
OIAS_USER=$6
OIAS_ADMIN=$7
OIAS_INFRA=$8
OIAS_FQDN=$9
 
if [ "${St}" -ne 0 ]; then
        echo "Registration of resource ${RS} failed,\
		 please correct the wrong parameters"
        exit 1
else
        echo "Registration of resource ${RS} succeeded"
fi
 
# VALIDATE RESOURCE
 
`dirname $0`/../bin/validate_9ias -R $RS -G $RG \
-O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN
 
St=$?
 
if [ "${St}" -ne 0 ]; then
        echo "Validation of resource ${RS} failed, \
		please correct the wrong parameters"
        echo "Removing resource ${RS} from the cluster configuration"
 
        scrgadm -r -j ${RS}
        exit 1
else
        echo "Validation of resource ${RS} succeeded"
fi
}
 
scrgadm -a -j $RS_OPMN -g $RG -t SUNW.gds \
-x Start_command="/opt/SUNWsc9ias/bin/start-opmn \
-R $RS_OPMN -G $RG -O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN -C $OIAS_OPMN " \
-x Stop_command="/opt/SUNWsc9ias/bin/stop-opmn \
-R $RS_OPMN -G $RG -O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN -C $OIAS_OPMN " \
-x Probe_command="/opt/SUNWsc9ias/bin/probe-opmn \
-R $RS_OPMN -G $RG -O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN -C $OIAS_OPMN " \
-y Port_list=$PORT/tcp -y Network_resources_used=$RS_LH \
-x Stop_signal=9 -x Probe_timeout=90 \
-y Resource_dependencies=$RS_HAS,$RS_ORACLE,$RS_ORALSR
 
validate_registration $RS_OPMN $RG \
$ORACLE_HOME $ORACLE_SID $OIAS_LHOST \
$OIAS_USER $OIAS_ADMIN $OIAS_INFRA $OIAS_FQDN $OIAS_OPMN
 
if [ ! -z "$RS_EM" ]; then
 
scrgadm -a -j $RS_EM -g $RG -t SUNW.gds \
-x Start_command="/opt/SUNWsc9ias/bin/start-em \
-R $RS_EM -G $RG -O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN " \
-x Stop_command="/opt/SUNWsc9ias/bin/stop-em \
-R $RS_EM -G $RG -O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN " \
-x Probe_command="/opt/SUNWsc9ias/bin/probe-em \
-R $RS_EM -G $RG -O $ORACLE_HOME -S $ORACLE_SID -H $OIAS_LHOST \
-U $OIAS_USER -P $OIAS_ADMIN -E $OIAS_INFRA -D $OIAS_FQDN " \
-y Port_list=$PORT/tcp -y Network_resources_used=$RS_LH \
-x Stop_signal=9 \
-y Resource_dependencies=$RS_OPMN
 
validate_registration $RS_EM $RG \
$ORACLE_HOME $ORACLE_SID $OIAS_LHOST \
$OIAS_USER $OIAS_ADMIN $OIAS_INFRA $OIAS_FQDN
 
fi