A 95979

8/2/2019 A 95979

1/76

Oracle9iReal Application Clusters

Real Application Clusters Guard I Configuration Guide

Release 2 (9.2.0.1.0) for UNIX Systems: AIX-Based Systems, Compaq Tru64 UNIX, HP9000 Series HP-UX, and Sun Solaris

April 2002

Part No. A95979-02

8/2/2019 A 95979

2/76

Oracle9i Real Application Clu sters Real Application Clusters Guard I Configuration Guide Release 2

(9.2.0.1.0) for UNIX Systems: AIX-Based Systems, Compaq Tru64 UNIX, HP 9000 Series HP-UX, and SunSolaris

Part No. A95979-02

Copyright 1996, 2002 Oracle Corporation . All rights rese rved .

The Programs (which include both the software and docum entation) contain prop rietary information ofOracle Corporation; they are p rovided u nder a license agreement containing restrictions on use an ddisclosure and are also protected by copyright, paten t and other intellectual and ind ustrial propertylaws. Reverse engineering, d isassembly or decomp ilation of the Programs, except to the extent requiredto obtain interoperability w ith other ind epend ently created software or as specified by law, is prohibited.

The information contained in this docum ent is subject to change w ithout notice. If you find an y problemsin the documen tation, please report them to us in w riting. Oracle Corporation does not w arrant that th isdocum ent is error-free. Except as may be expressly permitted in you r license agreement for thesePrograms, no part of these Programs m ay be reproduced or tran smitted in any form or by any m eans,electronic or mechanical, for any p urp ose, without th e express written p ermission of Oracle Corporation.

If the Programs are delivered to the U.S. Government or anyone licensing or using the program s onbehalf of the U.S. Government, the following notice is applicable:

Restricted Rights N otice Programs d elivered su bject to the DOD FAR Supplement are "commercialcomputer software" and u se, dup lication, and disclosure of the Programs, including d ocumentation,shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement.Otherwise, Programs delivered su bject to the Federal Acquisition Regulations are "restricted compu tersoftware" and use, du plication, and disclosure of the Programs shall be su bject to the restrictions in FAR52.227-19, Comm ercial Comp uter Software - Restricted Rights (June, 1987). Oracle Corporation , 500Oracle Parkway, Redw ood City, CA 94065.

The Programs are not intend ed for use in any n uclear, aviation, mass transit, medical, or other inherentlydan gerous ap plications. It shall be the licensee's responsibility to take all app ropriate fail-safe, backup,redun dan cy, and other m easures to ensure the safe use of such app lications if the Programs are u sed for

such pu rposes, and Oracle Corporation d isclaims liability for any dam ages caused by su ch use of thePrograms.

Oracle is a registered trad emark, and Oracle9i, PL/ SQL, and SQL*Plus are trad emarks or registeredtradem arks of Oracle Corporation. Other names m ay be tradem arks of their respective owners.

8/2/2019 A 95979

3/76

iii

Contents

Send Us Your Comments .................................................................................................................... v

Preface........................................................................................................................................................... vii

Au dien ce ................................................................................................................................................ vii

How This Gu ide Is Organized ............................................................................................................ viiiTyp ographic Con vent ions .................................................................................................................... ix

Comman d Syntax .................................................................................................................................. ix

Related Documentation ......................................................................................................................... x

Oracle Sup port and Services ................................................................................................................. x

Documentation Accessibility .............................................................................................................. xii

1 Pre-installation

Installation Overview ........................................................................................................................ 1-2

System Installation Requirements .................................................................................................. 1-3

Restr iction s .................................................................................................................................... 1-3

Op era ting System Com ponents.................................................................................................. 1-3

Oracle Prod uct Requ irements ..................................................................................................... 1-6

Network Requ irements................................................................................................................ 1-7Implementation............................................................................................................................. 1-8

Setting the Environment ................................................................................................................... 1-9

Set Up Tasks to Perform as the root User ................................................................................. 1-9

Set Up Tasks to Perform as the oracle User ............................................................................ 1-10
http://comments_template.pdf/http://comments_template.pdf/

8/2/2019 A 95979

4/76

iv

2 Configuration Tasks

Installing Oracle9i Real Application Clusters Guard.................................................................. 2-2

Installing the Oracle9i Real Application Clusters Guard Files ................................................. 2-2

Setting Up the Configuration File ................................................................................................... 2-3

Running the Setup Utility (PFSSETUP) ......................................................................................... 2-4

Oracle Net Services Configuration .................................................................................................. 2-8

Dedicated Session s ....................................................................................................................... 2-9

3 Post-Installation Tasks

Post-Installation Tasks for the oracle User..................................................................................... 3-2

Post-Installation Tasks for the root User ...................................................................................... 3-10

Starting Oracle9i Real Application Clusters Guard ................................................................... 3-11

Troubleshooting ................................................................................................................................ 3-12

4 Upgrading to Oracle9iReal Application Clusters Guard I

Upgrading from Oracle9i Real Application Clusters Guard Release 9.0.x.............................. 4-2

Upgrading from Oracle9i Real Application Clusters Guard Release 9.0.1.x and Oracle Parallel

Fail Safe 8.1.7.2..................................................................................................................................... 4-5

Troubleshooting Tips ......................................................................................................................... 4-8

A Optimal Flexible ArchitectureIntroduction to Optimal Flexible Architecture ............................................................................. A-2

OFA Compliant Installation ............................................................................................................. A-3

Non-OFA Compliant Installation .................................................................................................... A-4

B Configuration Files

init_ORACLE_SERVICE_HOSTNAME[A| B].ora ....................................................................... B-2ORACLE_SERVICE_config.pfs ........................................................................................................ B-3

ORACLE_SERVICE_config_HOSTN AME[A| B].ded.pfs .......................................................... B-5

ORACLE_SERVICE_config_HOSTNAME[A| B].mts.pfs .......................................................... B-5

Index

8/2/2019 A 95979

5/76

v

Send Us Your Comments

Oracle9iReal Application Clusters Real Application Clusters Guard I Configuration GuideRelease 2 (9.2.0.1.0) for UNIX Systems: AIX-Based Systems, Compaq Tru64 UNIX, HP 9000Series HP-UX, and Sun Solaris

Part No. A95979-02

Oracle Corporation w elcomes your comm ents and su ggestions on the quality and usefulness of thispu blication. Your inp ut is an important p art of the information used for revision.

Did you find any errors?

Is the information clearly presented ?

Do you need m ore information? If so, where?

Are the examples correct? Do you n eed m ore examp les?

What features did you like most about th is manual?

If you find an y errors or have any other su ggestions for imp rovemen t, please ind icate the chap ter,section, and page n um ber (if available). You can send commen ts to u s in the following ways:

Email - osd [email protected]

Postal service:

Oracle Corporation

Oracle9i Documentation

500 Oracle Parkway

Redw ood Shores, CA 94065

USA

If you w ould like a reply, please give your nam e, address, and telephone nu mber below.

If you h ave p roblems with the software, please contact your local Oracle Sup port Services representa-

tive.

8/2/2019 A 95979

6/76

vi

8/2/2019 A 95979

7/76

vii

Preface

This guide d escribes how to configure Oracle9i Real App lication Clusters Real

Application Clusters Guard I.

AudienceThis gu ide is intended for d atabase adm inistrators or system adm inistrators

configur ing Oracle9i Real App lication Clusters Guard .

8/2/2019 A 95979

8/76

viii

How This Guide Is OrganizedThis guid e contains the following chapters and app end ices:

Chap ter 1, "Pre-installation"

This chap ter d escribes the p re-installation tasks required for Oracle9i Real

Application Clusters Guard.

Chap ter 2, "Configuration Tasks"

This chap ter describes how to install and configure Oracle9i Real ApplicationClusters Guard .

Chap ter 3, "Post-Installation Tasks"

This chap ter describes how to start Oracle9i Real App lication Clusters Guard .

Chap ter 4, "Upgrad ing to Oracle9i Real App lication Clusters Guard I"

This chap ter describes how to up grad e to Oracle9i Real App lication Clusters

Guard. Append ix A, "Op timal Flexible Architecture"

This app end ix provid es information on the Oracle9i Real Ap plication Clusters

Guard directory structure.

Append ix B, "Configuration Files"

This append ix describes the Oracle9i Real App lication Clusters Gu ard Packs

configuration temp late files.

8/2/2019 A 95979

9/76

ix

Typographic ConventionsThe following table describes the typograph ic conventions used in this guide:

Command SyntaxUNIX comm and syntax appears in monospace font and assumes the u se of the

Bourne shell. The "$" character at the beginning of UNIX command examples is the

default UNIX comm and promp t. Do not enter it as part of the comm and.

Convention Description

monospace Monospace type indicates UNIX commands, directory names,usernames, path names, and filenames.

brackets [ ] Word s enclosed in brackets ind icate key nam es (for exam ple,Press [Return]). Note th at brackets have a d ifferent meaningwhen u sed in comm and syntax.

italics Italic type ind icates a variable, includ ing var iable portions offilenames. It is also used for em ph asis.

UPPERCASE Up percase letters in dicate Stru ctu red Q uery Lan gu age (SQL)reserved word s, initialization p arameters, and environmentvariables.

Item Description

backslash \ A backslash ind icates a com mand that is too long to fit on asingle line. Enter the line as p rinted (with a backslash) or enter itas a single line withou t a backslash:dd if=/dev/rdsk/c0t1d0s6 of=/dev/rst0 bs=10b \

