sfrac-sol_sparc-VRTSdbac-5.1SP1RP2P1

 Basic information
Release type: P-patch
Release date: 2012-03-19
OS update support: None
Technote: None
Documentation: None
Popularity: 1141 viewed    downloaded
Download size: 2.86 MB
Checksum: 1299862213

 Applies to one or more of the following products:
Storage Foundation for Oracle RAC 5.1SP1 On Solaris 10 SPARC
Storage Foundation for Oracle RAC 5.1SP1 On Solaris 9 SPARC

 Obsolete patches, incompatibilities, superseded patches, or other requirements:

This patch requires: Release date
sfha-sol_sparc-5.1SP1PR3RP2 (obsolete) 2011-09-28
sfha-sol_sparc-5.1SP1RP2 (obsolete) 2011-09-28

 Fixes the following incidents:
2680843

 Patch ID:
148460-01, 148459-01

Readme file
                          * * * READ ME * * *
   * * * Veritas Storage Foundation for Oracle RAC 5.1 SP1 RP2 * * *
                         * * * P-patch 1 * * *
                         Patch Date: 2012-03-15


This document provides the following information:

   * PATCH NAME
   * PACKAGES AFFECTED BY THE PATCH
   * BASE PRODUCT VERSIONS FOR THE PATCH
   * OPERATING SYSTEMS SUPPORTED BY THE PATCH
   * INCIDENTS FIXED BY THE PATCH
   * INSTALLATION PRE-REQUISITES
   * INSTALLING THE PATCH
   * REMOVING THE PATCH


PATCH NAME
----------
Veritas Storage Foundation for Oracle RAC 5.1 SP1 RP2 P-patch 1


PACKAGES AFFECTED BY THE PATCH
------------------------------
VRTSdbac
VRTSdbac


BASE PRODUCT VERSIONS FOR THE PATCH
-----------------------------------
   * Veritas Storage Foundation for Oracle RAC 5.1 SP1


OPERATING SYSTEMS SUPPORTED BY THE PATCH
----------------------------------------
Solaris 9 SPARC
Solaris 10 SPARC


INCIDENTS FIXED BY THE PATCH
----------------------------
This patch fixes the following Symantec incidents:

Patch ID: 148459-01, 148460-01

* 2680843 (Tracking ID: 2719110)

SYMPTOM:
When you perform a rolling upgrade from any previous SF Oracle RAC release to
5.1SP1RP2, memory corruption can occur at the time of
VCSMM group registration. To verify, run the following command:
/opt/VRTSvcs/rac/bin/vcsmmdebug -D
If the group name displayed contains blank or garbage characters, it indicates
memory corruption.

DESCRIPTION:
Support for Solaris local zones was introduced in SF Oracle RAC 5.1 SP1 RP2
release. The VCSMM group name length was increased to 
support Solaris local zone without changing the protocol version. Since the
protocol version was not modified, the difference in the
length of the group name of previous and SF Oracle RAC 5.1 SP1 RP2 leads to
memory corruption while communicating group length on wire.

RESOLUTION:
The protocol version 20 has been introduced in this patch to support increased
VCSMM group size, required for communicating group 
name containing the Solaris local zone information. The protocol version 10 will
be used for communicating group names which do  
not contain Solaris local zone information. In a setup without Solaris local
zones, modify the /etc/vcsmmtab file to set the 
vcsmm_protocol_version to 10. This will enable rolling upgrades to SF Oracle RAC
6.0 and later releases, which do not support 
Solaris local zones.
In a setup with Solaris local zones, VCSMM will run with protocol version 20.
Therefore, rolling upgrades will be supported only to 
those SF Oracle RAC releases that support Solaris local zones. When the
vcsmm_protocol_version is not set(default), VCSMM will start
with the maximum protocol version(that is, 20 in this case)


INSTALLING THE PATCH
--------------------
This patch cannot be installed in rolling fashion. The patch should be installed on all the cluster nodes at the same time.
Perform the following steps on the SFRAC cluster:

Stopping SFRAC components:
----------------------------------------------
1. Update the PATH variable to include the /opt/VRTSvcs/bin path.
   This will enable you to run all VCS commands.

2. If the Oracle RAC instance is not managed by VCS, log in as the Oracle user on one of the cluster nodes and shut down the database:
        $ $ORACLE_HOME/bin/srvctl stop database -d <database_name>  
Where,
$ORACLE_HOME is the location where Oracle database binaries are installed.

3. Stop VCS. Run the following command on one of the cluster nodes.
        # hastop -all

4. Stop VCSMM. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/vcsmm stop

    For Solaris Sparc 5.10:
    # svcadm disable -t vcsmm

5. Unload VCSMM module. Run the following commands on all the cluster nodes.
    # modunload -i <id> 
    where, 
<id>         is the module id for VCSMM module.
    The VCSMM module id may be obtained by "modinfo | grep vcsmm".

6. Stop LMX. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/lmx stop

    For Solaris Sparc 5.10:
    # svcadm disable -t lmx 

7. Unload LMX module. Run the following commands on all the cluster nodes.
# modunload -i <id> 
where,
    <id>         is the module id for LMX module.
    The LMX module id may be obtained by "modinfo | grep lmx".

Installing the Patch:
---------------------
Perform the following steps on all the cluster nodes:

1. Uncompress the patch and change to the appropriate directory.

   Install the VRTSdbac 5.1SP1RP2P1 patch:
    For Solaris Sparc 5.9:
    # patchadd 148459-01

    For Solaris Sparc 5.10:
    # patchadd 148460-01

