Symantec™ Dynamic Multi-Pathing 6.2 Release Notes - Solaris: November 2014
Symantec™ Dynamic Multi-Pathing 6.2 Release Notes - Solaris: November 2014
Symantec™ Dynamic Multi-Pathing 6.2 Release Notes - Solaris: November 2014
November 2014
Symantec™ Dynamic Multi-Pathing Release Notes
The software described in this book is furnished under a license agreement and may be used
only in accordance with the terms of the agreement.
Legal Notice
Copyright © 2014 Symantec Corporation. All rights reserved.
Symantec, the Symantec Logo, the Checkmark Logo, Veritas, Veritas Storage Foundation,
CommandCentral, NetBackup, Enterprise Vault, and LiveUpdate are trademarks or registered
trademarks of Symantec Corporation or its affiliates in the U.S. and other countries. Other
names may be trademarks of their respective owners.
The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Symantec
Corporation and its licensors, if any.
The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, "Rights in
Commercial Computer Software or Commercial Computer Software Documentation", as
applicable, and any successor regulations, whether delivered by Symantec as on premises
or hosted services. Any use, modification, reproduction release, performance, display or
disclosure of the Licensed Software and Documentation by the U.S. Government shall be
solely in accordance with the terms of this Agreement.
Symantec Corporation
350 Ellis Street
Mountain View, CA 94043
http://www.symantec.com
Technical Support
Symantec Technical Support maintains support centers globally. Technical Support’s
primary role is to respond to specific queries about product features and functionality.
The Technical Support group also creates content for our online Knowledge Base.
The Technical Support group works collaboratively with the other functional areas
within Symantec to answer your questions in a timely fashion. For example, the
Technical Support group works with Product Engineering and Symantec Security
Response to provide alerting services and virus definition updates.
Symantec’s support offerings include the following:
■ A range of support options that give you the flexibility to select the right amount
of service for any size organization
■ Telephone and/or Web-based support that provides rapid response and
up-to-the-minute information
■ Upgrade assurance that delivers software upgrades
■ Global support purchased on a regional business hours or 24 hours a day, 7
days a week basis
■ Premium service offerings that include Account Management Services
For information about Symantec’s support offerings, you can visit our website at
the following URL:
www.symantec.com/business/support/index.jsp
All support services will be delivered in accordance with your support agreement
and the then-current enterprise technical support policy.
Customer service
Customer service information is available at the following URL:
www.symantec.com/business/support/
Customer Service is available to assist with non-technical questions, such as the
following types of issues:
■ Questions regarding product licensing or serialization
■ Product registration updates, such as address or name changes
■ General product information (features, language availability, local dealers)
■ Latest information about product updates and upgrades
■ Information about upgrade assurance and support contracts
■ Information about the Symantec Buying Programs
■ Advice about Symantec's technical support options
■ Nontechnical presales questions
■ Issues that are related to CD-ROMs or manuals
Documentation
Product guides are available on the media in PDF format. Make sure that you are
using the current version of the documentation. The document version appears on
page 2 of each guide. The latest product documentation is available on the Symantec
website.
https://sort.symantec.com/documents
Your feedback on product documentation is important to us. Send suggestions for
improvements and reports on errors or omissions. Include the title and document
version (located on the second page), and chapter and section titles of the text on
which you are reporting. Send feedback to:
doc_feedback@symantec.com
For information regarding the latest HOWTO articles, documentation updates, or
to ask a question regarding product documentation, visit the Storage and Clustering
Documentation forum on Symantec Connect.
https://www-secure.symantec.com/connect/storage-management/
forums/storage-and-clustering-documentation
■ System requirements
■ Fixed issues
■ Known issues
■ Software limitations
■ Documentation
This is "Document version: 6.2 Rev 1" of the Symantec Dynamic Multi-Pathing
Release Notes. Before you start, make sure that you are using the latest version
of this guide. The latest product documentation is available on the Symantec Web
site at:
https://sort.symantec.com/documents
Prepare for your next ■ List product installation and upgrade requirements, including
installation or upgrade operating system versions, memory, disk space, and
architecture.
■ Analyze systems to determine if they are ready to install or
upgrade Symantec products and generate an Installation and
Upgrade custom report.
■ List patches by product or platform, and in the order they need
to be installed. Display and download the most recent patches
or historical patches.
■ Display Array Support Library (ASL) details by vendor, platform,
or Storage Foundation and High Availability (SFHA) version.
ASLs make it easier to manage arrays that are connected to
SFHA-based servers.
■ List VCS and ApplicationHA agents, documentation, and
downloads based on the agent type, application, and platform.
Identify risks and get ■ Analyze your servers for potential environmental risks.
server-specific Generate a Risk Assessment custom report with specific
recommendations recommendations about system availability, storage use,
performance, and best practices.
■ Display descriptions and solutions for thousands of Symantec
error codes.
Note: Certain features of SORT are not available for all products. Access to SORT
is available at no extra cost.
Note: Before you install or upgrade SFHA Solutions products, review the current
compatibility lists to confirm the compatibility of your hardware and software.
# https_proxy=http://proxy_server:port
# export https_proxy
# ftp_proxy=http://proxy_server:port
# export ftp_proxy
Feature Description
Define or modify Install Define or modify Install Bundles and save them using the
Bundles Deployment Server.
Create Install Templates Discover installed components on a running system that you want
to replicate on to new systems.
Connecting the Use a proxy server, a server that acts as an intermediary for
Deployment Server to requests from clients, for connecting the Deployment Server to
SORT using a proxy the Symantec Operations Readiness Tools (SORT) website.
server
Platform Filtering In Set Preference menu, choose Selected Platforms to filter the
platforms that are currently being used in the deployment
environment.
Dynamic Multi-Pathing Release Notes 12
Changes introduced in 6.2
Note: The Deployment Server is available only for the script-based installer, not the
web-based installer.
Pre 6.0.1 6.0.x, 6.1, 6.1.x 6.2 and Status Available from
forward
Official patch releases are available from SORT. This release was previously referred
to as a P-Patch or a Public hot fix and is now referred to as a Patch. Unofficial patch
releases are available from customer support. Hot fix is the only unofficial patch
release.
Dynamic Multi-Pathing Release Notes 13
System requirements
System requirements
This section describes the system requirements for this release.
The version of the Oracle Solaris operating system (OS) that runs on a guest domain
is independent of the Oracle Solaris OS version that runs on the primary domain.
Therefore, if you run the Oracle Solaris 10 OS in the primary domain, you can still
run the Oracle Solaris 11 OS in a guest domain. Likewise if you run the Oracle
Solaris 11 OS in the primary domain, you can still run the Oracle Solaris 10 OS in
a guest domain.
The only difference between running the Oracle Solaris 10 OS or the Oracle Solaris
11 OS on the primary domain is the feature difference in each OS.
Fixed issues
This section covers the incidents that are fixed in this release.
Incident Description
3325954 On Solaris 10 xprtld will not be started if user use jumpstart to install
product
3326196 Rolling upgrade may encounter a problem if open volumes from different
disk groups have the same name.
3442070 If you select rolling upgrade task from the Install Bundles menu, the
Installer exits with an error.
Incident Description
3544980 vxconfigd V-5-1-7920 di_init() failed message after SAN tape online event.
Dynamic Multi-Pathing Release Notes 15
Known issues
Incident Description
3526500 DMP I/O getting timeout lot earlier than 300 seconds if I/O statistics daemon
is not running.
3502923 ESX panic while running add/remove devices from smartpool with no license
installed on server.
Known issues
This section covers the known issues in this release.
Workaround: To perform Live Upgrade to Solaris 10 Update 11, use one of the
following procedures for your operating system version.
To perform Live Upgrade from Solaris 10 Update 10 to Solaris 10 Update 11
1 Install the Solaris 10 Update 10 LU packages (SUNWlucfg, SUNWlur,
SUNWluu) instead of the Solaris 10 Update 11 LU packages.
2 Use vxlustart to upgrade to Solaris 10 Update 11.
To perform Live Upgrade from Solaris 10 Update 9 or below to Solaris 10 Update
11
1 Install the Solaris 10 Update 10 LU packages (SUNWlucfg, SUNWlur,
SUNWluu) instead of the Solaris 10 Update 11 LU packages.
2 Use vxlustart to upgrade to Solaris 10 Update 11.
To perform Live Upgrade from Solaris 9 to Solaris 10 Update 11
1 Install the Solaris 10 Update 10 LU packages (SUNWlucfg, SUNWlur,
SUNWluu) instead of the Solaris 10 Update 11 LU packages.
2 Install the patch 121430-72. (Do NOT patch to a higher version of 121430,
such as 121430-92.)
3 Use vxlustart to upgrade to Solaris 10 Update 11.
pkg://Symantec/VRTSsfmh
ERROR
dir: var/opt/VRTSsfmh
Group: 'root (0)' should be 'other (1)'
dir: var/opt/VRTSsfmh/etc
Missing: directory does not exist
dir: var/opt/VRTSsfmh/logs
Group: 'root (0)' should be 'other (1)'
dir: var/opt/VRTSsfmh/tmp
Group: 'root (0)' should be 'other (1)'
file: opt/VRTSsfmh/web/operator/cgi-bin/firedrill.pl
Missing: regular file does not exist
Workaround:
■ Set the "Symantec" publisher repository pointing to VRTSpkgs.p5p.
Workaround: This message can be ignored. The vxlicinst, vxlicrep, vxlictest utilities
are present in /opt/VRTSvlic/sbin/ inside a non-global zone.
29794 Killed
Fixing zonepaths in ABE.
Unmounting ABE <dest.24429>.
100% of filenames transferredReverting state of zones in PBE
<source.24429>.
ERROR: Unable to copy file systems from boot environment <source.24429>
to BE <dest.24429>.
ERROR: Unable to populate file systems on boot environment <dest.24429>.
Removing incomplete BE <dest.24429>.
ERROR: Cannot make file systems for boot environment <dest.24429>.
The issue may be observed on any one or all the nodes in the sub-cluster.
Dynamic Multi-Pathing Release Notes 19
Known issues
ERROR: Installation of the packages from this media of the media failed;
pfinstall returned these diagnostics:
Processing default locales
- Specifying default locale (en_US.ISO8859-1)
Processing profile
ERROR: This slice can't be upgraded because of missing usr packages for
the following zones:
ERROR: zone1
ERROR: zone1
ERROR: This slice cannot be upgraded because of missing usr packages for
one or more zones.
The Solaris upgrade of the boot environment <dest.27152> failed.
Web installer does not ask for authentication after the first
session if the browser is still open (2509330)
If you install or configure DMP and then close the Web installer, if you have other
browser windows open, the Web installer does not ask for authentication in the
subsequent sessions. Since there is no option to log out of the Web installer, the
session remains open as long as the browser is open on the system.
Workaround: Make sure that all browser windows are closed to end the browser
session and subsequently log in again.
# vxlufinish
2 Manually delete the entries of all the volumes of shared disks that are mounted
as CFS in the /altroot.5.10/etc/vfstab directory. Enter:
rm -rf /altroot.5.10/etc/vfstab
Workaround: To perform Live Upgrade to Solaris 10 Update 11, use one of the
following procedures for your operating system version.
To perform Live Upgrade from Solaris 10 Update 10 to Solaris 10 Update 11
1 Install the Solaris 10 Update 10 LU packages (SUNWlucfg, SUNWlur,
SUNWluu) instead of the Solaris 10 Update 11 LU packages.
2 Use vxlustart to upgrade to Solaris 10 Update 11.
To perform Live Upgrade from Solaris 10 Update 9 or below to Solaris 10 Update
11
1 Install the Solaris 10 Update 10 LU packages (SUNWlucfg, SUNWlur,
SUNWluu) instead of the Solaris 10 Update 11 LU packages.
2 Use vxlustart to upgrade to Solaris 10 Update 11.
To perform Live Upgrade from Solaris 9 to Solaris 10 Update 11
1 Install the Solaris 10 Update 10 LU packages (SUNWlucfg, SUNWlur,
SUNWluu) instead of the Solaris 10 Update 11 LU packages.
2 Install the patch 121430-72. (Do NOT patch to a higher version of 121430,
such as 121430-92.)
3 Use vxlustart to upgrade to Solaris 10 Update 11.
For Solaris 11.1 or later, the system can panic when system is
rebooted after turning dmp_native_support to on (3341674)
For Solaris 11.1 or later when more than 512 LUNs are configured, the system can
panic when the system is rebooted after setting the tunable parameter
dmp_native_support to on.
Workaround:
For Solaris 11.1 or later, DMP native support for ZFS is restricted to set-ups with
no more than 512 LUNs.
Workaround:
Import the zpool using the following command, specifying the DMP device directory:
This error may occur even if the device size is greater than the required minimum
size.
Dynamic Multi-Pathing Release Notes 23
Known issues
Workaround:
To resolve this issue, use one of the following commands:
■ # vxdisk scandisks
■ # format -e dmp_device
This issue is an Oracle issue with zpool. This issue occurs whether DMP is
controlling the devices or not. That is, whether the dmp_native_support tunable is
on or off.
boot device corresponds to the first configured path during SAN boot. Even if another
primary path is configured as a boot device, suppressing the first device from VxVM
causes the boot to fail.
Workaround:
When the boot device is suppressed from VxVM, change the OS boot device
sequencing accordingly.
For Solaris SPARC system, use the eeprom boot-device command to set the
boot device sequencing.
TagmaStore-USP Hitachi_USP
TagmaStore-NSC Hitachi_NSC
TagmaStoreUSPV Hitachi_USP-V
TagmaStoreUSPVM Hitachi_USP-VM
Hitachi AMS2300 Series arrays New array names are based on the Model Number
8x. For example, AMS_100, AMS_2100,
AMS_2300, AMS_2500, etc.
In addition, the Array Support Library (ASL) for the enclosures XIV and 3PAR now
converts the cabinet serial number that is reported from Hex to Decimal, to
correspond with the value shown on the GUI. Because the cabinet serial number
has changed, any enclosure attribute set for these arrays may be reset to the default
value after an upgrade to VxVM 6.2. Manually reconfigure the enclosure attributes
to resolve the issue.
Dynamic Multi-Pathing Release Notes 25
Known issues
The cabinet serial numbers are changed for the following enclosures:
■ IBM XIV Series arrays
■ 3PAR arrays
# rm /etc/vx/darecs
ZFS pool creation on a DMP device fails when the LUN size is
between 1 TB and 2TB (2010919)
Creating a ZFS pool on a DMP device using the whole disk of size > 1TB and <
2TB that contains a SMI SUN label fails. The issue is that zpool create on a whole
disk changes the device label from SMI to EFI. This causes confusion between the
Dynamic Multi-Pathing Release Notes 26
Known issues
OS device paths of the same DMP device due to a bug in the Sun SCSI layer. This
is due to SUN BugID: 6912703.
After system reboot, the PowerPath device still shows as a DMP device, although
the device is managed by EMC PowerPath.
Workaround:
This issue is seen only during the first bootup discovery after reboot. To resolve
the issue, manually trigger DMP device discovery:
# vxdisk scandisks
For Solaris 11.1 or later, after enabling DMP native support for ZFS,
only the current boot environment is bootable (3157394)
After enabling DMP native support for ZFS on Solaris 11.1 or later, only the current
boot environment (BE) is bootable. Any alternate BEs in the same root pool are not
bootable. This situation occurs because the DMP native support configures the
ZFS root pool so that only DMP can import the root pool. If you attempt to boot the
system from the alternate BE, the system panics with the following message:
Workaround:
Dynamic Multi-Pathing Release Notes 27
Known issues
To enable booting from another BE, configure the ZFS root pool so that it can be
imported without DMP.
To configure ZFS root pool to enable booting from all the BEs
1 At the OBP PROM, run the following command to list all the BEs:
ok> boot -L
2 Use the following command to boot from the BE for which DMP native support
for ZFS is enabled.
3 After booting through new BE, disable the DMP native support using the
following command:
The system is now bootable from any BEs in the ZFS root pool.
fp_offline_ticker=15
fcp_offline_dely=10
For Solaris 11.1 or later, system hangs when both QLogic and Emulex
HBAs are present and dmp_native_support is turned on (3138703)
For Solaris 11.1 or later, the system may hang when both QLogic and Emulex HBAs
are present, and dmp_native_support is turned on.
Workaround:
The system hang is not seen if all of the HBAs are either from Emulex or from
QLogic. Do not combine both HBAs on the same system.
For Solaris 11.1 or later, enabling DMP native support requires steps
to enable booting from alternate root pools (3133514)
For Solaris 11.1 or later, if the tunable parameter dmp_native_support is set to on,
using the following command causes alternate root pools on OS devices to migrate
to DMP devices:
After the above command is run, the system cannot boot using these alternate root
pools because the DMP driver is not configured for these root pools. This scenario
is shown by the following output.
# zpool status
pool: crpool
state: ONLINE
scan: none requested
config:
crpool ONLINE 0 0 0
/dev/vx/dmp/disk_0s0 ONLINE 0 0 0
Workaround:
To boot using the alternate root pools, export and re-import the root pools using
the OS device.
To boot using the alternate root pools
1 Export the root pool:
pool: crpool
state: UNAVAIL
status: One or more devices are unavailable in response to persistent
errors. There are insufficient replicas for the pool to continue
functioning.
action: Destroy and re-create the pool from a backup source. Manually
marking the device repaired using 'zpool clear' or 'fmadm repaired'
may allow some data to be recovered.
Run 'zpool status -v' to see device specific details.
Dynamic Multi-Pathing Release Notes 30
Known issues
The tunable parameter dmp_native_support only unconfigures DMP for the single
root pool containing the active boot environment. If the setup has any alternate root
pools, for which DMP native support was enabled, then the alternate root pools
continue to show the DMP device. If the alternate root pool is configured in the
current boot environment and DMP support is removed, the DMP devices required
for ZFS are not found. The DMP devices and the root pools display the state as
"UNAVAIL".
Workaround:
Even though the status of alternate root pool is "UNAVAIL", the system is bootable
using the disk containing the alternate root pool. Reboot the system with the disk
containing the alternate root pool. The system comes up with the root pool using
the DMP device.
The DMP EMC CLARiiON ASL does not recognize mirror view not
ready LUNs (3272940)
On hosts that have EMC CLARiiON mirror view not ready LUNs, if you enable or
disable the switch port and then issue the vxdisk scandisks or vxdctl enable
command, I/O error messages are written continuously in the syslog.
The dynamic multi-pathing (DMP) request for providing information to identify mirror
view not ready LUNs through in-band SCSI command is pending with EMC
engineering. Not ready LUNs are special kind of LUNs which reject all kinds of I/O
requests.
Because DMP does not recognize not ready LUNs, Veritas Volume Manager (VxVM)
tries to bring them online. As part of the online process, VxVM issues I/Os to read
the disk private region. These I/Os fail and generate error messages in syslog.
Because of events that are generated as part of the online process, the vxattachd
script triggers the vxdisk scandisks command again. This cycle causes continuous
I/O error messages. This problem can also cause other commands to run slowly
because the VxVM configuration daemon (vxconfigd) is busy servicing vxdisk
scandisks.
Workaround: Stop the vxattachd script and set EMC CLARiiON values, as follows:
Dynamic Multi-Pathing Release Notes 31
Software limitations
■ retrycount=5
Enter:
Software limitations
This section covers the software limitations of this release.
See the corresponding Release Notes for a complete list of software limitations
related to that component or product.
See “Documentation” on page 33.
Dynamic Multi-Pathing Release Notes 32
Software limitations
DMP does not support devices in the same enclosure that are
configured in different modes (2643506)
DMP does not support the configuration where two devices in the same enclosure
are configured in different modes. For example, if one device is configured as ALUA
and another one is configured as Active/Passive (A/P).
Documentation
Product guides are available in the PDF format on the software media in the
/docs/product_name directory. Additional documentation is available online.
Make sure that you are using the current version of documentation. The document
version appears on page 2 of each guide. The publication date appears on the title
page of each document. The latest product documentation is available on the
Symantec website.
http://sort.symantec.com/documents
Documentation set
Each product in the Storage Foundation and High Availability Solutions product line
includes release notes, an installation guide, and additional documents such as
administration and agent guides. In most cases, you may also need to refer to the
documentation for the product's components.
The SFHA Solutions documents describe functionality and solutions that apply
across the product line. These documents are relevant whichever SFHA Solutions
product you use.
Dynamic Multi-Pathing Release Notes 34
Documentation
Note: The GNOME PDF Viewer is unable to view Symantec documentation. You
must use Adobe Acrobat to view the documentation.
Veritas Operations Manager (VOM) is a management tool that you can use to
manage Symantec Storage Foundation and High Availability Solutions products. If
you use VOM, refer to the VOM product documentation at:
https://sort.symantec.com/documents
Manual pages
The manual pages for Symantec Storage Foundation and High Availability Solutions
products are installed in the /opt/VRTS/man directory.
Set the MANPATH environment variable so the man(1) command can point to the
Symantec Storage Foundation manual pages:
■ For the Bourne or Korn shell (sh or ksh), enter the following commands:
MANPATH=$MANPATH:/opt/VRTS/man
export MANPATH
The latest manual pages are available online in HTML format on the Symantec
website at:
https://sort.symantec.com/documents