count=10000

braces { } Braces indicate required items: .DEFINE {macro1}

brackets [ ] brackets [ ]

brackets [ ] Ellipses ind icate an arbitrary nu mber of similar items:CHKVAL fieldname value1 value2 ... valueN

italics Italic type ind icates a variable. Substitu te a value for thevariable: library_name

v ertical lin e | A v ertical lin e in dicates a ch oice w ith in br aces or br ackets:SIZE filesize [K|M]

8/2/2019 A 95979

10/76

x

Related DocumentationRefer to the following guid es for more information abou t Oracle9i Real Application

Clusters Guard :

Oracle9i Real Application Clusters Concepts

Oracle9i Real Application Clusters Guard Concepts and Administration Guide

Refer to the Oracle9i Installation Guide for UNIX Systems for information on installing

Oracle9i Real App lication Clusters.

Oracle Support and ServicesThe Oracle Corporation Web page is at the following URL:

http://www.oracle.com

Oracle Corporation offers a w ide range of services to help facilitate corporate

system solu tions, including Oracle Edu cation cour ses, Oracle Consu lting services,and Oracle Worldw ide Custom er Sup port from th e Web site. In add ition, Oracle

Corpora tion provides free trial software, up da tes on Oracle prod ucts and services,

and technical brochures and data sheets.

Oracle Support Services

Technical Sup port registration and contact information w orldw ide is available at

the following URL:

http://www.oracle.com/support

At Oracles sup port site, you will find tem plates to help you prep are information

about your problem before you call so that you may be helped more qu ickly. You

will also need your CSI num ber (if app licable) or complete contact d etails, includ ing

any special project information.

OracleMetaLinkOracleMetaLinkis the Oracle Corpora tion Web service for technical information.

Members of OracleMetaLinkcan search for up da tes, alerts, patches, and other

information abou t prod ucts, releases, and op erating systems, or set preferences to

be notified autom atically of new information. OracleMetaLinkoffers a variety of

services to assist in setting up and administrating Oracle products, includ ing

procedu res, scripts, commen tary, and tu ning an d configuration best-practices

bulletins. In ad dition, it offers forum s for information sharing amon g Oracle

8/2/2019 A 95979

11/76

xi

customers, and direct comm un ication with Oracle Sup port. OracleMetaLinkis

available to Product Sup port Custom ers at no extra cost. Sign up for freemem bership of th is service at the following URL:

http://www.oracle.com/support/metalink

Use your Sup port Access Code (SAC) num ber to register.

Products and Documentation

For U.S.A custom ers, the Oracle Store is at the following URL:

http://store.oracle.com

Links to stores in other countries are available from th is Web site.

Produ ct docum entation is available at the following URL:

http://docs.oracle.com

Customer Service

Global Customer Service contacts are listed at the following URL:

http://www.oracle.com/support

Education and Training

Training information and w orldw ide schedu les are available from the followingURL:

http://education.oracle.com

Oracle Technology Network

Register w ith the Oracle Technology Network (OTN) at th e following URL:

http://technet.oracle.com

OTN d elivers technical papers, code samp les, prod uct docum entation, an Oracle

online commun ity and self-service developer su pp ort. It also offers Oracles key

developer produ cts to enable rapid d evelopment and deployment of app lications

built on Oracle technology.

8/2/2019 A 95979

12/76

8/2/2019 A 95979

13/76

Pre-installation 1-1

1Pre-installation

This chap ter describes the p re-installation and configuration tasks requ ired for

Oracle9i Real Application Clusters Guard. It contains the following sections:

Installation Overview

System Installation Requiremen ts

Setting the Environment

8/2/2019 A 95979

14/76

Installation Overview

1-2 Real Application Clusters Guard I Configuration Guide

Installation OverviewTo install Oracle9i Real App lication Clusters Guard, perform the following tasks:

1. Check the prerequisi tes:Ensure that the system meets the hard ware, software,

mem ory, and d isk space requirements for Oracle9i Real App lication Clusters

Guard.

2. Set up the UNIX environment:Ensure that the UN IX environment is set up

correctly for Oracle9i Real App lication Clusters Guard .

3. Set up the Oracle en vironment: Ensure that a tw o-node cluster has been

created and configured.

4. Configu re Oracle9i Real Application Clusters Guard:Use the provided setup

utility (PFSSETUP) to configure Oracle9i Real App lication Clusters Guard .

5. Perform post-installation tasks:Star t Oracle9i Real App lication Clusters Gu ard

and ensure th at it is correctly installed an d configured.

See Also: See "System Installation Requirements" on page 1-3 for

information about requirements.

See Also: See "Setting the Environment" on page 1-9 for

information about setting up the UNIX environment.

See Also: See "Setting the Environment" on page 1-9 for

information on setting up the Oracle environm ent.

See Also: See Chap ter 2, "Configuration Tasks"for informationabout configuring Oracle9i Real Application Clusters Guard .

See Also: See Chap ter 3, "Post-Installation Tasks" for information

about post-installation tasks.

8/2/2019 A 95979

15/76

System Installation Requirements


System Installation RequirementsVerify that the system meets the requirements described in the following sections

before installing Oracle9i Real App lication Clusters Gu ard :

Restrictions

Operating System Comp onents

Oracle Produ ct Requirements

Netw ork Requirements

RestrictionsThe following restrictions app ly to Oracle9i Real App lication Clusters Guard:

Oracle9i Real App lication Clusters Gu ard uses the p hysical host name, that is

the outpu t of the hostname comm and, interchangeably with cluster node

nam es. Therefore, make sure that the cluster node name is the same as host

name.

Oracle9i Real App lication Cluster Guard does not allow th e host nam e (nod e

nam e) to have any sp ecial characters such as hyphens, dashes, dots and so on.

This also imp lies that the host nam e (node name) cannot have the d omain nam e

included in it. Make sure that the h ost name (node n ame) does not includ e any

of the following characters:

/\:*?|"%#+!@~&^()-_'[]{};=.,

Oracle9i Real App lication Cluster Gu ard is sup ported only on 2 cluster nod es.

The Oracle9i Real Application Clusters database must be runn ing in

Primary/ Secondary configuration.

Operating System ComponentsThe operating system dep endent layer provides the services required for proper

operation of Oracle9i Real Application Clusters. Oracle9i Real Application Clusters

Guard also requires these compon ents, but might requ ire different versions from the

Note: For information on how to run Oracle9i Real App lication

Clusters in Primary/ Second ary configuration, refer to Oracle9i Real

Application Clusters Concepts.

8/2/2019 A 95979

16/76



Oracle9i Real Application Clusters software. Table 11shows th e operating system

software compon ents required for Oracle9i Real App lication Clusters Gu ard.

Table 11 Operating System Software Components

Software Platform Requirements

Operating System Solaris Solaris 8

HP HP-UX 11.0

Tru64 Compaq Tru64 UNIX, Version 5.1

AIX AIX Version 4.3.3 or higher

Operating SystemPatches

All For information on Operating System patchrequirements, refer to the Oracle9i InstallationGuide for UN IX, and th e Oracle9i ReleaseNotes for your p latform.

For Solaris: If Sun Solaris patch u pd ate 5 or 6is installed , then SUN p atch 110662-06 is

required . Starting w ith Sun Solaris patchup da te 7, this patch will no longer be requiredbecause the fix will be included w ith thisrelease.Patch 110662-06: Starting with Sun Solarispa tch 110662-03, a fix for KSH w as int rod ucedthat m ade KSH UNIX98 compat ible in itsarithmetic constant han dling (Sun bugid:4286837). Since this fix causesincompa tibilities for exiting scripts, a p atch is

available to back out the change (Sun bug id:4473696). Obtain patch 110662-06 to fix thisproblem.

For further inform ation, please contact Sunsupport.

Cluster Solaris Sun Enterprise Cluster 3.0, Veritas VolumeManager Version 3.0.4

HP MC/ ServiceGuard 11.13 OPS Edition withpa tch PH SS_22876 or later

Tru64 Compaq TruCluster Software 5.1, with patchesGB_G01313 and GB_G01314

AIX HACMP/ ES Version 4.4, or higher

8/2/2019 A 95979

17/76



Table 12 lists the comm ands required to d etermine the operating system patches

for each p latform.

Note: For AIX-Based Systems, Oracle9i Real Application ClustersGuard is supp orted on RS6000 clusters and is not supported on SP2

systems.

Table 12 Commands to Use to Determine Operating System Patches

Platform Command

Solaris To determine which operating system patches are installed, enter thefollowing comm and:

$ showrev -p

H P To d eter min e w hich op eratin g system p atch es are in stalled , en ter th efollowing comm and:

$ swlist -l product | grep PH

To determine which operating system bundles are installed, enter thefollowing comm and:

$ swlist -l bundle

Tru64 To determine which operat ing system patches are installed , enter thefollowing comm and:

$ dupatch

or

$ setld -i |more

8/2/2019 A 95979

18/76



Oracle Product RequirementsTable 13 lists the products that mu st be installed and run ning before you install

Oracle9i Real App lication Clusters Guard .

AIX To determine which operating system patches are insta lled , en ter thefollowing command :

$ instfix -a

To determine w hether a specific patch is installed, enter the followingcommand:

$ instefix -ivk APAR_number

To determ ine wh ich op erating system filesets are installed, enter th efollowing command :

$ lslpp -l

To d etermine is a specific operating system fileset is installed, enter thefollowing command :

$ lslpp -l [fileset_name]

