Known Documentation Problems

This section discusses known errors or omissions for documentation and online help and steps to correct these problems.

Sun Cluster HA for Oracle Packages

The introductory paragraph to "Installing Sun Cluster HA for Oracle Packages" in the Sun Cluster 3.0 12/01 Data Services Installation and Configuration Guide does not discuss the additional package needed for users with clusters running Sun Cluster HA for Oracle with 64-bit Oracle. The following section corrects the introductory paragraph to "Installing Sun Cluster HA for Oracle Packages" in the Sun Cluster 3.0 12/01 Data Services Installation and Configuration Guide.

Installing Sun Cluster HA for Oracle Packages

Depending on your configuration, use the scinstall(1M) utility to install one or both of the following packages on your cluster. Do not use the -s option to non-interactive scinstall to install all of the data service packages.

• SUNWscor: Cluster running Sun Cluster HA for Oracle with 32 bit Oracle or 64-bit Oracle

• SUNWscorx: Cluster running Sun Cluster HA for Oracle with 64-bit Oracle

SUNWscor is the prerequisite package for SUNWscorx.

If you installed the SUNWscor data service package as part of your initial Sun Cluster installation, proceed to "Registering and Configuring Sun Cluster HA for Oracle" on page 30. Otherwise, use the following procedure to install the SUNWscor and SUNWscorx packages.

Apache Packages Required for All Sun Cluster Software Installation Methods

SunPlex Manager software requires that Apache software packages already be installed on the node before you install SunPlex Manager. This is true whether you install SunPlex Manager manually or whether it is installed automatically by the interactive scinstall(1M) method or the scinstall JumpStart method. If the Apache software is not installed before SunPlex Manager is installed, you will see a message similar to the following.

NOTICE: To finish installing the SunPlex Manager, you must installthe SUNWapchr and SUNWapchu Solaris packages and any associatedpatches. Then run '/etc/init.d/initspm start' to start the server.

The Sun Cluster 3.0 12/01 Software Installation Guide procedure "How to Install SunPlex Manager Software" includes a step to ensure that Apache software packages are first installed. However, the procedures "How to Install Sun Cluster Software on the First Cluster Node (scinstall)," "How to Install Sun Cluster Software on Additional Cluster Nodes (scinstall)," and "How to Install Solaris and Sun Cluster Software (JumpStart)" do not include this step.

If you intend to use SunPlex Manager and you use either the interactive scinstall(1M) method or the scinstall JumpStart method to install Sun Cluster software, ensure that Apache software packages are installed on a node before you begin Sun Cluster software installation. See Step 3 of "How to Install SunPlex Manager Software" in the Sun Cluster 3.0 12/01 Software Installation Guide for instructions.

New Man Page Path for VxVM

The Sun Cluster 3.0 12/01 Software Installation Guide omits the new man page path for later releases of VERITAS Volume Manager (VxVM). The MANPATH currently documented, /opt/VRTSvxvm/man, is valid for VxVM 3.0.4 and 3.1. For VxVM 3.1.1 and 3.2, use /opt/VRTS/man for the MANPATH.

Generic Data Service Package Installation During Upgrade

Instructions to install the Sun Cluster 3.0 generic data service package, SUNWscgds, are missing from the upgrade procedures in the Sun Cluster 3.0 12/01 Software Installation Guide. This package is not installed automatically by the scinstall(1M) upgrade options. After you upgrade Sun Cluster software, use the pkgadd(1M) command to install the SUNWscgds package from the Sun Cluster 3.0 12/01 CD-ROM. You do not need to reboot the node after you install this package.

VERITAS File System (VxFS) Commands to Create a VxFS File System

In the procedure "How to Add Cluster File Systems" in the Sun Cluster 3.0 12/01 Software Installation Guide and in the Sun Cluster 3.0 12/01 System Administration Guide, the step to use the newfs(1M) command to create a new file system is only valid for UFS file systems. To create a new VxFS file system, follow procedures provided in your VxFS documentation.

How to Create More Than Three Disksets in a Cluster

If you intend to create more than three disksets in the cluster, perform the following steps before you create the disksets. Follow these steps regardless of whether you are installing disksets for the first time or you are adding more disksets to a fully configured cluster.

1. Ensure that the value of the md_nsets variable is set high enough to accommodate the total number of disksets you intend to create in the cluster.

   1. On any node of the cluster, check the value of the md_nsets variable in the /kernel/drv/md.conf file.

   2. If the total number of disksets in the cluster will be greater than the existing value of md_nsets minus one, on each node increase the value of md_nsets to the desired value.

      The maximum permissible number of disksets is one less than the value of md_nsets. The maximum possible value of md_nsets is 32.

   3. Ensure that the /kernel/drv/md.conf file is identical on each node of the cluster.

      ---

      Caution -

      Failure to follow this guideline can result in serious Solstice DiskSuite errors and possible loss of data.

      ---

   4. From one node, shut down the cluster.

      # scshutdown -g0 -y

   5. Reboot each node of the cluster.

      ok> boot

2. On each node in the cluster, run the devfsadm(1M) command.

   You can run this command on all nodes in the cluster at the same time.

3. From one node of the cluster, run the scgdevs(1M) command.

4. On each node, verify that the scgdevs command has completed before you attempt to create any disksets.

   The scgdevs command calls itself remotely on all nodes, even when the command is run from just one node. To determine whether the scgdevs command has completed processing, run the following command on each node of the cluster.

   % ps -ef | grep scgdevs

SunPlex Manager Online Help Correction

A note in the SunPlex Manager's online help is inaccurate. The note appears in the Oracle data service installation procedure. The correction is as follows.

Incorrect:

Note: If no entries exist for the shmsys and semsys variables in the /etc/system file when SunPlex Manager packages are installed, default values for these variables are automatically put in the /etc/system file. The system must then be rebooted. Check Oracle installation documentation to verify that these values are appropriate for your database.

Correct:

Note: If no entries exist for the shmsys and semsys variables in the /etc/system file when you install the Oracle data service, default values for these variables can be automatically put in the /etc/system file. The system must then be rebooted. Check Oracle installation documentation to verify that these values are appropriate for your database.