sfw-Hotfix_5_1_20024_87_2368399

 Basic information
Release type: Hot Fix
Release date: 2011-06-01
OS update support: None
Technote: TECH160393 - Volume shrink operation changes a volume state to "Healthy,RAW" and results in file system data corruption
Documentation: None
Popularity: 4588 viewed    downloaded
Download size: 35.56 MB
Checksum: 1471269950

 Applies to one or more of the following products:
Storage Foundation 5.1SP2 On Windows 32-bit
Storage Foundation 5.1SP2 On Windows IA64
Storage Foundation 5.1SP2 On Windows x64
Storage Foundation HA 5.1SP2 On Windows 32-bit
Storage Foundation HA 5.1SP2 On Windows IA64
Storage Foundation HA 5.1SP2 On Windows x64

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

 Fixes the following incidents:
2368399

 Patch ID:
None.

Readme file
Date: 2011-05-31
OS: Windows
OS Version: 2003, 2008
Packages: vxassist.exe, climessages.dll, vxvmce.jar, vmresourcebundle.en.jar
Etrack Incidents: 2368399

Errors/Problems Fixed
----------------------+ 
This hotfix addresses an issue where any failure while the volume shrink operation is in progress may cause file system corruption and data loss.

Overview
---------
The volume shrink operation allows you to decrease the size of dynamic volumes.
When you start the volume shrink operation, it begins to move used blocks so as to accommodate them within the specified target shrink size for the volume.

However, this operation is not transactional. If there are any issues encountered during block moves or if the operation is halted for any reason (for example, the host reboots or shuts down, the operating system goes in to a hung state, or a stop error occurs), it can result in a file system corruption and may cause data loss.
The state of the volume changes to 'Healthy, RAW'.

Resolution
-----------
With this hotfix, a warning message is displayed each time you initiate a volume shrink operation. The message recommends that you make a backup copy of the data on the target volume (the volume that you wish to shrink) before you perform the volume shrink operation.

Depending on how you initiate the volume shrink operation (either VEA or command line), you have to perform an additional step, as described below:

- If you initiate the volume shrink operation from the VEA console, click OK on the message prompt to proceed with the volume shrink operation.

- If you initiate the volume shrink operation from the command prompt, the command fails with the warning message. Run the command again with the force (-f) option.


Fixes Applied for Products
--------------------------+
Storage Foundation 5.1 SP2 for Windows
Storage Foundation and High Availability 5.1 SP2 for Windows


Install/Uninstall Instructions
------------------------------+
This package contains self-extracting files that are specific to the processor architecture and operating system version.
Choose the appropriate file for your computer's configuration.

=================================================================================
Operating System	Platform	File Name
=================================================================================
Windows Server 2003	IA64		Hotfix_5_1_20024_87_2368399_w2k3_ia64.exe	
			x64		Hotfix_5_1_20024_87_2368399_w2k3_x64.exe
			x86		Hotfix_5_1_20024_87_2368399_w2k3_x86.exe
---------------------------------------------------------------------------------
Windows Server 2008	IA64		Hotfix_5_1_20024_87_2368399_w2k8_ia64.exe	
		        x64		Hotfix_5_1_20024_87_2368399_w2k8_x64.exe
			x86		Hotfix_5_1_20024_87_2368399_w2k8_x86.exe
---------------------------------------------------------------------------------

Download the appropriate hotfix executable to a temporary location on your system.
You can install this hotfix using the GUI or from the command line. Instructions for both options are provided below.

Each self-extracting file includes the following updated file(s):

============================================================================
Filename                 | Version      |  Windows 2003   | Windows 2008   |
============================================================================
vxassist.exe             | 5.1.20024.87 |  x86, x64, ia64 | x86, x64, ia64 |
climessages.dll          | 5.1.20024.87 |  x86, x64, ia64 | x86, x64, ia64 |
vxvmce.jar               |              |  x86, x64, ia64 | x86, x64, ia64 |
vmresourcebundle.en.jar  |              |  x86, x64, ia64 | x86, x64, ia64 |
----------------------------------------------------------------------------


Before you begin
-----------------
[1] In case of Windows Server 2003, this hotfix requires Microsoft Core XML Services (MSXML) 6.0 pre-installed in your setup. Download and install MSXML 6.0 before installing the hotfix.

Refer to the following link for more information:
http://www.microsoft.com/downloads/details.aspx?FamilyId=993c0bcf-3bcf-4009-be21-27e85e1857b1&displaylang=en

Microsoft posted service pack and/or security updates for Core XML Services 6.0.
Please contact Microsoft or refer to Microsoft website to download and install latest updates to Core XML Services 6.0.

