* * * READ ME * * * * * * Symantec Storage Foundation HA 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 HA 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 HA 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 * 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 * 3622272 (3622271) When you import a cluster disk group with a large number of LUNs and volumes, the server stops responding. * 3483164 (3483164) In a cluster configured to use single sign-on authentication (secure cluster), the application service group configuration wizards fail with a "CmdServer service not running on system:nodename" error. * 3501681 (3501674) High Availability (HA) commands take time to execute in a secure cluster. * 3590862 (3572840) The VxExplorer and the hagetcf utility fails to collect the GAB/LLT logs. 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 * 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 * 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 * 3483164 (Tracking ID: 3483164) SYMPTOM: In a cluster configured to use single sign-on authentication (secure cluster), the application service group configuration wizards fail with a "CmdServer service not running on system:nodename" error. DESCRIPTION: If a cluster is configured to use single sign-on authentication (secure cluster), then the application service group configuration wizards fail to connect to the remote cluster nodes with the following error: "CmdServer service not running on system:nodename" This error is displayed even though the VCS Command Server service is running on all the nodes. The wizard displays the error on the System Selection panel. The issue occurs because the remote node IP address used for its authentication is not reachable. RESOLUTION: This hotfix enhances the wizard behaviour. If the IP address of the remote cluster node is not reachable, then the wizard uses the hostname to connect to the nodes. To resolve the issue, 1) Exit the service group configuration wizard 2) Install the hotfix 3) Run the service group configuration wizard again Binary File / Version: WizCmdClient.dll / 6.1.1.283 * 3501681 (Tracking ID: 3501674) SYMPTOM: High Availability (HA) commands take long time to execute in a secure cluster. DESCRIPTION: Executing HA commands may take approx 5 to 7 seconds in case when PDC is located in different geographical location. This happens because DC related APIs take long time to get completed, when they are invoked from AT for creating AT credentials. RESOLUTION: This issue is fixed wherein time consuming AT APIs are only invoked first time when they are executed. For subsequent execution of HA command, cached credentials are used. To resolve the issue, 1) Install the hotfix 2) Run HA command to see the result. For example: hagrp -list. Binary File / Version: haagent.exe / 6.1.3.289 haalert.exe / 6.1.3.289 haattr.exe / 6.1.3.289 hacli.exe / 6.1.3.289 haclus.exe / 6.1.3.289 haconf.exe / 6.1.3.289 hadebug.exe / 6.1.3.289 hagrp.exe / 6.1.3.289 hahb.exe / 6.1.3.289 halog.exe / 6.1.3.289 hanotify.exe / 6.1.3.289 hareg.exe / 6.1.3.289 hares.exe / 6.1.3.289 hastatus.exe / 6.1.3.289 hastop.exe / 6.1.3.289 hasys.exe / 6.1.3.289 hatype.exe / 6.1.3.289 hauser.exe / 6.1.3.289 * 3590862 (Tracking ID: 3572840) SYMPTOM: The VxExplorer and the hagetcf utility fails to collect the GAB/LLT logs in the following two scenarios: - The product is installed at a location other than the C: drive - The product is installed at a location on C: but the Windows option to generate the file names in 8dot3 format is disabled DESCRIPTION: During the product installation, by default, the installer installs the product package at the following location: C:\program files\Veritas Instead of this default location if you choose to install the package at a custom location (other than the c: drive) or if you disable (on the C: drive) the Windows option to generate 8dot3 format file names, then the VxExplorer and the hagetcf utility fails to collect the GAB/LLT logs. This issue occurs because the VxExplorer and the hagetcf utility uses the 8dot3 format files names (instead of the actual installation path) to collect the logs. When the product is installed at a location on C: drive, the VxExplorer or the hagetcf utility can access the files using the 8dot3 format file names. However, if the product is installed at a location other than the C: drive or if the Windows option to generate the file names in 8dot3 format is disabled on C: drive, then the VxExplorer and the hagetcf utility fails to access the files and to collect the logs. RESOLUTION: The behavior of VxExplorer and the hagetcf utility is modified through this hotfix. The VxExplorer or the hagetcf utility now uses the complete installation path to collect the logs. Note: The hotfix installer replaces the getcomms.pl file at the following location: "%vcs_home%\bin\" You must copy this file and replace its instance in the VxExplorer folder. FILE / VERSION: getcomms.pl 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_00004_445_3525531 - Hotfix_6_1_00006_445_3547461 - Hotfix_6_1_00007_445_3558216 - Hotfix_6_1_00008_445_3568040 - Hotfix_6_1_00011_445_3622272 - Hotfix_6_1_00001_3483164 - Hotfix_6_1_00003_3501681 - Hotfix_6_1_00008_3590862 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. [5] Before installing CP, ensure that the Startup type of the VCS Authentication Service is set to Automatic. This is applicable only if you have configured a secure cluster. 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_SFWHA_61_W2K12_x64.exe, specify it as CP1_SFWHA_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 examples ---------------------------------: [+] Install CP in silent mode, restart automatically: vxhfbatchinstaller.exe /CP:CP1_SFWHA_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