2. Verify that the new patch is installed:
    For Solaris Sparc 5.9:
    # showrev -p | grep 148459-01

    For Solaris Sparc 5.10:
    # showrev -p | grep 148460-01

       The following output is displayed if the patch
    is installed successfully:

For Solaris Sparc 5.9:
   Patch: 148459-01 Obsoletes:  Requires:145450-03 Incompatibles: Packages: VRTSdbac

For Solaris Sparc 5.10:
Patch: 148460-01 Obsoletes:  Requires: 145451-03 Incompatibles:  Packages: VRTSdbac

ADD PROTOCOL VERSION IN VCSMMTAB FILE:
--------------------------------------
If you are running SFRAC without Solaris local zone, add following entry in /etc/vcsmmtab file on all the cluster nodes.
vcsmm_protocol_version=10
For example,
$ cat /etc/vcsmmtab
/sbin/vcsmmconfig -c > /var/VRTSvcs/log/vcsmmconfig.log 2> &1 &
vcsmm_protocol_version=10
If you are running SFRAC with Solari local zone, do not set the VCSMM protocol version in /etc/vcsmm tab file on any of the cluster nodes.

Restarting SFRAC components on the cluster node:
------------------------------------------------
Perform the following steps on the SFRAC cluster:
1. Start VCSMM. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/vcsmm start

    For Solaris Sparc 5.10:
    # svcadm enable vcsmm

2. Start LMX. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/lmx start

    For Solaris Sparc 5.10:
    # svcadm enable lmx 

3. Start VCS. Run the following commands on all the cluster nodes.
    # hastart

4. If Oracle RAC instances are not managed by VCS, then start the database manually. Run the following commands on one of the cluster nodes.
    $ $ORACLE_HOME/bin/srvctl start instance -d <database_name>  -i <instance-name> 
    Where,
           $ORACLE_HOME is the location where Oracle database binaries are installed.


REMOVING THE PATCH
------------------
Stopping SFRAC components:
----------------------------------------------
Run the following steps on all the SFRAC cluster nodes:
1. Update the PATH variable to include the /opt/VRTSvcs/bin path.
   This will enable you to run all VCS commands.

2. If the Oracle RAC instance is not managed by VCS, log in as the Oracle user on one of the cluster nodes and shut down the database:
        $ $ORACLE_HOME/bin/srvctl stop database -d <database_name>  
Where,
$ORACLE_HOME is the location where Oracle database binaries are installed.

3. Stop VCS. Run the following command on one of the cluster nodes.
        # hastop -all

4. Stop VCSMM. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/vcsmm stop

    For Solaris Sparc 5.10:
    # svcadm disable -t vcsmm

5. Unload VCSMM module. Run the following commands on all the cluster nodes.
    # modunload -i <id> 
    where, 
<id>         is the module id for VCSMM module.
    The VCSMM module id may be obtained by "modinfo | grep vcsmm".

6. Stop LMX. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/lmx stop

    For Solaris Sparc 5.10:
    # svcadm disable -t lmx

7. Unload LMX module. Run the following commands on all the cluster nodes.
    # modunload -i <id> 
    where,
    <id>         is the module id for LMX module.
    The LMX module id may be obtained by "modinfo | grep lmx".

Uninstalling the Patch:
-----------------------
Perform the following steps on all the cluster nodes:
1. Uninstall the patch:
        For Solaris Sparc 5.9:
        # patchrm 148459-01

        For Solaris Sparc 5.10:
        # patchrm 148460-01


2. Verify that the patch is uninstalled from the node:
    For Solaris Sparc 5.9:
    # showrev -p | grep 148459-01

    For Solaris Sparc 5.10:
    # showrev -p | grep 148460-01

        If the patch is successfully uninstalled, there will be no output.

REMOVE PROTOCOL VERSION IN VCSMMTAB FILE:
-----------------------------------------
Remove vcsmm_protocol_version=10 entry in /etc/vcsmmtab file.

Restarting SFRAC components on the cluster node:
------------------------------------------------
Perform the following steps on the SFRAC cluster:
1. Start VCSMM. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/vcsmm start

    For Solaris Sparc 5.10:
    # svcadm enable vcsmm

2. Start LMX. Run the following commands on all the cluster nodes.
    For Solaris Sparc 5.9:
    # /etc/init.d/lmx start

    For Solaris Sparc 5.10:
    # svcadm enable lmx

3. Start VCS. Run the following commands on all the cluster nodes.
    # hastart

4. If Oracle RAC instances are not managed by VCS, then start the database manually. Run the following commands on one of the cluster nodes.
    $ $ORACLE_HOME/bin/srvctl start instance -d <database_name>  -i <instance-name> 
    Where,
           $ORACLE_HOME is the location where Oracle database binaries are installed.


SPECIAL INSTRUCTIONS
--------------------
SPECIAL INSTRUCTIONS
--------------------
For SFRAC with Solaris local zone, use VCSMM protocol version 20.
For SFRAC without Solaris local zone, use VCSMM protocol version 10.

To use VCSMM protocol version 20, do not set vcsmm_protocol_version in /etc/vcsmmtab on any of the cluster nodes, before starting VCSMM.
To use VCSMM protocol version 10, add following entry in /etc/vcsmmtab file on all the cluster nodes, before starting VCSMM.
vcsmm_protocol_version=10


OTHERS
------
NONE