* * * READ ME * * * * * * Symantec Storage Foundation 6.1 * * * * * * Patch 6.1.0.100 * * * Patch Date: 2014-10-06 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 ---------- Symantec Storage Foundation 6.1 Patch 6.1.0.100 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- Windows Server 2008 R2 X64 Windows 2012 X64 Windows Server 2012 R2 X64 BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * Symantec Storage Foundation 6.1 SUMMARY OF INCIDENTS FIXED BY THE PATCH --------------------------------------- Patch ID: SFW CP1 * 3500210 (3497449) Cluster disk group loses access to majority of its disks due to a SCSI error. * 3329771 (3511276) While creating a virtual machine, storage warnings occur and dependency is not created on Symantec storage class resources. * 3525531 (3525528) VxSVC crashes with heap corruption if paging file is disabled. * 3547461 (3547460) The Add Disk to Dynamic Disk Group wizard stops responding on the second panel if the wizard is launched from a disk without sufficient free space. * 3558216 (3456746) VxSvc services crashes with heap corruption in VRAS.dll * 3568040 (3568039) VDID module fails to generate Unique Disk ID for the Fujitsu ETERNUS array LUNs * 3592939 (3594163) Failover Cluster Manager does not display volume information for SFW resources and crashes while accessing the Shadow Copies tab for a resource * 3622272 (3622271) When you import a cluster disk group with a large number of LUNs and volumes, the server stops responding. DETAILS OF INCIDENTS FIXED BY THE PATCH --------------------------------------- This patch fixes the following Symantec incidents: Patch ID: SFW CP1 * 3500210 (Tracking ID: 3497449) SYMPTOM: Cluster disk group loses access to majority of its disks due to a SCSI error. DESCRIPTION: This issue occurs while processing a request to renew or query the SCSI reservation on a disk belonging to a cluster disk group. Because of the following error in the SCSI command, the operation fails: Unit Attention - inquiry parameters changed (6/3F/03) Because of this, the cluster disk group loses access to majority of its disks. RESOLUTION: This issue has been resolved by retrying the SCSI reservation renew or query request. File Name / Version: vxio.sys / 6.1.00001.445 * 3329771 (Tracking ID: 3511276) SYMPTOM: While creating a virtual machine, storage warnings occur and dependency is not created on Symantec storage class resources. DESCRIPTION: This issue occurs while creating a virtual machine in a Microsoft Failover Clustering environment. If the underlying volumes are managed by the VMDg or Volume Manager Shared Volume resources, the wizard shows following warning message: Disk path 'path' is not a path to storage in the cluster or to storage that can be added to the cluster. You must ensure this storage is available to every node in the cluster to make this virtual machine highly available. The wizard also does not create a resource dependency on the VMDg or Volume Manager Shared Volume resources. Moreover, on Windows Server 2008 R2 operating systems, when you refresh the virtual machine configuration, it displays a warning message and deletes any resource dependencies that you may have created manually. The issue occurs because the Microsoft code for this operation was limited to a physical disk resource. Also, after fixing the Microsoft code, it was found that the VMDg and Volume Manager Shared Volume resource types were unable to handle a few control codes. RESOLUTION: This issue has been resolved by implementing the required control codes in the VMDg and Volume Manager Shared Volume resource types. In case of VMDg, the control code returns disk signature for the first subdisk of the first volume in the disk group. File Name / Version: vxres.dll / 6.1.00003.445 vxvolres.dll / 6.1.00003.445 cluscmd.dll / 6.1.00003.445 * 3525531 (Tracking ID: 3525528) SYMPTOM: VxSVC crashes with heap corruption if paging file is disabled. DESCRIPTION: This issue occurs if the Windows paging file is disabled, because of which the Veritas Enterprise Administrator (VxSVC) service crashes causing heap corruption while loading the mount provider. This happens because the provider variable initialization was not done properly. RESOLUTION: This issue has been resolved by initializing the provider variable properly. NOTE: Additional information has been added to the hotfix installation instructions. Follow them to resolve the issue completely. File Name / Version: mount.dll / 6.1.00004.445 * 3547461 (Tracking ID: 3547460) SYMPTOM: The Add Disk to Dynamic Disk Group wizard stops responding on the second panel if the wizard is launched from a disk without sufficient free space. DESCRIPTION: This issue occurs when you launch the Add Disk to Dynamic Disk Group wizard from a disk that does not have sufficient free space. When you click "Next" on the second panel of the wizard, it gives a null pointer exception. Therefore, you cannot proceed to the next panel and the wizard needs to be closed. RESOLUTION: This issue has been fixed by modifying the code to handle null check so that now the wizard gives a proper error message instead of the null pointer exception. File Name / Version: VxVmCE.jar / N/A * 3558216 (Tracking ID: 3456746) SYMPTOM: VxSvc service crashes with heap corruption in VRAS.dll DESCRIPTION: VRAS decided to discard a malformed packet it received, since the size of the packet was too large. It encountered an issue while freeing the IpmHandle pointer and crashed eventually. RESOLUTION: This hotfix resolves the crash which occurred during the handling of malformed packet. File Name / Version: vras.dll / 6.1.00007.445 * 3568040 (Tracking ID: 3568039) SYMPTOM: VDID module fails to generate Unique Disk ID for the Fujitsu ETERNUS array LUNs DESCRIPTION: This issue occurs during generic Veritas Disk ID (VDID) formation for Fujitsu ETERNUS array LUNs. During this, the SFWVDID module incorrectly claims wrong descriptor ID and fails to generate Unique Disk ID for the array LUNs. RESOLUTION: This issue has been fixed as part of the SFWVDID binary veritas.dll, which discovers VDID generically for the given LUNs. SFW now correctly discovers VDID generically for the Fujistu ETERNUS array LUNs. File Name / Version: veritas.dll / 6.1.00008.445 * 3592939 (Tracking ID: 3594163) SYMPTOM: Failover Cluster Manager does not display volume information for SFW resources and crashes while accessing the Shadow Copies tab for a resource DESCRIPTION: On Windows Server 2012 R2 operating systems, this issue occurs while trying to view volume information for two SFW resources in the Failover Cluster Manager snap-in. Failover Cluster Manager does not display the volume information for the Volume Manager Disk Group (VMDg) and cluster-shared disk group (CSDG) resources of SFW. Moreover, it crashes when you try to access the Shadow Copies tab for an SFW resource. This happens because the SFW resources did not have the CLUS_RESSUBCLASS_STORAGE_DISK flag, which is required by Failover Cluster Manager for fetching volume information. RESOLUTION: This issue has been resolved adding the CLUS_RESSUBCLASS_STORAGE_DISK flag to the two SFW resources so that Failover Cluster Manager now fetches and displays the volume information. File Name / Version: vxres.dll / 6.1.00010.445 vxvolres.dll / 6.1.00010.445 * 3622272 (Tracking ID: 3622271) SYMPTOM: When you import a cluster disk group with a large number of LUNs and volumes, the server stops responding. DESCRIPTION: When you import a cluster disk group with a large number of LUNs and volumes, it causes a deadlock between the Mount Manager and the vxio driver, due to which the Windows server on which SFW or SFW HA is installed, stops responding. RESOLUTION: This issue has been resolved by modifying the vxio driver. FILE / VERSION: vxio.sys / 6.1.00011.445 INSTALLING THE PATCH -------------------- What's new in this CP =====================| The following hotfixes have been added in this CP: - Hotfix_6_1_00001_445_3500210 - Hotfix_6_1_00003_445_3329771 - Hotfix_6_1_00004_445_3525531 - Hotfix_6_1_00006_445_3547461 - Hotfix_6_1_00007_445_3558216 - Hotfix_6_1_00008_445_3568040 - Hotfix_6_1_00010_445_3592939 - Hotfix_6_1_00011_445_3622272 For more information about these hotfixes, see the "FIXED_INCIDENTS" section in this Readme. Install instructions ====================| Download the appropriate cumulative public patch (CP) executable file to a temporary location on your system. Each cumulative public patch includes the individual hotfixes that contain enhancements and fixes related to reported issues. See the "FIXED_INCIDENTS" section for details. Before you begin ----------------: [1] Ensure that the logged-on user has privileges to install the CP on the systems. [2] One or more hotfixes that are included with this CP may require a reboot. Before proceeding with the installation ensure that the system can be rebooted. [3] Symantec recommends that you close the Cluster Manager (Java Console) and the Veritas Enterprise Administrator (VEA) Console before installing this CP. [4] Ensure that you close the Windows Event Viewer before proceeding with the installation. To install the CP in the silent mode -----------------------------------: Perform the following steps: [1] Double-click the CP executable file to start the CP installation. The installer performs the following tasks: - Extracts all the individual hotfix executable files The files are extracted at %commonprogramfiles(x86)%\Veritas Shared\WxRTPrivates\ - Runs the pre-install tasks - Installs all the hotfixes sequentially - Runs the post-install tasks The installation progress status is displayed in the command window. [2] After all the hotfixes are installed, the installer prompts you to restart the system. Type Y to restart the system immediately, or type N to restart the system later. You must restart the system for the changes to take effect. Note that the installer prompts for a system restart only if hotfixes that require a reboot are included in the CP and are installed. To install the CP using the command line ----------------------------------------: Use the VxHFBatchInstaller.exe utility to install a CP from the command line. The syntax options for this utility are as follows: vxhfbatchinstaller.exe /CP: [/PreInstallScript:] [/silent [/forcerestart]] where, - CPName is the cumulative patch executable file name without the platform, architecture, and .exe extension. For example, if CP executable name is CP1_SFW_61_W2K12_x64.exe, specify it as CP1_SFW_61. - PreInstallScript.pl is the Perl script that includes the pre-installation steps. These steps forcefully kill the required services and processes in case a graceful stop request does not succeed. Symantec recommends that you use this option and script only in case the CP installer fails repeatedly while performing the pre-installation tasks. - /silent indicates the installation is run in a non-verbose mode; the installer does not prompt for any inputs during the installation. - /forcerestart indicates that the system is automatically restarted, if required, after the installation is complete. Perform the following steps: [1] From the command prompt, navigate to the directory where the CP executable file is located and then run the file to extract the contents to a default location on the system. The installer displays a list of hotfixes that are included in the CP. - On 64-bit systems, the hotfixes executable files are extracted to: "%commonprogramfiles(x86)%\Veritas Shared\WxRTPrivates\" [2] In the same command window, run the following command to begin the CP installation in the silent mode: vxhfbatchinstaller.exe /CP: /silent For example, to install a SFW 6.1 CP for Windows Server 2012, the command is: vxhfbatchinstaller.exe /CP:CP1_SFW_61 /silent The installer performs the following tasks: - Extracts all the individual hotfix executable files The files are extracted at %commonprogramfiles(x86)%\Veritas Shared\WxRTPrivates\ - Runs the pre-install tasks - Installs all the hotfixes sequentially - Runs the post-install tasks The installation progress status is displayed in the command window. [3] After all the hotfixes are installed, the installer displays a message for restarting the system. You must restart the system for the changes to take effect. Note that the installer prompts for a system restart only if hotfixes that require a reboot are included in the CP and are installed. The installer automatically restarts the system if you had specified the /forcerestart option in step 2 earlier. VxHFBatchInstaller usage example ---------------------------------: [+] Install CP in silent mode, restart automatically: vxhfbatchinstaller.exe /CP:CP1_SFW_61 /silent /forcerestart Post-install steps ==================| The following section describes the steps that must be performed after installing the hotfixes included in this CP. Ensure that VIP_PATH environment variable is set to "C:\Program Files\Veritas\Veritas Object Bus\bin" and NOT to "C:\\Veritas Object Bus\bin". Assuming that C:\ is the default installation drive. Known issues ============| There are no known issues identified in this CP. -------------------------------------------------------+ REMOVING THE PATCH ------------------ NO SPECIAL INSTRUCTIONS -------------------- 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. Additional notes ================| [+] To confirm the list of cumulative patches installed on a system, run the following command from the directory where the CP files are extracted: vxhfbatchinstaller.exe /list The output of this command displays a list of cumulative patches and the hotfixes that are installed as part of a CP. This command also displays the hotfixes that are included in a CP but are not installed on the system. [+] To confirm the installation of the hotfixes, perform one of the following: - Run the following command: vxhf.exe /list The output of this command lists the hotfixes installed on the system. - In the Windows Add/Remove program, click "View installed updates" to view the list of the hotfixes installed on the system. [+] To confirm the latest cumulative patch installed on a system, run the following command from the directory where the CP files are extracted: vxhfbatchinstaller.exe /cplevel The output of this command displays the latest CP that is installed, the CP status, and a list of all hotfixes that were a part of the CP but not installed on the system. [+] The CP installer (vxhfbatchinstaller.exe) creates and stores logs at: "%allusersprofile%\Veritas\VxHF\VxHFBatchInstaller.txt" [+] The hotfix installer (vxhf.exe) creates and stores logs at: "%allusersprofile%\Veritas\VxHF\VxHF.txt" [+] For general information about the hotfix installer (vxhf.exe), please refer to the following technote: http://www.symantec.com/docs/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/docs/TECH73438 [+] For information on uninstalling a hotfix, please refer to the following technotes: http://www.symantec.com/docs/TECH225604 http://www.symantec.com/docs/TECH73443 [+] For general information about the CP, please refer to the following technote: http://www.symantec.com/docs/Tech225573 OTHERS ------ NONE