Table 13 Oracle Product Requirements for Oracle9i Real Application Clusters Guard

Product Description

Oracle9i EnterpriseEdition , Release 2 (9.2.x) Provides the applications and files required to manage ada tabase. All other Or acle9i Real Application Clusterscompon ents are installed on top of Oracle9i Enterprise Edition.

Oracle9i Real App licationClusters, 9.2.x

Provides th e necessary Oracle9i Real Application Clustersservices, scripts, initialization file, and data files.

Oracle Net, Release 2(9.2.x)

Provides the networking software required for commun icatingbetween Oracle Servers. This software mu st be installed onboth nodes.

SQL*Plu s, Release 2 (9.2.x) Oracle software required for accessing a database.

Note: The Oracle9i Real Application Clusters Guard files are

installed as par t of the Oracle9i Real App lication Clusters

installation . To install the Oracle9i Real Application Clusters Gu ard

files, choose the Oracle9i Real Application Clusters op tion.

Table 12 Commands to Use to Determine Operating System Patches

Platform Command

8/2/2019 A 95979

19/76



Network Requirements

You mu st p re-allocate tw o relocatable IP ad dresses, one for each Real App licationClusters Gu ard Pack, for u se by client connections. These relocatable IP addresses

are used as logical hosts, and Oracle9i Real App lication Clusters Guard configures

the availability of the relocatable IP add ress as required. For information on setting

up relocatable IP add resses, refer to your system d ocumen tation.

Use the following parameters to sp ecify the relocatable IP add ress in the Oracle9i

Real App lication Clusters Guard setup configuration file:

PFS_IP_PACK_HOSTA

PFS_IP_PACK_HOSTB

After you ru n the PFSSETUP ut ility, as described in Chapter 2, these relocatab le IP

addresses are associated w ith the public netw ork adapter. If the Oracle9i Real

Application Clusters Guard Pack is moved to another n ode, these relocatable IP

add resses are also moved.

For Sun Cluster 3.0, specify the public network ad apter u sing the PFS_NET_IF_A

and PFS_NET_IF_B configuration p aram eters. The p ublic network adapter m ust

already be p art of a Netw ork Ad apter Failover (NAFO) group . Before installingReal App lication Clusters Guard, create a NAFO grou p to h ost the relocatable IP

address for a Real App lication Clusters Guard Pack. Refer to th e Sun Cluster 3.0

Installation Guide for more information on N AFO groups.

Note: The relocatable IP add resses specified using the

PFS_IP_PACK_HOSTA and PFS_IP_PACK_HOSTB parameters

mu st each have an entry in the /etc/hosts file.

See Also: See Chapter 2 and the Oracle9i Real A pplication Clusters

Guard Concepts and A dministration Guide for more information on

configuring the network.

8/2/2019 A 95979

20/76



Implementation

Please note the following:

On Sun Solaris, each Real App lication Clusters Gu ard Pack is imp lemented as a

resource group . For information on resource groups, refer to the Sun Cluster 3.0

documentation.

For HP 9000 Series HP-UX system s, each Real App lication Clusters Gu ard Pack

is implemen ted as a p ackage. For more information on p ackages, refer to

Configuring OPS Clusters with Service Guard OPS Edition.

For Compaq tru 64 systems, each Real App lication Clusters Guard Pack is

imp lemented a s a App lication Resource. For more information on App lication

Resources, refer to Cluster High Available Applications and Cluster Administration.

For IBM AIX HACM systems, each Real App lication Clusters Guard Pack is

imp lemented as a App lication Monitor, refer to the IBM RedBookExploring

HA CMP 4.4:Enhancing the capabilities of Cluster Mult i-Processing.

8/2/2019 A 95979

21/76



Setting the EnvironmentThis section describes how to set up the environm ent. It contains the following

sections:

Set Up Tasks to Perform as the root User

Set Up Tasks to Per form as the oracle User

Set Up Tasks to Perform as the root UserAs the root user, configure the system for Oracle9i Real Application Clusters

Guard by setting the enviromen t options described in Table 14.

Table 14 UNIX Environment

Environment Option Requirement

UNIX group for oracle roles A UNIX group is required for the OSDBA role.Ensure that you have an OSDBA group defined in

the /etc/group file on all nodes of the cluster.

UNIX accounts A UNIX account that is dedicated to installing andrunn ing Oracle9i Real App lication Clusters Guard isneeded . The accoun t mu st be a member of theSYSDBA group. Create the UNIX account on allnod es of the cluster. This guid e assumes the accoun tis called oracle.

Login shell The Korn shell must be the default shell for the

oracle and root account that runs Oracle9i RealApp lication Clusters Guard. The Korn shell is theonly shell supp orted with this release of Oracle9iReal Application Clusters Guard . To use the Kornshell:

/bin/ksh

8/2/2019 A 95979

22/76



Set Up Tasks to Perform as the oracle UserLog in to the oracle accoun t and perform the following tasks, if required:

1. Set environm ent variables.

Table 15 lists required an d op tional environment v ariables to use for Oracle9iReal App lication Clusters Guard .

User equivalence The oracle accoun t installing and ru nn ing Oracle9i

Real App lication Clusters Guard m ust h ave remoteshell (REMSH/ RSH) access to all nodes in th ecluster. Set up user equ ivalence by ad ding entries forthe other nod es in the cluster to the .rhosts file ofthe oracle account or to the /etc/hosts.equivfile.

For examp le, create a .rhosts file in th e oracleuser's home directory on all nodes in the clusterwith the following format:

#

hosta oracle

hostb oracle

Per mission s for file creation Set th e file creation mask to 022 for the oracle

accoun t, as follows:$ umask 022

Table 14 UNIX Environment (Cont.)

Environment Option Requirement

8/2/2019 A 95979

23/76



Table 15 Environment Variables

Environment Variable Requirement Description

DB_NAME Required Specifies the value of the initializationparam eter DB_NAME entered d uring th eOracle installation process or du ringdatabase creation.

ORACLE_BASE Optional Specifies the directory at the top of theOracle software and administrative filestructure. Not required, butrecomm ended as part of anOFA-comp liant configurat ion.

Note: Do not set the ORACLE_BASEvariable if you are not u sing anOFA-comp liant configurat ion.

ORACLE_HOME Required Specifies the d irectory containing theOracle software for a p articular release.

Ensure that th e ORACLE_HOMEenvironm ent var iable specifies a d irectorythat does not already contain any Oraclesoftware.

ORACLE_SID Required Specifies the system identifier, or SID, forthe O racle Server instance. Because theSID is incorpora ted into m any filenames,Oracle Corporation recomm endsrestricting it to no more than four

characters, to avoid filename p roblems ondifferent systems. The SID for eachinstance in a Real App lication Clusterdatabase must be unique and shou ldincorporate the n ame of the d atabase ituses.

ORACLE_SERVICE Required Specifies a unique identifier for the

Oracle9i Real App lication Clusters Guardenvironm ent. This value is used to

identify each Or acle9i Real ApplicationClusters Guard environm ent. You can setthis variable to the same value as theDB_NAME environm ent var iable.

Use the ORACLE_SERVICE environm ent

variable to distinguish betw een Oracle9i

Real App lication Clusters Guardenvironments.

S tti th E i t

8/2/2019 A 95979

24/76



ORA_NLS33 Optional Specifies the location of the globaltechnology character set data. Required ifth e *.nlb files are not in the d efaultlocation, which is$ORACLE_HOME/ocommon/nls/admin/

data.

NLS_LANG Optional Required if you creating a database that

uses a char acter set other th an US7ASCII.PATH Required Specifies the search path for shell

executables:

For Sun Solaris, includ e the followingdirectories:

$ORACLE_HOME/bin,

/usr/ccs/bin, /usr/bin,

/etc, and /usr/local/bin if it

exists For HP-UX, includ e the following

directories:

$ORACLE_HOME/bin,

/usr/ccs/bin, /usr/bin,/etc, /usr/bin/X11, and/usr/local/bin if it exists

For Tru64, include the following

directories:

$ORACLE_HOME/bin, /usr/bin,/etc, /usr/bin/X11, and/usr/local/bin, if it exists

For AIX, include the followingdirectories:

$ORACLE_HOME/bin, /usr/bin,/etc, /usr/lbin,

/usr/bin/X11, an d /usr/local/bin, if it exists

Table 15 Environment Variables (Cont.)

Environment Variable Requirement Description


8/2/2019 A 95979

25/76



2. Check for user equ ivalence of the oracle accoun t by performing a remote

login (rlogin) to each nod e in the cluster, including the local node. If you are

promp ted for a password, the oracle accoun t does not hav e user equivalence.

Ensure that you give the same attribu tes to all the nod es in the cluster.

3. Make sure that you h ave a two node Oracle9i Real App lication Clustersdatabase running an d tuned with the Oracle products as listed in Table 13

installed. The alert log contains entr ies showing wh ether the Oracle9i Real

App lication Clusters software is run ning.

See Also: For more information on environment var iables, refer

to the Oracle9i A dministrators Reference for UNIX Systems.

Note: Make sure that the Real Applications Clusters database is

runn ing and p erforming as expected in a Primary/ Secondary

configuration.

Make sure that the d atabase is properly tuned for run time

performan ce as w ell as instance recovery.

Refer to the Oracle9i Real App lication Clusters Gu ard Concepts and

Administration Guide for more information on possible

configurations.


8/2/2019 A 95979

26/76



8/2/2019 A 95979

27/76

Configuration Tasks 2-1

