Veritas Cluster Server Agents for Veritas FlashSnap™ Agent for Symmetrix Installation And Configuration Guide Solaris 5.0 N18533F Veritas Cluster Server Agents for Veritas FlashSnap Agent for Symmetrix Installation And Configuration Guide Copyright © 2006 Symantec Corporation. All rights reserved. Veritas FlashSnapTM Agent 5.0 for Symmetrix Symantec, the Symantec logo, and FlashSnap 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. THIS DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID, SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE. The Licensed Software and Documentation are deemed to be “commercial computer software” and “commercial computer software documentation” as defined in FAR Sections 12.212 and DFARS Section 227.7202. Symantec Corporation 20330 Stevens Creek Blvd. Cupertino, CA 95014 www.symantec.com Third-party legal notices Third-party software may be recommended, distributed, embedded, or bundled with this Symantec product. Such third-party software is licensed separately by its copyright holder. All third-party copyrights associated with this product are listed in the accompanying release notes. Solaris is a trademark of Sun Microsystems, Inc. Licensing and registration Veritas FlashSnap Agent for Symmetrix is a licensed product. See the Veritas FlashSnap Agent for Symmetrix Installation Guide for license installation instructions. Technical support For technical assistance, visit http://support.veritas.com and select phone or email support. Use the Knowledge Base search feature to access resources such as TechNotes, product alerts, software downloads, hardware compatibility lists, and our customer email notification service. Contents Chapter 1 Veritas FlashSnap Agent for Symmetrix HA Agents What’s in this manual ...........................................................................................7 Getting help ............................................................................................................7 Veritas FlashSnap Agent for Symmetrix HA agents ........................................8 List of VxFAS HA agents .......................................................................................9 VCS Cluster components ......................................................................................9 Resources ........................................................................................................9 Attributes ........................................................................................................9 Service groups ................................................................................................9 Installing VxFAS HA agents ...............................................................................10 Upgrading to VxFAS HA Agents 5.0 .................................................................10 Configuring VxFAS HA agents ..........................................................................10 Modifying the agents and their resources .......................................................11 Resources and Service groups for VxFAS HA feature ....................................12 Resource dependencies ...............................................................................13 Activating VxFAS in the VCS environment .....................................................15 Guidelines for creating service groups and resources ...................................15 Creating a service group .............................................................................16 Creating a resource instance for a VxSymDevGrp resource .................17 Creating a resource instance for a VxSymLog resource ........................18 Creating a resource instance for a DiskGroup resource ........................19 Creating a resource instance for a mount resource ...............................20 Creating a resource instance for a VxSymRecover resource ................21 Chapter 2 Operational Notes Symmetrix-specific setup ...................................................................................23 Modifying the VxSymLog LogDiskList attribute ............................................24 VxFAS HA operational notes .............................................................................26 VxFAS command-specific issues ...............................................................26 Logging-specific issues ...............................................................................27 VxVM-specific issues ...................................................................................29 VCS-specific issues ......................................................................................29 EMC PowerPath-specific issues .................................................................32 Re-using devices from other device groups .............................................33 Converting non-HA setup to HA ................................................................35 6 Chapter 3 VxFAS Agent Definitions VxSymDevGrp agent ...........................................................................................38 Type definition .............................................................................................39 Sample configuration ..................................................................................39 VxSymLog agent ..................................................................................................40 Type definition .............................................................................................41 Sample configuration ..................................................................................41 VxSymRecover agent ..........................................................................................42 Type definition .............................................................................................42 Sample configuration ..................................................................................42 DiskGroup agent ..................................................................................................43 Type definition .............................................................................................43 Sample configuration ..................................................................................43 Mount agent .........................................................................................................44 Type definition .............................................................................................45 Sample configuration ..................................................................................45 Example main.cf file ............................................................................................46 Index 49 1 Chapter Veritas FlashSnap Agent for Symmetrix HA Agents This guide describes how to install and configure the components of the Veritas FlashSnap Agent for Symmetrix (VxFAS) high availability (HA) agents in an EMC Symmetrix environment. This guide also explains how to create, modify, and activate Veritas Cluster Server (VCS) resources and service groups. What’s in this manual ■ Chapter 1. “Veritas FlashSnap Agent for Symmetrix HA Agents” on page 7 introduces the concepts of VCS resources, attributes, and service groups. Describes VxFAS HA agent installation and configuration. Provides guidelines for creating service groups and resources. ■ Chapter 2. “Operational Notes” on page 23 describes how to set up a VCS cluster using a Symmetrix disk array as shared storage and discusses issues related to VxFAS commands, VCS, and EMC PowerPath configuration and recovery. ■ Chapter 3. “VxFAS Agent Definitions” on page 37 provides the programmatic definitions of the VxFAS HA agents and the VCS bundled agents required for the high availability product to operate. Getting help For technical assistance, visit http://support.veritas.com and select phone or email support. Use the Knowledge Base search feature to access resources such as TechNotes, product alerts, software downloads, hardware compatibility lists, and our customer email notification service. 8 Veritas FlashSnap Agent for Symmetrix HA Agents Veritas FlashSnap Agent for Symmetrix HA agents Diagnostic tools are also available to assist in troubleshooting problems associated with the product. These tools are available on disc or can be downloaded from the Veritas FTP site. See the README.VRTSspt file in the /support directory for details. For information on purchasing product documentation, visit http://webstore.veritas.com. Unique Message Number If you encounter a product error message, record the unique message number preceding the text of the message. When contacting Symantec Technical Support, either by telephone or by visiting the Technical Support website, be sure to provide the relevant message number. Technical Support will use this message number to quickly determine if there are TechNotes or other information available for you. A unique message number is an alpha-numeric string beginning with the letter “V”. For example, in the message number: V-5-732-8018 At least one disk must be specified the “V” indicates that this is a Veritas product error message. The text of the error message follows the unique message number. Veritas FlashSnap Agent for Symmetrix HA agents Agents are processes that manage predefined resource types. When an agent is started, it obtains configuration information from the Veritas Cluster Server (VCS). It then periodically monitors the resources and updates VCS with the resource status. Typically agents: ■ Bring resources online ■ Take resources offline ■ Monitor resources and report any state changes to VCS VCS bundled agents are part of VCS and are installed when VCS is installed (as part of VRTSvcsag package). The VxFAS HA agents are add-on resources to VCS for the Veritas FlashSnapTM Agent for Symmetrix. VxFAS HA agents and resource types are part of the VRTStfag package and are added when you install the package and run the vxtfvcsconf script. For more information on VCS agents, see the Veritas Cluster Server Bundled Agents Reference Guide. PDF versions of this guide are located under the /opt/VRTSvcsdc directory after installing the VRTSvcsdc package. Veritas FlashSnap Agent for Symmetrix HA Agents 9 List of VxFAS HA agents List of VxFAS HA agents The VxFAS HA agents include: ■ VxSymDevGrp agent ■ VxSymLog agent ■ VxSymRecover agent The HA feature requires these VCS bundled agents: ■ DiskGroup agent ■ Mount agent VCS Cluster components Resources, attributes, and service groups are components integral to cluster functionality (see the Veritas Cluster Server User’s Guide in the /opt/VRTSvcsdc directory for more information). Resources Resources are hardware or software entities, such as disks, volumes, file system mount points, network interface cards (NICs), IP addresses, applications, and databases. Resources work together to provide a service to clients in a client/server environment. Resource types are defined in the types.cf file by a collection of attributes. The VCS configuration file, main.cf, contains the values for the attributes of the resources. The main.cf file incorporates the resources listed in the types.cf by way of an include directive. Attributes Attributes contain data regarding the cluster, systems, service groups, resources, resource types, and agents. Each attribute has a definition and a value. A user defines an attribute by specifying its data type and dimension. A specified value for a given attribute configures the resource to function in a specific way. By modifying the value of an attribute of a resource, a user can change the way the VCS agent manages that resource. Attributes also have default values that are assigned when a value is not specified. Service groups Service groups are comprised of related resources. When a service group is brought online, all the resources within the group are brought online. 10 Veritas FlashSnap Agent for Symmetrix HA Agents Installing VxFAS HA agents Installing VxFAS HA agents The VRTSfasag (Veritas Cluster Server Agents for VxFAS) package includes the VxFAS HA agents (see “List of VxFAS HA agents” on page9). Installation of the VRTStfag package requires the following packages: ■ VRTSvcs (Veritas Cluster Server) version 4.1 ■ VRTSvcsag (Veritas Cluster Server Bundled Agents) version 4.1 ■ VRTSfas (Veritas FlashSnap Agent for Symmetrix) version 4.1 Install these packages first and then install the VRTSfasag package using the pkgadd command. VRTSvcs and VRTSfas may have their own dependencies. Refer to their respective documentation for more details. Upgrading to VxFAS HA Agents 5.0 If Veritas TimeFinder 4.0 HA Agents or VxFAS 4.0 HA Agents is already installed, you can upgrade to this release. To upgrade to this release from VxTF 4.0 or VxFAS 4.0 HA Agents: The resource configuration for VxTF 4.0 or VxFAS 4.0 HA Agents can be reused with this release of VxFAS HA Agents. 1 Perform pending recovery, if any, for VxTF or VxFAS. 2 Uninstall old VRTStfag package if upgrading from VxTF 4.0 HA agent or VRTSfasag package if upgrading from VxFAS 4.0 HA agents. 3 Offline all VCS service groups. 4 Upgrade to VCS version 4.1. 5 Add the new VRTSfasag 5.0 package. 6 Online the service groups. Configuring VxFAS HA agents To define the VCS resource types required by VxFAS HA feature, run the vxtfvcsconf script (without any arguments) from any system in the VCS cluster. See “Activating VxFAS in the VCS environment” on page15 for more details. To get an overview read “Resources and Service groups for VxFAS HA feature” on page12.