VERITAS Storage Foundation 4.1 Release Notes HP-UX 11i v2 Manufacturing Part Number: 5991-1291 September 2005 Edition 1 Printed in the United States © Copyright 2005 - 2006 Hewlett-Packard Development Company L.P.
Legal Notices Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
Contents Storage Foundation Product Suites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Product and Feature Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 VERITAS Volume Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 VERITAS File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VERITAS Volume Manager Software Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 VERITAS File System Software Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 No Longer Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Available Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VERITAS Storage Foundation Release Notes This document provides release information about the products in the VERITAS Storage Foundation 4.1 HP-UX product suite: ◆ VERITAS Storage Foundation (Standard, Standard HA, Enterprise, and Enterprise HA) ◆ VERITAS Volume Manager (VxVM) ◆ VERITAS File System (VxFS) ◆ VERITAS Storage Foundation for Oracle (Standard, Enterprise, and HA Editions), formerly known as VERITAS Database Edition for Oracle. Each of these products is activated by a single license key.
Storage Foundation Product Suites Storage Foundation Product Suites The following table lists the VERITAS products and optionally licensed features available with each Storage Foundation product suite.
Storage Foundation Product Suites Storage Foundation Version Products and Features Storage Foundation for Oracle Enterprise VERITAS Storage Foundation for Oracle VERITAS Volume Manager VERITAS File System VERITAS FlashSnap Option VERITAS Quick I/O Option VERITAS Extension for Oracle Disk Manager Option VERITAS Storage Checkpoint Option VERITAS Storage Mapping Option Optionally licensed features: VERITAS Volume Replicator Option Storage Foundation for Oracle Enterprise HA VERITAS Storage Foundation for
Product and Feature Descriptions Product and Feature Descriptions The following are brief descriptions of the various products and features that are part of VERITAS Storage Foundation: ◆ VERITAS Volume Manager ◆ VERITAS File System ◆ VERITAS Storage Foundation for Oracle ◆ VERITAS Volume Replicator ◆ VERITAS Cluster Server VERITAS Volume Manager VERITAS Volume Manager is a storage management tool that removes the physical limitations of disk storage so that you can configure, share, manage, and o
Product and Feature Descriptions Using Cluster File Systems VERITAS Storage Foundation Cluster File System (SFCFS) is the file system clustering functionality of VxFS. SFCFS is a separately licensable feature of VxFS that requires several other VERITAS products to enable communication services and provide shared disk storage resources. VERITAS Cluster Server and VERITAS Volume Manager are packaged with VxFS to provide a complete clustering environment.
Product and Feature Descriptions VERITAS Storage Checkpoint Option VERITAS Storage Checkpoint technology lets you create a point-in-time image of a file system or a database. Storage Checkpoints are treated like any other VxFS file system and can be created, mounted, unmounted, and removed. This option is available with the Enterprise versions of VERITAS Storage Foundation for Oracle.
New and Enhanced Features New and Enhanced Features The following new features and enhancements have been incorporated into VERITAS Storage Foundation, VERITAS Volume Manager (VxVM), VERITAS File System (VxFS), and VERITAS Storage Foundation for Oracle. Note For information about new features in VVR, see the VERITAS Volume Replicator Release Notes. For information about new features in VCS, see the VERITAS Cluster Server Release Notes.
New and Enhanced Features ◆ DMP supports the B_FAILFAST flag if the underlying device driver exports the ddi-failfast-supported property. The B_FAILFAST flag allows the disk drivers to avoid heroic, time-consuming retry behavior when it is not required or is inappropriate. The B_FAILFAST flag is intended to allow modified error recovery behavior in the disk driver when no communication can be established with the device.
New and Enhanced Features For operations that require a disk group, the system-wide default disk group will be used if the VxVM command is not specified with the -g option. The main benefit of creating a default disk group is that the VxVM commands default to the default disk group and you will not need to use the -g option.
New and Enhanced Features With the introduction of the CDS, the format for a disk defaults to CDS rather than to simple, which was the format in earlier releases. In addition, the simple disk format has been renamed as hpdisk. For instructions on converting from a CDS format disk to a hpdisk format disk, see the “Creating and Administering Disk Groups” chapter in the VERITAS Volume Manager Administrator’s Guide.
New and Enhanced Features Online Node Addition VxVM now allows you to add a node to a cluster dynamically. Dynamic LUN Expansion Previous releases of VxVM did not allow you to take advantage of a change in the size of a disk once the disk had been initialized; any attempt to do so would result in loss of data. In this release, Dynamic LUN Expansion (DLE) allows you to resize a virtual disk device while preserving the existing data.
New and Enhanced Features VxVM 4.1 Licenses The following table shows the levels of licensing in VERITAS Volume Manager 4.1 and the features supported at each level: VxVM License Description of Supported Features Base Concatenation, spanning, rootability and root disk mirroring, multiple disk groups and VERITAS Enterprise Administrator (VEA).
New and Enhanced Features The CDS feature is also referred to as Portable Data Containers. Note To use the CDS feature, a VxFS license is required that enables CDS. Multi-Volume Support The Multi-Volume Support (MVS) feature allows several volumes to be represented by a single logical object. All I/O to and from an underlying logical volume is directed by way of volume sets. This feature can be used only in conjunction with VERITAS Volume Manager.
New and Enhanced Features Quality of Storage Service The Quality of Storage Service (QoSS) option is built on the multi-volume support technology introduced in this release. Using QoSS, you can map more than one device to a single file system. You can then configure policies that automatically relocate files from one device to another, or relocate files by running file relocation commands.
New and Enhanced Features Note To use storage checkpoint file system restore, a VxFS license is required to enable storage checkpoints. File Change Log The VxFS File Change Log (FCL) tracks changes to files and directories in a file system. The FCL can be used by applications, such as backup products, webcrawlers, search engines, indexing engines, and replication software that typically scan an entire file system searching for modifications since a previous scan.
New and Enhanced Features The reverse name lookup feature includes the following function in the API: vxfs_inotopath Returns path names for a given inode number. vxfs_inotopath_gen Returns path names for a given inode number with a specific generation count. Intent Log Resize With the Version 6 disk layout, the VxFS intent log can be increased or decreased using the log option of the fsadm_vxfs. Dynamically changing the intent log size can improve system performance.
New and Enhanced Features ◆ The largefiles option is now the default file size option for the mount command and mkfs command. ◆ The delaylog option is now the default intent logging mount option. The change of the default mount option from log to delaylog does not increase the risk of data loss, but allows VxFS to cache data to improve performance. See the VERITAS File System Administrator's Guide for more information. ◆ The default Storage Checkpoint creation mode is now removable.
New and Enhanced Features SFORA rollback INFO V-81-3000 VxDBA Rollback for Database to a Storage Checkpoint. Support for Multivolume File Systems in Storage Checkpoint Policy Administration Storage Checkpoint policy administration functionality now allows database administrators to specify the volumes on which Storage Checkpoints can be created for each file system within the database.
New and Enhanced Features Command Name Description dbed_ckptquota Administers quotas for Storage Checkpoints. This option is not available through the VxDBA utility menu or the GUI. edgetmsg2 Manages message log files. This option is not available through the VxDBA utility menu or the GUI.
System Requirements System Requirements HP-UX Operating System Requirements The VERITAS Storage Foundation 4.1 product line operates on HP operating systems running releases September 2004 HP-UX 11i version 2.0 or later. ▼ To verify the operating system version Use the swlist command as follows: # swlist | grep HPUXBaseAux HPUXBaseAux B.11.23.0409 HP-UX Base OS Auxiliary JFS must be installed on your system prior to installing any VERITAS software.
System Requirements ◆ PHSS_32228 ◆ PHSS_32231 Note These patches apply only to the IA architecture.
Known Issues Known Issues This section documents the known issues in this release of VERITAS Storage Foundation 4.1. VERITAS Storage Foundation Known Issue To install a VERITAS Storage Foundation product, configure VERITAS Volume Manager as described in Chapter 2, "Installing the VERITAS Software," of the VERITAS Storage Foundation Installation Guide. Then, follow the instructions in Chapter 3, "Upgrading the VERITAS Software," of the VERITAS Storage Foundation Installation Guide.
Software Limitations Software Limitations The following sections describe VERITAS Storage Foundation software limitations that exist in this release. VERITAS File System Software Limitations End of Product Support ◆ VxFS 4.1 does not support creating of file systems using Version 1 disk layout and mounting of file systems using Version 2 or 3 disk layouts. VxFS 4.1 still provides the capability to upgrade Version 3 disk layouts using the vxfsconvert utility, but this is the last release to do so.
Software Limitations The disk layout of a VxFS file system can be upgraded after installing VxFS 4.1. Use vxupgrade(1M) command to upgrade the disk layout from Version 4 or 5 to disk layout Version 6 on a mounted file system. Use vxfsconvert(1M) to convert an unmounted file system to VxFS disk layout Version 4. Note A disk layout Version 6 file system created with VxFS 4.1 software will not be accessible if the VxFS 4.1 file system software is removed and the system is reverted to VxFS 3.5.
Software Limitations Storage Checkpoint Limitations ◆ You cannot create a clone database using a mounted Storage Checkpoint. [32726] ◆ You must run the dbed_update command after upgrading to VERITAS Storage Foundation 4.1 for Oracle from a previous release. This will allow you to roll back to a Storage Checkpoint that was created prior to this release.
Software Limitations Oracle Disk Manager Limitations ◆ Because Oracle Disk Manager uses the Quick I/O driver to perform asynchronous I/O, do not turn off the Quick I/O mount option. The default option is the correct option to use. ◆ Using Oracle Disk Manager with Cached Quick I/O enabled is not supported and could cause your system to panic [34281]. To avoid a system panic, ensure the following: ◆ If you are using Oracle Disk Manager, do not enable Cached Quick I/O on your file system.
Software Limitations 3. Do not make SQLPATH read-only, so that Storage Foundation for Oracle scripts can unset it at runtime. 4. Avoid starting Storage Foundation for Oracle scripts from the directory where login.sql resides, unless you are sure that login.sql does not contain any settings or commands that change the default output for queries against the data dictionary or increase the startup time for SQL*Plus. Also avoid using any settings or commands in the glogin.
Software Issues Software Issues The following sections describe VERITAS Storage Foundation software issues that exist in this release. These issues are expected to be resolved in future releases. VERITAS Volume Manager Software Issues See the following sections for information about known problems and issues in this release of VxVM. Installation and Upgrade Issues Upgrading Systems Running VxVM 3.5 Prior to Command Cumulative Patch 06 Before upgrading a system that is running under VxVM 3.
Software Issues Adding a Log and Mirror to a Volume The vxassist command does not add a mirror and a log when processing a command such as the following: # vxassist mirror volume layout=log ... The mirror is added, but the log is silently omitted. To add a log and a mirror, add them in two separate vxassist invocations, as follows: # vxassist mirror volume ... # vxassist addlog volume ...
Software Issues In this example, a volume, vol, has two subvolumes, vol-L01 and vol-L02.
Software Issues ◆ In a clustered or HA environment where VERITAS Cluster Server agents need to communicate with vxconfigd to determine the health of VxVM components, service groups start timing out and failing.
Software Issues LUN_SERIAL_NO : 50001FE100270DF0 600508B40010293D00006000012A0000Printing Name-Value Pair Printing Name-Value Pair Printing Name-Value Pair . . . These messages are harmless and can be ignored. Hot-Relocation Issues Impact of Hot-Relocation on Performance Except for rootvol and swapvol, hot-relocation does not guarantee the same layout of data or performance after relocation.
Software Issues Note It is the failure condition in the third type of configuration that triggers the problem. These failures are rare and are not seen during the normal operation of a healthy SAN. This is not a time-out. No DMP activity will occur after the 10 minutes has passed. DMP only checks the elapsed time of the I/O after it is returned by the lower layer. If the elapsed time is greater than dmp_failed_io_threshold seconds (default 600), the error will be returned to VxVM without retries.
Software Issues File Systems Supported in Cluster-Shareable Disk Groups The use of file systems other than VERITAS Storage Foundation Cluster File System (SFCFS) on volumes in cluster-shareable disk groups can cause system deadlocks.
Software Issues Warning Message when Taking a Snapshot of a SFCFS File System When taking a snapshot of a SFCFS file system, the following warning message might appear: VxVM vxio WARNING V-5-0-4 Plex plex detached from volume volume Workaround: No action is required. This behavior is normal and is not the result of an error condition. File System Check of a Snapshot Normally, a file system would have no work to do when a snapshot is taken.
Software Issues Volumes Not Started Following a Reboot During very fast boots on a system with many volumes, vxconfigd may not be able to auto-import all of the disk groups by the time vxrecover -s is run to start the volumes. As a result, some volumes may not be started when an application starts after reboot. Workaround: Check the state of the volumes before starting the application, or place a sleep (sleep sec) before the last invocation of vxrecover.
Software Issues VEA Issues Note Refer to the VERITAS Storage Foundation Installation Guide for information on how to set up and start the VEA server and client. Name Service Switch Configuration File For VEA to operate successfully, the name service switch configuration file, /etc/nsswitch.conf, must be present on the system. See the nsswitch.conf(4) manual page for more information. Accessing the Task Log The task log accessed from the Log tree is not supported.
Software Issues Creating non-CDS disks By default, VEA always creates CDS disk groups, and will therefore initialize disks with the CDS format. In order to create non-CDS disk groups through VEA, you need to create the following two files (or, edit the files accordingly if they already exist). This changes the default format setting for disk creation from format=cdsdisk in the /etc/default/vxdisk file, and the default CDS attribute setting from cds=on in the /etc/default/vxdg file.
Software Issues Upgrading Disk Group Versions All disk groups have a version number associated with them. Each VxVM release supports a specific set of disk group versions and can import and perform tasks on disk groups with those versions. Some new features and tasks work only on disk groups with the current disk group version, so you need to upgrade existing disk groups before you can perform the tasks. The following table summarizes the disk group versions that correspond to each VxVM release from 2.
Software Issues VERITAS File System Software Issues Applications Using statvfsdev(3C) Interface The applications that use the statvfsdev(3C) interface on a device name need to relink with the new LIBC to be able to understand the disk layout Version 6. Disk Layout Version 6 is available with this release. If the applications are not relinked, they cannot recognize a file system with disk layout Version 6. However, they would continue to recognize file systems with disk layout Version 4 and 5.
Software Issues Tuning Down the Inode Cache VxFS file systems allocate and release inodes based on the file system load. Generally, larger inode caches help the file systems to perform better in the case of a file server or web server load. The global (static) tunable, vx_ninode, determines the maximum possible size of the VxFS inode cache.
Software Issues As a workaround this issue can be avoided by passing a sufficiently large user buffer. File System With Quotas Cannot Be Mounted After Doing CDS Conversion If a file system is using quotas, it cannot be mounted with quotas turned on after converting the byte order of the file system with the fscdsconv(1M) utility. Similarly, quotas cannot be turned on, if the converted file system is first mounted with quotas turned off. See the fscdsconv(1M) manual page for the workaround.
Software Issues Non-standard Command Behavior When Using ACLs The output of the ls -l command on VxFS file systems shows mask/CLASS_OBJ in place of group permissions if Access Control Lists (ACLs) are in use on a file or a directory. You can determine the effective group permissions by using the getacl command. In the next release of VxFS, the behavior of ls -l will show effective group permissions, that is, GROUP_OBJ masked by CLASS_OBJ.
Software Issues block size file system). Therefore, large file systems must be mounted only on systems that have sufficient memory. The memory requirements for mounting large file systems are shown in the tables below.
Software Issues Files and Directories To maximize VxFS performance, do not exceed 100,000 files in the same directory. Use multiple directories instead. Cross-Platform Data Sharing (CDS) ◆ External Quota File CDS does not support converting the external quota file. The external quota file would need to be manually migrated as follows: On source: Prior to unmounting the file system, remove the quotas file. Run the fscdsconv command after unmounting the file system.
No Longer Supported ◆ Handling ACLs with CDS Because not all target platforms support ACLs, converting a file system with ACLs from the source to a target on which ACLs are not supported results in ACLs not being enabled on the target. If the file system is converted back to a target on which ACLs are supported, permission checks are enforced again.
Available Documentation ◆ In VERITAS Storage Foundation 4.1, snapshot plexes created by the vxassist command are not supported. A combination of snapshot plexes created by vxassist and vxsnap is also not supported in this release. Available Documentation After the installation procedure is complete, documents are available online under the /opt/VRTS/docs directory. Documents are provided as Adobe Portable Document Format (PDF) files and in a searchable HTML-based format.
Available Documentation VERITAS Storage Foundation Guides The following manuals, along with the online help, comprise the VERITAS Storage Foundation documentation set: Guides in VERITAS Storage Foundation Documentation Set Guide Title Filename VERITAS Storage Foundation and High Availability getting_started.pdf Getting Started Guide VERITAS Storage Foundation Release Notes (this document) sf_notes.pdf VERITAS Storage Foundation Installation Guide sf_install.
Available Documentation VERITAS Cluster Server Documentation The following VERITAS Cluster Server documentation is available with all VERITAS Storage Foundation HA product suites: Guides in VERITAS Cluster Server Documentation Set Guide Title Filename VERITAS Cluster Server Release Notes vcs_notes.pdf VERITAS Cluster Server Installation Guide vcs_install.pdf VERITAS Cluster Server User’s Guide vcs_users.pdf VERITAS Cluster Server Agent Developer’s Guide vcs_agent_dev.
Available Documentation Guides in VERITAS Volume Replicator Documentation Set Guide Title Filename VERITAS Cluster Server Agents for VERITAS Volume Replicator Configuration Guide vvr_agents_config.pdf Manual Pages The VERITAS online manual pages are installed in the /opt/VRTS/man directory. This directory must be added to the MANPATH environment variable. Installing documentation and online manual pages is optional. Technical Support For license information (U.S.
Available Documentation VERITAS Storage Foundation Release Notes 51
Available Documentation 52 VERITAS Storage Foundation Release Notes
Available Documentation VERITAS Storage Foundation Release Notes 53
Available Documentation 54 VERITAS Storage Foundation Release Notes