2Configuration Tasks

This chap ter describes how to install and configure Oracle9i Real Application

Clusters Guard. It contains the following sections:

Installing Oracle9i Real App lication Clusters Guard

Installing th e Oracle9i Real Application Clusters Gu ard Files

Setting Up the Configuration File

Runn ing the Setup Ut ility (PFSSETUP)

Oracle Net Services Configuration

Installing Oracle9i Real Application Clusters Guard

8/2/2019 A 95979

28/76

g pp


Installing Oracle9i Real Application Clusters Guard

The following sections d escribe how to complete a new Oracle9i Real ApplicationClusters Guard installation:

Installing th e Oracle9i Real Application Clusters Gu ard Files


Running the Setup Utility (PFSSETUP)

Installing the Oracle9iReal Application Clusters Guard FilesOracle9i Real App lication Clusters Guard is included w ith the Oracle9i Real

App lication Clusters software. Oracle Un iversal Installer au tomat ically installs

Oracle9i Real App lication Clusters Guard when you choose to install Oracle9i Real

App lication Clusters software. For comp lete instru ctions on h ow to install Oracle9i

Real Application Clusters, refer to th e Oracle9i Real Application Clusters Installation

and Configuration Guide.

See Appendix Afor more information about Oracle9i Real Ap plication Clusters

Guard files and directories.

The following table describes the contents of the most importan t d irectories:

Directory Contents

admin SQL scripts

bin Oracle9i Real App lication Clusters Guard executables andutilities

doc README file

lib Library files

mesg Binary and text m essages

setup Oracle9i Real App lication setup executable and configura tion

files, templates, and samp le files

sys Oracle9i Real App lication Clusters Guard internal files

Note: The Oracle9i Real App lication Clusters Gu ard software

directory should exist on all nod es of the cluster w here Oracle9i

Real Application Clusters Guard ru ns.


8/2/2019 A 95979

29/76


Setting Up the Configuration FileThe information in the Oracle9i Real Application Clusters Guard configuration filecorresponds to a single Oracle9i Real App lication Clusters database. If you intend to

use Or acle9i Real App lication Clusters Guard w ith mu ltiple da tabases, you must

create a separate configuration file for each d atabase. The param eters in the O racle9i

Real Application Clusters Guard configuration file are used to create the Oracle9i

Real App lication Clusters Guard Packs and env ironmen t.

The $ORACLE_HOME/pfs/setup/conf/savsetup.dat file contains a temp late

for the Oracle9i Real Application Clusters Guard configuration file.

To create a separate configu ration file:

1. Change to the $ORACLE_HOME/pfs/setup/conf directory:

$ cd $ORACLE_HOME/pfs/setup/conf

2. Copy the savsetup.dat file to SALES.conf, where SALES is the value of the

$ORACLE_SERVICE variable. For example:

$ cp savsetup.dat SALES.conf

3. Use a text editor to m odify the Oracle9i Real App lication Clusters Guard

configura tion file. You m ust set all of the parameters in th e configuration file,

except ORACLE_BASE. Set ORACLE_BASE only if you are using Oracle

Flexible Architecture (OFA). If you are not u sing Oracle Flexible Architecture

(OFA), comm ent ou t the ORACLE_BASE entry.

You can u se the d efau lt values in th e configuration file if those values areacceptable.

The Oracle9i Real Application Clusters configuration file is d ivided into six

sections. Each section has been categorized based on th e Oracle9i Real

App lication Clusters Guard p aram eters contained in th at section. If you need to

mod ify an Oracle9i Real App lication Clusters Guard para meter, mod ify it using

the Oracle9i Real Application Clusters Guard Setup utility (PFSSETUP).

Depend ing on th e parameter, different files and areas of the Oracle9i RealApp lication Clusters Guard en vironmen t are affected. Each section head ing in

the configuration file identifies the requ irements for changing th e pa rameters in

tha t section. For examp le, chan ging th e ORACLE_SERVICE param eter affects

all of the Oracle9i Real Application Clusters Guard files, and therefore all files

mu st be regenerated and redeployed using the Oracle9i Real Application

Clusters Guard Setup utility.


8/2/2019 A 95979

30/76


For a detailed d escription of the the pa rameters in the Oracle9i Real Application

Clusters Guard installation configura tion parameter file, refer to the Oracle9i

Real A pplication Clusters Guard Concepts and Administration Guide.

Running the Setup Utility (PFSSETUP)This section d escribes how to configure Oracle9i Real Application Clusters Guard

using the Oracle9i Real App lication Clu sters Gu ard PFSSETUP utility. The

PFSSETUP utility u ses the Oracle9i Real App lication Clusters Guard configurationfile as described in "Setting Up the Configuration File" on page 2-3. The PFSSETUP

utility automatically searches for the ORACLE_SERVICE.conf file.

To ru n the PFSSETUP u tility:

1. Set the ORACLE_SERVICE and DB_NAME environment variables.

The ORACLE_SERVICE environ ment v ariable sp ecifies the O racle9i Real

Application Clusters Gu ard identifier. This identifier d ifferentiates one Oracle9i

See Also: For more information on the configuration files, refer to

App end ix B, "Configuration Files".

Note: Do not d elete any param eters from th e configuration file.

All of the p aram eters are required for Oracle9i Real Application

Clusters Guard to run .

Note: The PFSSETUP ut ility d eploys the Oracle9i Real

App lication Clusters Guard files on both cluster n odes.

Note: The following example shows th e outpu t as d isplayed on

the Sun SPARC Solaris p latform.

This example illustrates an initial configuration of Oracle9i Real

App lication Clusters Guard. For detailed information and more

examples of Oracle9i Real App lication Clusters Guard

configurations, refer to th e Oracle9i Real Application Clusters GuardConcepts and A dministration Guide.


8/2/2019 A 95979

31/76


Real Application Clusters Guard environment from another, and identifies the

correct Oracle9i Real Ap plication Clusters Guard configuration file. For

example:

$ export ORACLE_SERVICE=SALES

$ export DB_NAME=SALES

2. Change to the $ORACLE_HOME/pfs/setup directory and run the PFSSETUP

utility:

$ cd $ORACLE_HOME/pfs/setup

$ ./pfssetup

The PFSSETUP u tility version information is d isplayed:

PFS_SETUP for Solaris: Version 9.2.0.1.0 on Mon Mar 19 10:35:53 PST 2002

(c) Copyright 2002 Oracle Corporation. All rights reserved.

3. Confirm the O RACLE_SERVICE and DB_NAME settings w hen prom pted :

ORACLE_SERVICE is set to SALESDB_NAME is set to SALES

Do you wish to continue? [Y/N] Y

4. Enter Y to continue or N to exit the PFSSETUP utility.

5. Check the values of environment variables displayed.

The Oracle9i Real Application Clusters Guard Setup main m enu ap pears:

Choose the set of files from the following:1] User definitions file

2] ORACLE Real Application Clusters Guard files

3] ORACLE network files

4] ORACLE instance files

5] ORACLE network and instance files

6] All the files

7] Quit

PFS_SETUP>

Opt ions 1 to 5 in the preceding men u set u p on ly the files specified in the

option. For example, if you choose option 3, then only th e ORACLE network

files are set up .


8/2/2019 A 95979

32/76


6. To create a ll of the Oracle9i Real App lication Clusters Guard setup files, enter

option 6 at the promp t.

The following menu app ears:

Choose an operation on the selected files:

1] Generate only

2] Deploy only

3] Generate and deploy

4] Deinstall

5] List the affected files

6] Return to Main Menu

PFS_SETUP>

7. To generate and dep loy the setup files, enter option 3 at the prom pt.

The list of affected files app ears:

The list of affected files is

PFS_SALES.RUN

PFS_SALES.HALT

PFS_SALES.MONSTART

PFS_SALES.MONSTOPPFS_SALES_User.def

PFS_SALES_System.def

listener.ora.ded.pfs

tnsnames.ora.ded.pfs

tnsnames.ora.ded.clnt.pfs

SALES_config1.ded.pfs

SALES_config2.ded.pfs

SALES_config.pfs

init_SALES1_hosta.ora

init_SALES2_hostb.ora

Do you wish to continue? [Y/N]

Note: The list of affected files might d iffer for each pla tform. Thefollow ing exam ple shows the list for Sun SPARC Solaris. The

following list is the least nu mber of files for Sun SPARC Solaris.


8/2/2019 A 95979

33/76


8.Enter

Yto continu e.

The PFSSETUP u tility generates and dep loys the files to each nod e in the

cluster.

When th is process is complete, the menu sh own in step 5 reappears.

9. Enter 6 to return to the main m enu.

10. Enter 7 to exit.

Note: For H P 9000 Series H P-UX systems, th e list of files

generated also includ es:

PFS_SALES_hosta.sh

PFS_SALES_hostb.sh

PFS_SALES_hosta.conf

PFS_SALES_hostb.conf

Note: Do not start th e Oracle9i Real Application Clusters Guard

packs un til you have created the Oracle9i Real Application Clusters

da tabase. For m ore information, refer to Chapter 3,

"Post-Installation Tasks".


8/2/2019 A 95979

34/76



A description of how to configure the Oracle network is beyond the scope of thisguid e and is covered in detail in the Oracle Net Services A dministrators Guide and in

Oracle9i Real Application Clusters Concepts. However, to configure a minima l network

before exploring the features of Oracle9i Real Application Clusters Guard, verify

that m ultiple copies of the tnsnames.ora, sqlnet.ora, and listener.ora files