Refer to the following link for more information:
http://www.microsoft.com/downloads/details.aspx?FamilyId=70C92E77-9E5A-41B1-A9D2-64443913C976&displaylang=en

[2] This hotfix installation requires stopping the Storage Agent (vxvm) service which will cause the 'Volume Manager Disk Group' (VMDg) resources in a cluster environment (MSCS or VCS) to fault. If this hotfix is being applied to a server in a cluster, make sure any cluster groups 
containing a VMDg resource are taken offline or moved to another node in the cluster before proceeding with the installation.

[3] Symantec recommends that you close the Veritas Enterprise Administrator (VEA) Console before installing this hotfix.


To install the hotfix using the GUI
------------------------------------
1. Double click the hotfix executable file to extract the contents to a default location on the cluster node.
On 32-bit systems, the files are extracted to:
"%commonprogramfiles%\Veritas Shared\WxRTPrivates"

On 64-bit systems, the files are extracted to:
"%commonprogramfiles(x86)%\Veritas Shared\WxRTPrivates"

The Hotfix Installer Wizard is automatically launched after the files are extracted.

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

3. Click "Install Hotfix" to begin the hotfix installation. 
The status of each installation task is updated as it completes.

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

5. If prompted to restart the server, do so at this time.

6. If this is a clustered configuration (VCS or MSCS), please perform steps 1-5 on all additional nodes in the cluster.


To install the hotfix using the command line
---------------------------------------------
1. At the command prompt, run one of the following commands to extract the hotfix files to the default location:
C:\temp><Hotfix_BuildVersion_IncidentNumber_OS_Platform>.exe /x
or
C:\temp><Hotfix_BuildVersion_IncidentNumber_OS_Platform>.exe /extract

For example, to extract this hotfix on a 32-bit Windows 2003 system, the command is:
C:\temp>Hotfix_5_1_20024_87_2368399_w2k3_x86.exe /x

2. From the command prompt, navigate to the default location where the hotfix files are extracted.
On 32-bit systems, the files are extracted to:
"%commonprogramfiles%\Veritas Shared\WxRTPrivates\<Hotfix_BuildVersion_IncidentNumber>"

On 64-bit systems, the files are extracted to: 
"%commonprogramfiles(x86)%\Veritas Shared\WxRTPrivates\<Hotfix_BuildVersion_IncidentNumber>"

3. At the command prompt, run the following command to install the hotfix:
VxHF.exe /install:<Hotfix_BuildVersion_IncidentNumber> /silent

Here, <Hotfix_BuildVersion_IncidentNumber> is the name of the hotfix file excluding the OS, platform, and .exe extension.

For example, to install this hotfix on a 32-bit Windows 2003 system, the command is:
VxHF.exe /install:Hotfix_5_1_20024_87_2368399 /silent

Hotfix Executable Name is Hotfix_5_1_20024_87_2368399_w2k3_x86.exe.
When installing the hotfix, the <Hotfix_BuildVersion_IncidentNumber> name is Hotfix_5_1_20024_87_2368399.
(note how the "_w2k3_x86.exe" is excluded).

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

5. If prompted to restart the server, do so at this time.

6. If this is a clustered configuration (VCS or MSCS), please perform steps 1-5 on all additional nodes in the cluster.


Known issue
------------+
This issue is applicable only if you uninstall the hotfix.
If you perform the volume shrink operation from the VEA Console after removing this hotfix, VEA still displays the warning message. This occurs because the stale files residing in the VEA cache are not removed during the uninstallation.

Workaround
-----------
Perform the following steps after you have removed the hotfix.

1. Close the Veritas Enterprise Administrator (VEA) Console.

2. Stop the Veritas Storage Agent service.
Type the following at the command prompt:
net stop vxvm


3. Delete the Client extensions cache directories from the system: 
On Windows Server 2003, delete the following:
	- %allusersprofile%\Application Data\Veritas\VRTSbus\cedownloads
	- %allusersprofile%\Application Data\Veritas\VRTSbus\Temp\extensions

On Windows Server 2008, delete the following:
	- %allusersprofile%\Veritas\VRTSbus\Temp\extensions
	- %allusersprofile%\Veritas\VRTSbus\cedownloads

4. Start the Veritas Storage Agent service.
Type the following at the command prompt:
net start vxvm

5. Repeat steps 1 to 4 on all the systems where you have uninstalled this hotfix.

6. Launch VEA to perform the volume shrink operation.


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 Data\Veritas\VxHF"

- 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


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.