< Previous  | TOC | Index | Next  >

Creating service groups using the configuration wizard

You can use a configuration wizard to configure the VCS service groups for Storage Foundation for Oracle RAC environment. The wizard enables you to modify the CVM service group to include the CRS resources. Note that the wizard for Oracle 10g does not create the service group for the Oracle database. To monitor the Oracle database using the Oracle Agent provided by VCS, you must edit the main.cf manually after you finish running the wizard. See Location of VCS log files for details.

Before Starting the Wizard

Before starting the Wizard, you can verify that your Oracle installation can be configured. Review the requirements listed below. Also, you need to provide the wizard information as it proceeds. Make sure you have that information at hand.

Prerequisites

• Oracle RAC instances and listeners must be running on all cluster nodes.
• The database files of all instances must be on a cluster file system.

  ---

    Note   The Wizard does not support using the same file system for the Oracle binary and Oracle datafiles.

  ---

• The OCR file and VOTE file location must be on a raw volume or a cluster file system.
• Each Oracle instance must be associated with a listener.

  ---

    Note    The RAC configuration wizard requires that for the default listener, the listener parameter file, listener.ora, must reside in $ORACLE_HOME/network/admin. No such restriction applies for non-default listeners.

  ---

• The IP addresses and host names specified in the files listener.ora and tnsnames.ora must be the same.
• Virtual IPs required for CRS must be up.

Information Required From the User

• RAC database instances to be configured
• NICs for Private NIC resource
• Registry and vote disk location for CRS

Establishing graphical access for the wizard

The configuration wizard requires graphical access to the VCS systems where you want to configure service groups. If your VCS systems do not have monitors, or if you want to run the wizards from a remote HP system, do the following:

 To establish graphical access from a remote system

1. From the remote system, (jupiter, for example), run xhost +

   # xhost +

2. Complete one of the following operations (depending on your shell):
   • If you are running ksh, run this step on one of the systems where the wizard will run (for example, jupiter):

     # export DISPLAY=jupiter:0.0

   • If you are running csh, run this step

     # setenv DISPLAY jupiter:0.0

3. Verify the DISPLAY environment variable is updated:

   # echo $DISPLAY

   jupiter:0.0

4. Make sure to set the JRE_HOME variable to /opt/VRTSjre/jre1.4. If VRTSjre1.4 is not installed, the hawizard exits after displaying an error message.

Creating service groups using the configuration wizard

Start the configuration wizard for Oracle 9i RAC at the command-line.

 To create service groups using the configuration wizard

1. Log on to one of your VCS systems as superuser.
2. Start the configuration wizard.

   # /opt/VRTSvcs/bin/hawizard rac

3. Read the information on the Welcome screen.
   • If your configuration does not meet the requirements, click Cancel to stop the wizard. Start the wizard again after taking the necessary steps to meet the requirements.
   • If your configuration meets the requirements, click Next. The wizard begins discovering the current Oracle RAC information before proceeding.

     If the wizard does not find all databases and listeners running on all nodes in the cluster, it halts with an error, indicating the problem. Click Cancel, and start the wizard again after you correct the problem.

4. In the Wizard Options dialog box, select the Create RAC Service Group option.
5. Enter a name for the RAC service group in the Service group name box and click Next.
6. In the Database Selection dialog box, select a database and click Next.
7. In the Instance Configuration dialog box, specify information for all instances of the database you selected.

Click the thumbnail above to view full-sized image.

Specify the following information for each Oracle instance that is displayed and click Next:

Oracle Parameter File (Pfile)	Verify the location of the Oracle Parameter File.  Edit the information if necessary.
Start Options	Choose the Start options, if desired. Default is STARTUP_FORCE.
Stop Options	Choose the Stop options, if desired. Default is IMMEDIATE.
Configure detail monitoring	Select the check box if you want to monitor the database in detail.  If you want to enable Detail Monitoring, be sure you have previously set up the database table, user, and password for the agent to use during monitoring.
Specify Advanced Options	Select the check box to enter advanced configuration information for the database instances.

8. If you chose to monitor the database in detail, the Detail Monitoring dialog box is displayed.

Click the thumbnail above to view full-sized image.

Specify the following information for the database instances that you want the agent to monitor in detail and click Next:

Select	Select the check box corresponding to the database to be monitored in detail.
User	Enter a valid user name for the database that the Oracle agent uses to log in to monitor the health of the database.
Password	Enter a valid password for the database user.    Note   Do not encrypt passwords when entering them through the Agent Configuration Wizard; the wizard takes care of encrypting passwords.
Table	Enter the name of a table that will be queried to validate the status of the database.

9. If you chose to specify advanced options, the Oracle Advanced Configuration dialog box is displayed.

Click the thumbnail above to view full-sized image.

Specify the following information for the Oracle instances that you want to configure advanced attributes and click Next:

Oracle EnvFile	Enter the location of the Oracle Envfile, the source file used by the agent entry point scripts.
Oracle Encoding	Enter the the operating system encoding that corresponds to Oracle encoding for the displayed Oracle output.   The encoding value must match the encoding value used by the Netlsnr configuration.
AutoEndBkup	Select the check box, if desired.   Specifies that data files in the database are taken out of the backup mode when instance is brought online.

Refer to the Veritas High Availability Agent for Oracle Installation and Configuration Guide for a complete description of these attributes.

10. In the Monitor option Configuration dialog box, specify the monitor option for the Oracle instances, and click Next.

    The default monitor option is Process check.

11. In the Private NIC Configuration dialog box, specify the NIC and IP address for Private NIC agent.

Click the thumbnail above to view full-sized image.

Specify the following information for each node in the cluster and click Next:

Address	Enter the private IP address that is used by Oracle 10g CRS.
Select	Select the checkbox against the network cards in the Device column. This NIC will be used by the PrivNIC agent.
Netmask	Enter the netmask.

12. In the CRS Configuration dialog box, specify the location for CRS vote disk and OCR registry.

    Enter the cluster file system or raw volume location for the CRS vote disk and registry. Example vote disk location:

    • /ora_crs/VOTE-disk/vote_file (if you are using a cluster file system)
    • /dev/vx/rdsk/crs_oradg/crsvol (if you are using raw volumes)

Click the thumbnail above to view full-sized image.

13. In the Database Configuration dialog box, verify the mount point of the database that the wizard displays. Confirm or modify the mount options displayed and click Next.

    Note that the wizard discovers the mount point if the database is installed on a cluster file system. If the database exists on raw volumes, the wizard discovers the volumes.

Click the thumbnail above to view full-sized image.

14. In the Service Group Summary dialog, review your configuration.

    Click on a resource to view its attributes and their configured values in the Attributes box.

Click the thumbnail above to view full-sized image.

• Click a resource within the service group to display its attributes and their values.

  For example, if you click on the name of the cssd application resource, cssd-resource, the wizard displays details of the cssd application resource.

  Attributes for the CFSMount resource show dependencies.

  The NetLsnr resource is configured as part of the CVM service group. The CVM service group also contains other resources, which may not be displayed by the wizard because the wizard does not control them.

• Change names of resources, if desired; the wizard assigns unique names to resources based on their respective name rules.

  To edit a resource name, select the resource name and click on it, press Enter after editing each attribute.

15. Review your configuration and click Finish.

    The wizard starts running commands to create the Oracle RAC service group. Various messages indicate the status of these commands.

16. In the Completing the Oracle Configuration wizard dialog box, select the Bring the service group online check box to bring the service group online on the local system.
17. Click Close.

    The wizard creates the Oracle RAC service group in your cluster and adds the Netlsnr resource to the CVM configuration.