do n ot exist.

The PFSSETUP ut ility creates the required Oracle Net Services configuration files

for the Oracle9i Real App lication Clusters Guard env ironment, based on theinformation entered in th e Oracle9i Real App lication Clusters Gu ard configuration

file. Dur ing the d eploymen t ph ase, the Oracle9i Real App lication Clusters Guard

setup utility autom atically copies the generated Oracle Net Services files

(tnsnames.ora an d listener.ora) appended with a descriptive name and a

.pfs extension, into th e $TNS_ADMIN directory. The path for the $TNS_ADMIN

directory is specified in the Oracle9i Real App lication Clusters Guard configuration

file. The d efau lt setting for the TNS_ADMIN environment variable is

$ORACLE_HOME/network/admin.To avoid interfering with a cur rently running Oracle9i Real Application Clusters

environm ent, the PFSSETUP u tility d oes not au tomatically replace or install new ly

generated netw ork files. Before you can u se Oracle9i Real App lication Clusters

Guard , you mu st app end the files generated by the PFSSETUP u tility to the current

Oracle Net Services configurat ion files. See Chapter 3 for more information on u sing

the Oracle9i Real Application Clusters Guard files.

The follow ing Oracle Net Services files are generated by the PFSSETUP utility:

File Description

listener.ora.ded.pfs Dedicated server (IS_MTS param eter is set to false)configur ation file for th e listeners that identifies the Oracle9iReal Application Clusters Guard listener name and theservice it is listening for

listener.ora.mts.pfsShared server (IS_MTS param eter is set to tru e)configur ation file for th e listeners that identifies the Oracle9iReal Application Clusters Guard listener name and theservice it is listening for

tnsnames.ora.ded.pfs Dedicated server (IS_MTS param eter is set to false)configur ation file that contains net service names mapp ed toconnect descriptors


8/2/2019 A 95979

35/76


Dedicated SessionsThis section p rovides information on d edicated sessions.

Net Services for Server

Dur ing the Oracle9i Real App lication Clusters Guard setup , alistener.ora.ded.pfs file for the server n odes is created in the $TNS_ADMIN

d irectory if the TNS_ADMIN environmen t variable is defined , or in the

$ORACLE_HOME/network/admin directory if the TNS_ADMIN environmen t

variable is not defined .

The following examples show sam ple listener configurations generated by th e

PFSSETUP u tility.

Example 21 Sample Listener Configuration for Primary and Secondary Nodes

SALES_hosta_LSNR=

(DESCRIPTION= (ADDRESS=(PROTOCOL=TCP)(HOST=192.10.1.21)(PORT=2024)(QUEUESIZE=1024)))

STARTUP_WAIT_TIME_SALES_hosta_LSNR=0

CONNECT_TIMEOUT_SALES_hosta_LSNR=10

#TRACE_LEVEL_SALES_hosta_LSNR=SUPPORT

SALES_hostb_LSNR=

(DESCRIPTION= (ADDRESS=(PROTOCOL=TCP)(HOST=192.10.1.22) (PORT=2024)(QUEUESIZE=1024)))

STARTUP_WAIT_TIME_SALES_hostb_LSNR=0

CONNECT_TIMEOUT_SALES_hostb_LSNR=10

#TRACE_LEVEL_SALES_hostb_LSNR=SUPPORT

tnsnames.ora.ded.clnt.pfs Dedicated server client (IS_MTS parameter is set to false)configur ation file that contains net service names mapp ed toconnect descriptors

tnsnames.ora.mts.pfs Shared server (IS_MTS param eter is set to tru e)configur ation file that contains net service names mapp ed toconnect descriptors

tnsnames.ora.mts.clnt.pfs Shared server client (IS_MTS param eter is set to tru e)configur ation file that contains net service names mapp ed to

connect descriptors

File Description


8/2/2019 A 95979

36/76


Example 22 Sample Listener Configuration for OEM for Primary and Secondary

Nodes

SID_LIST_SALES_hosta_PRIVLSNR=

(SID_LIST=

(SID_DESC=(ORACLE_HOME=/u01/app/oracle/SALES/92)

(SID_NAME=SALES1)))

SALES_hosta_PRIVLSNR=

(DESCRIPTION= (ADDRESS=(PROTOCOL=TCP) (HOST=192.10.1.51) (PORT=2024) (QUEUESIZE=1024)))

STARTUP_WAIT_TIME_SALES_hosta_PRIVLSNR=0

CONNECT_TIMEOUT_SALES_hosta_PRIVLSNR=10#TRACE_LEVEL_SALES_hosta_PRIVLSNR=SUPPORT

SID_LIST_SALES_hostb_PRIVLSNR=

(SID_LIST=

(SID_DESC=(ORACLE_HOME=/u01/app/oracle/SALES/92)

(SID_NAME=SALES2)))

SALES_hostb_PRIVLSNR=(DESCRIPTION= (ADDRESS=(PROTOCOL=TCP) (HOST=192.10.1.52) (PORT=2024) (QUEUESIZE=1024)))

STARTUP_WAIT_TIME_SALES_hostb_PRIVLSNR=0

CONNECT_TIMEOUT_SALES_hostb_PRIVLSNR=10

#TRACE_LEVEL_SALES_hostb_PRIVLSNR=SUPPORT

Net Services for Clients

Dur ing the Oracle9i Real App lication Clusters Guard setup , atnsnames.ora.ded.clnt.pfs file for the client is created in the $TNS_ADMIN

directory if the TNS_ADMIN environment variable is defined , or in the

$ORACLE_HOME/network/admin directory if the TNS_ADMIN environment

variable is not defined.

The following exam ples show samp le service aliases in th e client

tnsnames.ora.ded.clnt file generated by th e PFSSETUP ut ility.

Example 23 Net Service Name for Connections to Primary Instance

SALES_DED=

(DESCRIPTION=

(LOAD_BALANCE=OFF)

(ADDRESS_LIST=

(ADDRESS=(PROTOCOL=TCP)(HOST=192.10.1.21)(PORT=2024))



8/2/2019 A 95979

37/76


)

(CONNECT_DATA=

(SERVICE_NAME=SALES.oracle.com)(SERVER=DEDICATED)

(INSTANCE_ROLE=PRIMARY)

)

)

Example 24 Net Service Name for TAF BASIC Connections to Primary Instance

SALES_DED_BASIC=

(DESCRIPTION=

(LOAD_BALANCE=OFF)

(FAILOVER=ON)

(ADDRESS_LIST= (ADDRESS=(PROTOCOL=TCP)(HOST=192.10.1.21)(PORT=2024))

(ADDRESS=(PROTOCOL=TCP)(HOST=192.10.1.22)(PORT=2024)))

(CONNECT_DATA=

(SERVICE_NAME=SALES.oracle.com)

(SERVER=DEDICATED)(INSTANCE_ROLE=PRIMARY)

(FAILOVER_MODE=

(BACKUP=SALES_DED_BASIC_BACKUP)

(TYPE=SELECT)

(METHOD=BASIC)

(RETRIES=180)

(DELAY=5) )))

SALES_DED_BASIC_BACKUP=(DESCRIPTION=

(LOAD_BALANCE=OFF)

(FAILOVER=ON)



(CONNECT_DATA=


(SERVER=DEDICATED)

(INSTANCE_ROLE=PRIMARY)

(FAILOVER_MODE=

(BACKUP=SALES_DED_BASIC)

(TYPE=SELECT)

(METHOD=BASIC)

(RETRIES=180)

(DELAY=5) )))


8/2/2019 A 95979

38/76


Example 25 Net Service Name for Dedicated TAF PRECONNECT Connections

SALES_DED_PRE=

