vcs-win_x64-Hotfix_6_0_20001_3314655

 Basic information
Release type: Hot Fix
Release date: 2014-02-01
OS update support: None
Technote: TECH214469-In a network using tagged VLAN configuration or NIC Teaming Software, the VCS IP agent may assign the virtual IP address or the virtual server name to an incorrect network interface, if the interfaces have same MAC address.
Documentation: None
Popularity: 3668 viewed    downloaded
Download size: 604.22 KB
Checksum: 997879303

 Applies to one or more of the following products:
Cluster Server 6.0.2 On Windows x64
Storage Foundation HA 6.0.2 On Windows x64

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

 Fixes the following incidents:
3314655

 Patch ID:
None.

Readme file
                          * * * READ ME * * *
                * * * Veritas Cluster Server 6.0.2 * * *
                         * * * Hot Fix 1 * * *
                         Patch Date: 2013-10-08


This document provides the following information:

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


PATCH NAME
----------
Veritas Cluster Server 6.0.2 Hot Fix 1


OPERATING SYSTEMS SUPPORTED BY THE PATCH
----------------------------------------



BASE PRODUCT VERSIONS FOR THE PATCH
-----------------------------------
   * Veritas Cluster Server 6.0.2
   * Veritas Storage Foundation High Availability 6.0.2


SUMMARY OF INCIDENTS FIXED BY THE PATCH
---------------------------------------
Patch ID: Hotfix_6_0_20001_3314655
* 3314655 (3314655) In a network using tagged VLAN configuration, the VCS IP agent may assign the virtual IP address or the virtual server name to an incorrect network interface, if the interfaces have same MAC address.


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

Patch ID: Hotfix_6_0_20001_3314655

* 3314655 (Tracking ID: 3314655)

SYMPTOM:
In a network using tagged VLAN configuration, the VCS IP agent may assign the virtual IP address or the virtual server name to an incorrect network interface, if the interfaces have same MAC address.

DESCRIPTION:
In tagged VLAN network configurations; there are multiple independent logical network interfaces that are created within a physical network interface or a teamed network interface. Each of these logical network interfaces may have the same MAC address.
During the application service group configuration, the VCS application configuration wizard enables you to provide the virtual IP address or the virtual server name for the application to be configured. The wizard also enables you  to select an interface to which the specified virtual IP address or the virtual server name should be assigned.
After you select the required interface, the wizard internally sets the MAC address of the selected interface as the value of the "MACAddress" attribute of the IP agent. While selecting the interface, if you choose any of the logical interfaces that share the MAC address with other logical interfaces, then the IP agent may assign the specified virtual IP address or the virtual server name to an interface other than the one selected.
This issue occurs because the IP agent uses the MAC address of the interface to identify and assign the IP address. Since the MAC address of all the logical interfaces is identical, the agent may fail to identify the selected interface and as a result assign the IP address or virtual server name to an incorrect interface.

RESOLUTION:
The IP agent currently uses the MAC address specified in the "MACAddress" attribute to identify the interface to which the IP address should be assigned. The agent is now enhanced to use either the MAC address or the interface name as the parameters to identify the interface.
To identify the interface based on its name, you must edit the x93MACAddressx94 attribute of the IP agent, after you configure the application service group. 
Use the VCS Java Console to edit the x93MACAddressx94 attribute and enter the interface name instead of the MAC address. You must enter the interface name in double quotes.
For example, 
MACAddress = x93InterfaceNamex94

Notes:
- After you specify the interface name as the x93MACAddressx94 attribute value, if you want to use the VCS wizards to modify any settings, then you must first reset the value of the x93MACAddressx94 attribute to use the MAC address of the interface.
Failing this, the VCS wizard may fail to identify and populate the selected interface. 
Use the VCS Java Console to edit the attribute values.

- If you change the interface name, you must update the x93MACAddressx94 attribute value to specify the new name. 
Failing this, the IP resource will go in an UNKNOWN state.

- While editing the x93MACAddressx94 attribute to specify the interface name, you must specify the name of only one interface.

Binary File / Version:
IP.dll / 6.0.20001.50



INSTALLING THE PATCH
--------------------
To install the hotfix using the GUI
-----------------------------------+
Perform the following steps on all the cluster nodes:

1. Double-click the appropriate hotfix executable file to extract the contents. The files are extracted at the following location:
"%commonprogramfiles(x86)%Veritas SharedWxRTPrivates"
The Hotfix Installer Wizard is automatically launched after all the files are extracted.

2. Click "Next" on the Welcome screen.
The Hotfix Installation Tasks panel lists the tasks that are performed by the installer.

3. Click "Install Hotfix" to install the hotfix.
The status of each task is updated as it gets completed.

4. After the tasks are complete, click "Next" and then click "Finish" to complete the installation process.

To install the hotfix using the command line
--------------------------------------------+
Perform the following steps on all the cluster nodes:

1. At the command prompt run one of the following commands to extract the hotfix files to the default location:
C:	emp> <HotfixName_Platform.exe>  /x
or
C:	emp> <HotfixName_Platform.exe>  /extract

2. From the command prompt, navigate to the following location where the hotfix files are extracted.
"%commonprogramfiles(x86)%Veritas  SharedWxRTPrivates<HotfixName> "

3. At the command prompt, run the following command to install the hotfix:
vxhf.exe /install:<HotfixName>  /silent
Here, <HotfixName>  is the name of the hotfix file without the platform and the .exe extension.

4. Follow the instructions displayed in the command prompt to complete the hotfix installation.


REMOVING THE PATCH
------------------
Additional Notes

- To confirm the installation of the hotfix, run the following command:
vxhf.exe /list
The output of this command lists the hotfixes installed on a system.

- For details about a particular hotfix, run the following command:
vxhf.exe /display:<HotfixName> 
Here, <HotfixName>  is the name of the hotfix file without the platform and the .exe extension.

- The hotfix installer (vxhf.exe) creates and stores logs at:
"%allusersprofile%Application DataVeritasVxHF"

- For general information about the hotfix installer (vxhf.exe), please refer to the following technote:
http://www.symantec.com/business/support/index?page=content&id=TECH73446

- To view a list of hotfixes already installed on a system, please refer to the steps mentioned in the following technote: 
http://www.symantec.com/business/support/index?page=content&id=TECH73438

- For information on uninstalling a hotfix, please refer to the steps mentioned in the following technote: 
http://www.symantec.com/business/support/index?page=content&id=TECH73443


SPECIAL INSTRUCTIONS
--------------------
Disclaimer
This fix is provided without warranty of any kind including the warranties of title or implied warranties of merchantability, fitness for a particular purpose and non-infringement.  Symantec disclaims all liability relating to or arising out of this fix. It is recommended that the fix be evaluated in a test environment before implementing it in your production environment. When the fix is incorporated into a Storage Foundation for Windows maintenance release, the resulting Hotfix or Service Pack must be installed as soon as possible. Symantec Technical Services will notify you when the maintenance release (Hotfix or Service Pack) is available if you sign up for notifications from the Symantec support site http://www.symantec.com/business/support and/or from Symantec Operations Readiness Tools (SORT) http://sort.symantec.com.


OTHERS
------
NONE