(DESCRIPTION=

(LOAD_BALANCE=OFF)

(FAILOVER=ON)

(ADDRESS_LIST=



(CONNECT_DATA=


(SERVER=DEDICATED)(INSTANCE_ROLE=PRIMARY)

(FAILOVER_MODE=

(BACKUP=SALES_DED_PRE_SECONDARY)

(TYPE=SELECT)

(METHOD=PRECONNECT)

(RETRIES=180)

(DELAY=5) )))

SALES_DED_PRE_SECONDARY=(DESCRIPTION=

(LOAD_BALANCE=OFF)

(FAILOVER=ON)



(CONNECT_DATA=


(SERVER=DEDICATED)

(INSTANCE_ROLE=SECONDARY)

(FAILOVER_MODE=

(BACKUP=SALES_DED_PRE)

(TYPE=SELECT)

(METHOD=PRECONNECT)

(RETRIES=48)

(DELAY=900)

8/2/2019 A 95979

39/76

Post-Installation Tasks 3-1

3Post-Installation Tasks

This chapter describes post-installation tasks. It contains the following sections:

Post-Installation Tasks for the oracle User

Post-Installation Tasks for the root User

Starting Oracle9i Real App lication Clusters Guard

Troubleshooting

Note: To avoid interfering with a cu rrently running Oracle9i Real

App lication Clusters environm ent, the PFSSETUP u tility d oes not

automatically replace or install newly generated netw ork files.

Before you can u se Oracle9i Real App lication Clusters Guard, you

mu st app end the files generated by the PFSSETUP u tility to the

current Net Services configuration files.


8/2/2019 A 95979

40/76



Perform the following steps as the oracle user:

1. Log in as the Oracle software owner, typically, the oracle user.

2. Configure the server using the netw ork configuration files generated by the

PFSSETUP u tility.

Dur ing the Oracle9i Real App lication Clusters Gu ard setu p, the following

netw ork configuration files are created:

The files in the p receeding table are created in the $TNS_ADMIN directory if theTNS_ADMIN env ironment v ariable is defined, or in the

$ORACLE_HOME/network/admin directory if the TNS_ADMIN environmen t

variable is not defined .

a. If netw ork configuration files do not alread y exist, copy or rename the files

to the correct suffix. For exam ple:

$ cd $TNS_ADMIN

File Description

listener.ora.ded.pfs Dedicated server (IS_MTS param eter is set to false)configur ation file for th e listeners th at identifies theOracle9i Real App lication Clusters Guard listener nam eand the service it is listening for

listener.ora.mts.pfs Shared server (IS_MTS param eter is set to tru e)configur ation file for th e listeners th at identifies the

Oracle9i Real App lication Clusters Guard listener nam eand the service it is listening for

tnsnames.ora.ded.pfs Dedicated server (IS_MTS param eter is set to false)configur ation file that contains net service names mapp edto connect descriptors

tnsnames.ora.ded.clnt.pfs Dedicated server client (IS_MTS parameter is set to false)configur ation file that contains net service names mapp edto connect descriptors

tnsnames.ora.mts.pfs Shared server (IS_MTS param eter is set to tru e)configur ation file that contains net service names mapp edto connect descriptors

tnsnames.ora.mts.clnt.pfs Shared server client (IS_MTS param eter is set to true)configur ation file that contains net service names mapp edto connect descriptors


8/2/2019 A 95979

41/76


$ ls

listener.ora.ded.pfs tnsnames.ora.ded.pfs tnsnames.ora.ded.clnt.pfs

$ cp listener.ora.ded.pfs listener.ora$ cp tnsnames.ora.ded.pfs tnsnames.ora

b. Copy the client configuration file, tnsnames.ora.ded.clnt.pfs, to all

of the client system s.

c. If netw ork configuration files already exist, append the Or acle9i Real

Application Clusters Guard entries to the existing netw ork configuration

files. Ensure tha t all entries in the n etwork configuration files are un ique.

3. Set up the Oracle instance parameter files for Oracle9i Real App lication Clusters

Guard.

Dur ing the Oracle9i Real App lication Clusters Gu ard setup , the following

parameter files are created:

Filename Description

init_ORACLE_SERVICE_HOSTA.pfs Sample initialization p arameter file for host A.

init_ORACLE_SERVICE_HOSTB.pfs Sample initialization p arameter file for host B.

ORACLE_SERVICE_config.pfs Common configuration p arameter filecontaining recommended Oracle9i RealApplication Clusters Guard initialization andconfiguration parameter settings. Parametersfor this file should be set for both instances onhost A and host B.

This file contains tw o par ameters,PFILE_HOSTA and PFILE_HOSTB. Thesepar ameters are set to indicate the location of theinitialization param eter files for the tw o hosts.Ensure th at th ese files exist or create a link fromthe files you w ant to u se to the locationsspecified by these parameters.

ORACLE_SERVICE_config_HOSTA.mts.pfs Host A configuration p aram eter file containing

required Oracle9i Real Application ClustersGuard param eter settings for a system run ningshared server configuration.

ORACLE_SERVICE_config_HOSTA.ded.pfs Host A configuration p aram eter file containingrequired Oracle9i Real Application ClustersGuard param eter settings for a system run ningdedicated server configuration.


8/2/2019 A 95979

42/76


The files in the p receeding table are created in the

$ORACLE_BASE/admin/$DB_NAME/pfile directory for an OFA installation,

or in the $ORACLE_HOME/pfs/$DB_NAME/pfile for a non OFA installation.

If you already have initialization parameter files set up for the Oracle9i Real

Application Clusters database, you can use the IFILE parameter to includ e the

initialization param eter files created by Oracle9i Real Application Clusters

Guard.

The following example initSALES1.ora file shows a samp le initialization

parameter file for the first instance:

ifile=/u01/oracle/admin/SALES/pfile/initSALES.ora

rollback_segments=(rbs1_1, rbs1_2)

thread=1

cluster_database=true

instance_name=SALES1

The following example initSALES2.ora file shows a samp le initialization

parameter file for the second instance:



thread=2

cluster_database=true

instance_name=SALES2

The following example show s the contents of the initSALES1.ora file for the

first instance after embedd ing the Oracle9i Real App lication Clusters Gu ard

parameter files within an existing param eter file. Make sure not to includ e

mu ltiple entries for the same initialization parameter. Because they are includ ed

in the embedded parameter files, the THREAD and CLUSTER_DATABASE

param eters have been removed.

ORACLE_SERVICE_config_HOSTB.mts.pfs Host B configuration parameter file containingrequired Oracle9i Real Application ClustersGuard parameter settings for a system ru nningshared server configuration.

ORACLE_SERVICE_config_HOSTB.ded.pfs Host B configuration parameter file containingrequired Oracle9i Real Application ClustersGuard parameter settings for a system ru nningdedicated server configuration.

Filename Description


8/2/2019 A 95979

43/76



ifile=/u01/oracle/admin/SALES/pfile/init_SALES_nodeA.ora

ifile=/u01/oracle/admin/SALES/pfile/SALES_config.pfsifile=/u01/oracle/admin/SALES/pfile/SALES_config_nodeA.ded.pfs


The following example shows the contents of the initSALES2.ora file for the

second instance after embed ding th e Oracle9i Real App lication Clusters Guard

parameter files within an existing param eter file. Make sure that you only have

single entries for each initialization p aram eter. Because they a re includ ed in the

embedded parameter files, the THREAD and CLUSTER_DATABASEparam eters have been removed.


ifile=/u01/oracle/admin/SALES/pfile/init_SALES_nodeB.ora

ifile=/u01/oracle/admin/SALES/pfile/SALES_config.pfs

ifile=/u01/oracle/admin/SALES/pfile/SALES_config_nodeB.ded.pfs


For more information abou t these configuration files, refer to Appendix B.

4. Run the catpfs.sql script to create the requ ired Oracle9i Real Application

Clusters Guard objects in the database.

To run this script, you must have SYSDBA privileges. Run the script as follows:

a. Make su re that all user tables are available.

b. Change to the $ORACLE_HOME/pfs/admin directory:

$ cd $ORACLE_HOME/pfs/admin

c. Use SQL*Plus to connect to the d atabase as th e SYS user and run the

catpfs.sql script, wh ere sys_passwordis the password (for example,

CHANGE_ON_INSTALL) :

$ sqlplus SYS/sys_passwordAS SYSDBA

SQL> @catpfs.sql

The catpfs.sql script creates the following :

* Oracle9i Real App lication Clusters Guard user

* CUSTOMER_QUERY package for Oracle Heartbeat Monitor

* ORAPING_CONFIG and ORAPING_HEARTBEAT tables for Oracle

Heartbeat Monitor


8/2/2019 A 95979

44/76


* PFS$ORAPING_CON FIG and PFS$ORAPING_HEARTBEAT view s for

Oracle Heartbeat Monitor

* PFS_UP_INSTANCE_NAMEtables for the Oracle instance monitor

The following example show s outp ut from th e catpfs.sql script:

Enter the PFS software owner [Default: OPS$ORACLE]:ops$oracle

Dropping ops$oracle..

DROP USER ops$oracle CASCADE

*

ERROR at line 1:

ORA-01918: user 'OPS$ORACLE' does not exist

Creating ops$oracle..

User created.

Grant succeeded.

Below are the list of online tablespaces in this database.Decide which tablespace you wish to create the PFS tables and

indexes. It is NOT recommended to use the system tablespace

for storing PFS objects.

TABLESPACE_NAME

------------------------------

INDX

TEMP

TOOLSUSERS

RBS

Specify ops$oracle user's default tablespace:users

User altered.

Specify ops$oracle user's temporary tablespace:temp

User altered.

Creating Customer Query Package...

Specify owner of the customer query table:scott

Specify customer query table:emp


8/2/2019 A 95979

45/76


Connected.

Grant succeeded.

Connected.

Creating synonym for the customer query table...

Specify synonym for customer query table:emp

DROP SYNONYM emp

*

ERROR at line 1:

ORA-01434: private synonym to be dropped does not exist

Synonym created.

Creating CUSTOMER_QUERY package

Package created.

Package body created.

Creating tables and views for Oracle heartbeat monitor.

DROP PUBLIC SYNONYM pfs$oraping_config

*

ERROR at line 1:

ORA-01432: public synonym to be dropped does not exist

DROP PUBLIC SYNONYM pfs$oraping_heartbeat*

ERROR at line 1:


DROP PUBLIC SYNONYM oraping_heartbeat

*

ERROR at line 1:


DROP VIEW pfs$oraping_config

*

ERROR at line 1:

ORA-00942: table or view does not exist

DROP VIEW pfs$oraping_heartbeat

*


8/2/2019 A 95979

46/76


ERROR at line 1:


DROP TABLE oraping_config

*

ERROR at line 1:


DROP TABLE oraping_heartbeat

*

ERROR at line 1:


Table created.

1 row created.

Commit complete.

Table created.

Table altered.

1 row created.

Commit complete.

View created.

View created.

Synonym created.

Synonym created.

Synonym created.

View created.View created.

Creating tables and views for Oracle instance monitor.

Specify instance_name for instance on PFS_HOSTA: prod1

DROP TABLE pfs_up_prod1

*

ERROR at line 1:


Table created.

1 row created.

Specify instance_name for instance on PFS_HOSTB: prod2

DROP TABLE pfs_up_prod2

*

ERROR at line 1:


8/2/2019 A 95979

47/76



Table created.1 row created.

NOTE:

catpfs complete. Please check catpfs.log for any errors.

5. To ensu re that the Oracle9i Real App lication Clusters d atabase is functioning

prop erly, shu t dow n and start up all Oracle instances manu ally.

For examp le, enter the following comm and s whereINIT.ORA_parameter_file is the n ame of the initialization file as defined

by the PFILE variab le in the PFS_ORACLE_SERVICE_User.def definition file.

$ sqlplus "/ as sysdba"

SQL> STARTUP pfile=INIT.ORA_parameter_file

The definition file is located in the $ORACLE_HOME/pfs/DB_NAME/include

directory for non -OFA compliant installations and in the

$ORACLE_BASE/admin/DB_NAME/pfs/include directory for OFA

compliant installations.


8/2/2019 A 95979

48/76



Perform the following steps as the root user:

1. To ensu re that th e oracle user s environment is available to the root user, log

in as the oracle user and enter the following comman d:

$ su root

2. Set the ORACLE_SERVICE and DB_NAME environment va riables to the

app ropriate values.

3. If you h ave created a database manu ally, ensure that the system configura tion is

reflected in theoratab file. The oratab file is located in the/var/opt/oracle directory for Solaris and in the /etc directory for AIX, HP,and Tru64.

Add an entry for each server instance on the system using the following format:

DB_NAME:ORACLE_HOME:N

In this examp le N indicates that the database shou ld not be started at reboot

time. Always enter the N option so tha t Oracle9i Real Ap plication Clusters

Guard can control startup and shutd own of the database.

4. Change to the $ORACLE_HOME/pfs/setup directory and register the Oracle9i

Real Application Clusters Guard Packs with the cluster by runn ing the

createpacks script

Ensu re th at the DB_NAME, ORACLE_SERVICE, ORACLE_HOME, and if

necessary, the ORACLE_BASE environm ent variables are set correctly before

runn ing the script.

# cd $ORACLE_HOME/pfs/setup

# ./createpacks

Note: Perform the tasks d escribed in "Post-Installation Tasks for

the oracle User" on p age 3-2 before starting the tasks described in

this section.

Starting Oracle9i Real Application Clusters Guard

8/2/2019 A 95979

49/76


Starting Oracle9i Real Application Clusters GuardThe Oracle9i Real App lication Clusters Guard software is controlled from the

command line. To start Oracle9i Real App lication Clusters Gu ard:

1. Log in as th e root user.

2. Shu t dow n all listeners associated w ith the Oracle9i Real Ap plication Clusters

Guard da tabase on the cluster.

3. Ensure th at the DB_NAME, ORACLE_SERVICE, ORACLE_HOME, and if

necessary, the ORACLE_BASE environm ent var iables are set correctly.

4. To enter Oracle9i Real App lication Clusters Guard comm and s, enter the

following comm and :

# pfsctl

5. Start Oracle9i Real App lication Clusters Guard from the PFSCTL prom pt:

PFSCTL> pfsboot

6. Check the Oracle9i Real Application Clusters Guard packs log file for anyerrors:

For an OFA comp liant installation, check th e

pfs_ORACLE_SERVICE_hostname.log file in the

$ORACLE_BASE/admin/db_name/pfs/pfsdump directory.

Note: Run the createpacks script on only one of the nodes of

the cluster.

Note: For HP 9000 Series HP-UX systems, you m ust sh ut d own

the cluster before running th e createpacks script. To shu t down

the cluster, use th e cmhaltcl command.

See Also: Refer to the Oracle9i Real Application Clusters Guard

Concepts and A dministration Guide for information about the pfsctl

script.

Troubleshooting

F OFA li t i t ll ti h k th

8/2/2019 A 95979

50/76


For an non-OFA comp liant installation, check the

pfs_ORACLE_SERVICE_hostname.log file in the

$ORACLE_HOME/pfs/db_name/log/ directory.

7. Check the Oracle Heartbeat Monitor logs for errors:

For an OFA installation, check the

pfs_ORACLE_SERVICE_hostname_ping.log file in the

$ORACLE_BASE/admin/db_name/pfs/pfsdump directory.

For an non-OFA installation, check the

pfs_ORACLE_SERVICE_hostname_ping.log file in the

$ORACLE_HOME/pfs/db_name/log directory.

TroubleshootingThe following notes may help you to troubleshoot problems w ith Oracle9i Real

Application Clusters Guard:

The PFSCTL status outp ut "Both n odes are p art of cluster" does not ind icate that

both nodes are up an d ru nning. One of the nodes might be dow n. Check the

state of a node using the following comm and s:

For Sun Cluster 3.0:

/usr/cluster/bin/scstat

For HP:

/usr/sbin/cmviewcl

For Tru 64:

/usr/bin/caa_stat

For AIX:

/usr/es/sbin/cluster/clstat

The following p aram eters are not used by Oracle9i Real Application Clusters

Guard in Sun Cluster 3.0, but mu st be specified for comp atibility:

START_NET_TIMEOUT

STOP_NET_TIMEOUT

PFS_NET_IF_A *

Troubleshooting

PFS NET IF B*

8/2/2019 A 95979

51/76


PFS_NET_IF_B *

* Specify the actua l netw ork in terface adapter (tha t is, hme0) for PFS_NET_IF_A

and PFS_NET_IF_B, not the NAFO group.

If you h ave p roblems with NAFO on Sun Solaris, note the following:

If no N AFO group exists, the system attem pts to d iscover a netw ork

adapter on the subnet identified by the hostnames, and create single

adap ter NAFO groups.

If you w ant m ultiple net adap ters as backup s, get and use the adap ter lists

on the subnet identified by th e hostnames, and read the "How to ConfigurePublic Network Management (PN M)" chapter in the Sun Cluster 3.0

Installation Guid e.

To check the statu s of the NAFO group s, enter the following command :

$ /usr/cluster/bin/pnmstat -l

The outpu t might look similar to the following:

group adapters status fo_time act_adp

nafo0 hme0 OK NEVER hme0

For fur ther information on NAFO groups please refer to the Sun Cluster

documentation or contact Sun sup port.

If both th e nod es of the cluster simu ltaneously fail, the Oracle Real App lication

Clusters Guard Packs start automatically when the nodes reboot. Enter the

following comman d as the root user to stop the resources in the installenvironment:

# cd $ORACLE_HOME/pfs/bin

# pfsctl

PFSCTL>pfshalt

Troubleshooting

8/2/2019 A 95979

52/76


The following Oracle9i Real App lication Clusters Guard error might be

displayed because of inconsistencies between SC2.2 and SC3.0:

Alert: could not generate file properly - Packs files

If it app ears, remove all the files from the

$ORACLE_HOME/pfs/setup/output/ORACLE_SERVICE/packs directory

and reconfigure Oracle9i Real App lication Clusters Guard .

When using the OFA architecture, ensure any user-specific configuration files

for Real Application Clusters Guard a re backed u p and removed , so thatthey do

not conflict with the new Real App lication Clusters Gu ard files.

Note: This problem can occur any time all nodes are stopped

without first stopp ing the Oracle9i Real Application Clusters Gu ardPacks using pfsctl. For examp le, if you p erform a Sun Clusters

shu tdow n, which stops all nodes cleanly, it does not run pfsctl

and stop the p acks. When you later boot a node, the Oracle9i Real

App lication Clusters Guard Pack is restarted au tomatically.

8/2/2019 A 95979

53/76

Upgrading to Oracle9i Real Application Clusters Guard I 4-1

4Upgrading to Oracle9iReal Application

Clusters Guard I

This chap ter describes how to u pgrade to th is release of Oracle9i Real Application

Clusters Guard . Specifically, this chap ter describes:

Upgrad ing from Oracle9i Real App lication Clusters Gu ard Release 9.0.x

Upgrad ing from Oracle9i Real App lication Clusters Guard Release 9.0.1.x and

Oracle Parallel Fail Safe 8.1.7.2

Troubleshooting Tips

If an u pgrad e path is not d escribed in th is chapter then that up grade p ath is not

sup ported in this release.

Note: This release of Oracle9i Real Application Clusters Gu ardrequires Sun Cluster 3.0 on Sun Solaris systems. If you need to

up grad e the version of Sun Cluster, you m ust follow the

instructions in th is chapter.

8/2/2019 A 95979

54/76

Upgrading from Oracle9i Real Application Clusters Guard Release 9.0.x

3. Use the PFSSETUP utility to delete the old Oracle9i Real Ap plication Clusters

8/2/2019 A 95979

55/76


y p p

Guard Pack files:

a. Run the pfssetup utility:

$ pfssetup

b. Choose option 6 - All the files

c. Choose op tion 4 - Deinstall

Note th at this step d oes not remove the software files.

d. Log in as the root user.

e. Run the deletepacks comman d to d e-register the packs from the cluster

framework:


# ./deletepacks

4. Upgrade the cluster software from Sun Cluster 2.2 to Sun Cluster 3.0.

Refer to the Sun Cluster 3.0 documentation for instructions on th is procedure.

For add itional information, contact Sun sup port.

5. Test the Real Applications Clusters environm ent:

a. Boot both nod es into cluster mode.

b. Run Real Applications Clusters on both n odes.

Make sure that Real App lications Clusters and associated databases operatecorrectly on Sun Cluster 3.0 indep entently of Oracle9i Real Ap plication Clu sters

Guard before continu ing.

6. Install Oracle9i Real App lication Clu sters Gu ard Release 2 (9.2.0.1.0) using the

instructions in th e "Installing the Oracle9i Real App lication Clusters Guard

Files" section in Chapter 2 of this guide.

7. Test the Real App lication Clusters env ironment, again, by ru nning Real

App lications Clusters and testing that th e database is operating correctly.

8. Configure Oracle9i Real App lication Clusters Guard:

a. Shut dow n both instances.

b. Copy the savsetup.dat file to $ORACLE_SERVICE.conf:


$ cp savsetup.dat $ORACLE_SERVICE.conf

Upgrading from Oracle9i Real Application Clusters Guard Release 9.0.x

8/2/2019 A 95979

56/76


c. Update the $ORACLE_SERVICE.conf file using the configuration

information from the $ORACLE_SERVICE.conf.BACKUP92010 file yousaved in step 1.

d. Run the pfssetup utility:

$ pfssetup

e. Choose opt ion 6 - All the files

f. Choose option 1 - Generate Only

g. Choose opt ion 6 - All the files

h. Choose option 2 - Deploy Only

i. Log in as th e root user.

j. Run the createpacks command to register the packs from the cluster

framework:

# cd $ORACLE_HOME/pfs/setup# ./createpacks

9. Comp lete the installation:

a. Modify the app ropriate da tabase initialization (init.ora) files to include

the required Real Application Clusters Guard parameters as described in

Chapter 3.

b. Upd ate the Real Application Clusters Guard gen erated listener.oraan d tnsnames.ora files as described in Chapter 3.

c. Test the Real App lication Clusters env ironment, again, by ru nning Real

App lications Clusters and testing that th e database is operating correctly.

d. Ensure tha t the following env ironment variables are set correctly:

ORACLE_SERVICE

PFS_HOME DB_NAME

Upgrading from Oracle9i Real Application Clusters Guard Release 9.0.1.x and Oracle Parallel Fail Safe 8.1.7.2

e. Start the Oracle9i Real App lication Clusters Guard software:

8/2/2019 A 95979

57/76


$ pfsctl

PFSCTL> pfsboot

f. Check the $ORACLE_HOME/pfs/setup/PFS_Setup.log file for

messages. Messages that begin with ORA- an d PFS- might help you resolve

any problems you encounter.

Upgrading from Oracle9iReal Application Clusters Guard Release9.0.1.xand Oracle Parallel Fail Safe 8.1.7.2

This section describes how to up grad e to Oracle9i Real App lication Clusters Guard

Release 2 (9.2.0.1.0) if you curren tly u se any of the following releases:

Oracle9i Real App lication Clu sters Gu ard Release 9.0.1.3

Oracle Parallel Fail Safe 8.1.7.2

Perform the following step s:1. Back up all Oracle configu ration files.

Remember to back up files in the $ORACLE_HOME/network an d

$ORACLE_HOME/dbs directories. If you perform OFA comp liant installations,

also make backup s as follows:

a. Back up and remove a ll user-specific files by removing the following

directories:

$ORACLE_HOME/pfs

$ORACLE_BASE/admin/DB_NAME/pfs

$ORACLE_BASE/admin/DB_NAME/pfile

$ORACLE_BASE/admin/DB_NAME/network

b. Back up the Oracle Service configura tion file as follows:


$ cp $ORACLE_SERVICE.conf $ORACLE_SERVICE.conf.BACKUP92010

2. Use the pfsctl utility to stop the Oracle9i Real App lication Clusters Guard or

Oracle Parallel Fail Safe software:

a. Ensure that the following environment var iables are set correctly:

ORACLE_SERVICE


PFS_HOME

8/2/2019 A 95979

58/76


DB_NAME

b. Stop the Oracle9i Real App lication Clusters Guard software:

$ pfsctl

PFSCTL> pfshalt

3. Use the pfssetup utility to delete the old Oracle9i Real App lication Clusters

Guard Pack files:

a. Run the pfssetup utility:$ pfssetup

b. Choose opt ion 6 - All the files

c. Choose op tion 4 - Deinstall

Note that this step d oes not remove the software files.

d. Log in as th e root user.

e. Run the deletepacks command to de-register the packs from th e cluster

framework:


# ./deletepacks

4. Upgrad e the Oracle Server to Oracle9i release 9.2.0.1. Following the in stru ctions

for migrating the Oracle Database in the Oracle9i Migration documentation.

This step installs the Oracle9i Real Application Clusters Guard files.

5. Test the Real Applications Clusters environment:

a. Boot both nod es into cluster mode.

b. Run Real Applications Clusters on both nod es.

Make sure that Real App lications Clusters and associated databases operate

correctly indep end ently of Oracle9i Real App lication Clusters Gu ard before

continuing.

6. Configure Or acle9i Real App lication Clusters Guard :

a. Shut dow n both instances.


b. Copy the savsetup.dat file to $ORACLE_SERVICE.conf:

8/2/2019 A 95979

59/76



$ cp savsetup.dat $ORACLE_SERVICE.conf

c. Update the $ORACLE_SERVICE.conf file using the configuration

information from the $ORACLE_SERVICE.conf.BACKUP92010 file you

saved in step one.

d. Run the pfssetup utility:

$ pfssetup

e. Choose option 6 - All the files

f. Choose option 1 - Generate Only

g. Choose option 6 - All the files

h. Choose option 2 - Deploy Only

i. Log in as the root user.

j. Run the createpacks comman d to register the packs from the cluster

framework:


# ./createpacks

7. Comp lete the installation:

a. Modify the app ropriate database initialization (init.ora) files to include

the required Real Application Clusters Guard parameters as described in

Chapter 3.

b. Upd ate the Real Application Clusters Guard generated listener.ora

an d tnsnames.ora files as described in Chapter 3.

c. Test the Real App lication Clusters environmen t, again, by run ning Real

App lications Clusters an d testing that th e database is operating correctly.

d. Ensure that the following environment var iables are set correctly:

ORACLE_SERVICE

PFS_HOME

DB_NAME


e. Start the O racle9i Real Application Clusters Guard software:

8/2/2019 A 95979

60/76


$ pfsctl

PFSCTL> pfsboot

f. Check the $ORACLE_HOME/pfs/setup/PFS_Setup.log file for

messages. Messages that begin w ith ORA- an d PFS- might help you resolve

any problems you encounter.

Troubleshooting TipsConsider the following points while troubleshooting an upgrade problem:

The following m essage might appear if the

$ORACLE_HOME/pfs/setup/output/$ORACLE_SERVICE/packs directory

is not empty:

Alert: could not generate file properly - Packs files

When performing an OFA comp liant installation, user-specific configuration

files might conflict w ith the new Real Application Clusters Guard files. Back up

and remove these file to ensu re a sucessful up grad e.

If the pfshalt or haltone comm and s fail while using the pfsctl utility,

consider the following :

Check the a ssociated Real App lication Clusters Guard log files, Oracle log

files, network log files, and system log files for errors.

Check the Real App lication Clusters Guard Pack state using the scstatcomm and . If a Real Application Clusters Guard is in a STOP_FAILED state,

invest igate and correct the error before clearing the STOP_FAILED state

and restarting the pack.

The following conditions might p ut th e Real App lication Clusters Guard in a

STOP_FAILED sta te:

The Oracle instance cannot be stop ped .

The relocatable IP cannot be d isabled.

A timeout occurs.

After correcting th e condition an d clearing th e STOP_FAILED state, run the th e

pfshalt or haltone comm and again. These comm and s ensure that the

system clears any processes, shared m emory segments or other resources.


For inform ation on clearing th e STOP_FAILED flag, refer to the section

"Ad min istering Data-Service Resources" in the Sun Cluster 3 0 U1 Data

8/2/2019 A 95979

61/76


Ad min istering Da ta Service Resources in the Sun Cluster 3.0 U1 Data

Services, Installation and Configuration Gu ide.


8/2/2019 A 95979

62/76


8/2/2019 A 95979

63/76

Optimal Flexible Architecture A-1

AOptimal Flexible Architecture

The Oracle9i Real App lication Clusters Guard directory structu re depends on the

type of installation you perform w hen installing the software. This app end ix

contains the following sections:

Introdu ction to Op timal Flexible Architecture

OFA Comp liant Installation

Non -OFA Com pliant Installation

Introduction to Optimal Flexible Architecture

Introduction to Optimal Flexible ArchitectureOracle Corporation recomm end s the Optim al Flexible Architecture (OFA) stand ard

8/2/2019 A 95979

64/76

A-2 Real Application Clusters Guard I Configuration Guide

Oracle Corporation recomm end s the Optim al Flexible Architecture (OFA) stand ard

for Oracle installations. The OFA stan dard is a set of configuration gu idelines for

efficient an d reliable Oracle databases that require little maintenan ce.

OFA p rovides th e following benefits:

Organizes large amou nts of complicated software and d ata on disk to avoid

dev ice bottlenecks and poor performance

Facilitates routine adm inistrative tasks, such as software and data backup

functions, wh ich are often vulnerable to da ta corrup tion

Eases switching among mu ltiple Oracle databases

Manages and ad ministers database growth ad equately

Helps to eliminate fragmentation of free space in the d ata d ictionary, isolate

other fragmen tation, and m inimize resource contention

To switch to the OFA stand ard , you m ust m odify the directory structu re and

relocate th e d atabase files.

See Also:

See the O racle operating-sy

Documents

A 95979