Vcs Bundled Agents 60 Sol

Veritas Cluster ServerBundled Agents ReferenceGuide

Solaris

6.0

February 2012

Veritas Cluster Server Bundled Agents ReferenceGuideThe software described in this book is furnished under a license agreement and may be usedonly in accordance with the terms of the agreement.

Product version: 6.0

Document version: 6.0.2

Legal NoticeCopyright 2012 Symantec Corporation. All rights reserved.

Symantec, the Symantec logo, Veritas, Veritas Storage Foundation, CommandCentral,NetBackup, Enterprise Vault, and LiveUpdate are trademarks or registered trademarks ofSymantec corporation or its affiliates in the U.S. and other countries. Other names may betrademarks 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 documentmay be reproduced in any form by any means without prior written authorization ofSymantec Corporation and its licensors, if any.

THE DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS,REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TOBE LEGALLY INVALID. SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTALOR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING,PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINEDIN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE.

The Licensed Software and Documentation are deemed to be commercial computer softwareas 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 inCommercial Computer Software or Commercial Computer Software Documentation", asapplicable, and any successor regulations. 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 Corporation350 Ellis StreetMountain View, CA 94043

http://www.symantec.com

Technical SupportSymantec Technical Support maintains support centers globally. TechnicalSupports primary role is to respond to specific queries about product featuresand functionality. The Technical Support group also creates content for our onlineKnowledge Base. The Technical Support group works collaboratively with theother functional areas within Symantec to answer your questions in a timelyfashion. For example, the Technical Support group works with Product Engineeringand Symantec Security Response to provide alerting services and virus definitionupdates.

Symantecs support offerings include the following:

A range of support options that give you the flexibility to select the rightamount of service for any size organization

Telephone and/or Web-based support that provides rapid response andup-to-the-minute information

Upgrade assurance that delivers software upgrades

Global support purchased on a regional business hours or 24 hours a day, 7days a week basis

Premium service offerings that include Account Management Services

For information about Symantecs support offerings, you can visit our Web siteat the following URL:

www.symantec.com/business/support/index.jsp

All support services will be delivered in accordance with your support agreementand the then-current enterprise technical support policy.

Contacting Technical SupportCustomers with a current support agreement may access Technical Supportinformation at the following URL:

www.symantec.com/business/support/contact_techsupp_static.jsp

Before contacting Technical Support, make sure you have satisfied the systemrequirements that are listed in your product documentation. Also, you should beat the computer on which the problem occurred, in case it is necessary to replicatethe problem.

When you contact Technical Support, please have the following informationavailable:

Product release level

Hardware information

Available memory, disk space, and NIC information

Operating system

Version and patch level

Network topology

Router, gateway, and IP address information

Problem description:

Error messages and log files

Troubleshooting that was performed before contacting Symantec

Recent software configuration changes and network changes

Licensing and registrationIf your Symantec product requires registration or a license key, access our technicalsupport Web page at the following URL:

www.symantec.com/business/support/

Customer serviceCustomer 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 thefollowing 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

Support agreement resourcesIf you want to contact Symantec regarding an existing support agreement, pleasecontact the support agreement administration team for your region as follows:

[email protected] and Japan

[email protected], Middle-East, and Africa

[email protected] America and Latin America

DocumentationProduct guides are available on the media in PDF format. Make sure that you areusing the current version of the documentation. The document version appearson page 2 of each guide. The latest product documentation is available on theSymantec Web site.

https://sort.symantec.com/documents

Your feedback on product documentation is important to us. Send suggestionsfor improvements and reports on errors or omissions. Include the title anddocument version (located on the second page), and chapter and section titles ofthe text on which you are reporting. Send feedback to:

[email protected]

About Symantec ConnectSymantec Connect is the peer-to-peer technical community site for Symantecsenterprise customers. Participants can connect and share information with otherproduct users, including creating forum posts, articles, videos, downloads, blogsand suggesting ideas, as well as interact with Symantec product teams andTechnical Support. Content is rated by the community, and members receivereward points for their contributions.

http://www.symantec.com/connect/storage-management

Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 1 Introducing Bundled agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19About Bundled agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Resources and their attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Modifying agents and their resources ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Zone-aware agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21IMF aware agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Enabling debug log messages ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Chapter 2 Storage agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25About the storage agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Dependencies for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Agent functions for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26State definitions for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Attributes for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Resource type definition for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 32Notes for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Sample configurations for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Debug log levels for DiskGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Dependencies for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Agent functions for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37State definitions for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Attributes for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Notes for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Resource type definition for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . 43Sample configurations for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . 43Debug log levels for DiskGroupSnap agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Disk agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Contents

Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Dependencies for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Agent functions for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53State definitions for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Attributes for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Resource type definition for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Sample configuration for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Debug log levels for Volume agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Dependencies for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Agent functions for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55State definitions for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Attributes for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Resource type definition for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 56Sample configurations for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Agent notes for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Inaccessible volumes prevent the VolumeSet agent from coming

online .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Debug log levels for VolumeSet agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Dependencies for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Agent functions for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59State definitions for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Attributes for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Resource type definition for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Notes for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67High availability fire drill .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68VxFS file system lock .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68IMF usage notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68IPv6 usage notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Support for loopback file system .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Enabling Level two monitoring for the Mount agent ... . . . . . . . . . . . . . . . . . . 71ZFS file system and pool creation example ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Sample configurations for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Debug log levels for Mount agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Limitations for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Dependencies for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Agent functions for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73State definitions for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Contents8

Attributes for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Resource type definition for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Sample configurations for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Debug log levels for Zpool agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Chapter 3 Network agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81About the network agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Agent comparisons .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

High availability fire drill for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Dependencies for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Agent functions for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84State definitions for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Attributes for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Resource type definition for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Sample configurations for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Debug log levels for IP agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89High availability fire drill for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Dependencies for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Agent functions for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90State definitions for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Attributes for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Resource type definition for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Sample configurations for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Exclusive IP Zone configuration for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . 94Debug log levels for NIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

IPMultiNIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Dependencies for IPMultiNIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Agent functions for IPMultiNIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96State definitions for IPMultiNIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Attributes for IPMultiNIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Resource type definition for IPMultiNIC agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 98Sample configuration: IPMultiNIC and MultiNICA .... . . . . . . . . . . . . . . . . . . . . 99Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Dependencies for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Agent function for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101State definitions for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Attributes for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Resource type definition for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . 104Notes for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

9Contents

Using RouteOptions for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Sample configurations for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Debug log levels for MultiNICA agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

About the IPMultiNICB and MultiNICB agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Checklist to ensure the proper operation of MultiNICB .... . . . . . . . . . . . . 108

IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Dependencies for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Requirements for IPMultiNICB .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Agent functions for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110State definitions for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Attributes for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Resource type definition for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . 114Manually migrating a logical IP address for IPMultiNICB

agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Sample configurations for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . 115Debug log levels for IPMultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Base and Multi-pathing modes for MultiNICB agent ... . . . . . . . . . . . . . . . . 116Oracle trunking for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116The haping utility for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Dependencies for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Agent functions for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117State definitions for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Attributes for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Optional attributes for Base and Mpathd modes for MultiNICB

agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Optional attributes for Base mode for MultiNICB agent ... . . . . . . . . . . . . 120Optional attributes for Multi-pathing mode for MultiNICB agent

... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Resource type definition for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . 123Solaris operating modes: Base and Multi-Pathing for MultiNICB

agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Base mode for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Failover and failback for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Multi-Pathing mode for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Trigger script for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Sample configurations for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Debug log levels for MultiNICB agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Dependencies for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Agent functions for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131State definitions for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Attributes for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Contents10

Resource type definition for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Agent notes for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Sample configurations for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Debug log levels for DNS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Chapter 4 File share agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147About the file service agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Dependencies for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Agent functions for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148State definitions for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Attributes for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Resource type definition for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Notes for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Sample configurations for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Debug log levels for NFS agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Dependencies for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Agent functions for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153State definitions for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Attributes for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Resource type definition for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . 156Notes for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Sample configurations for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 160Debug log levels for NFSRestart agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Dependencies for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Agent functions for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162State definitions for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Attributes for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Resource type definition for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Notes for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Sample configurations for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Debug log levels for Share agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

About the Samba agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164The Samba agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Before using the Samba agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Supported versions for the Samba agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Notes for configuring the Samba agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Dependencies for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Agent functions for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

11Contents

State definitions for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Attributes for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Resource type definitions for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . 169Sample configurations for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . 169Debug log levels for SambaServer agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Dependencies for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Agent functions for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170State definitions for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Attributes for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Resource type definition for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . 171Sample configuration for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 172Debug log levels for SambaShare agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Dependencies for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Agent functions for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173State definitions for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173Attributes for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Resource type definition for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Sample configuration for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Debug log levels for NetBios agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Chapter 5 Service and application agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177About the services and applications agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Apache HTTP server agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Apache HTTP server notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190High availability fire drill for Application agent ... . . . . . . . . . . . . . . . . . . . . . . 190Dependencies for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Agent functions for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191State definitions for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Attributes for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Resource type definition for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . 197Notes for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Sample configurations for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 199Debug log levels for Application agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Contents12

CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Dependencies for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Agent functions for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202State definitions for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Attributes for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Resource type definition for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . 203Notes for the CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Sample configuration for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204Debug log levels for CoordPoint agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205High availability fire drill for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Dependencies for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Agent functions for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206State definitions for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Attributes for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Resource type definition for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Usage notes for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Sample configurations for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Debug log levels for Process agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

ProcessOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211ProcessOnOnly agent usage notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Zone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Configuring the Zone agent for DR in a Global Cluster

environment .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Zone agent notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Using the Zone agent with IMF .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

LDom agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Configuring primary and guest domain dependencies and failure

policy ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

13Contents

Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Configuring the LDom agent for DR in a Global Cluster

environment .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229LDom agent notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230About the auto-boot? variable ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Sample configuration 2 .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Configuration (future LDom migration) ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Project agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Sample configuration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Dependencies for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234Agent functions for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234State definitions for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Attributes for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Resource type definition for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . 236Sample configurations for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 237Debug log levels for AlternateIO agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Chapter 6 Infrastructure and support agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241About the infrastructure and support agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241NotifierMngr agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Dependency .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Sample configuration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Proxy agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Contents14

Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Phantom agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

RemoteGroup agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252Dependency .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254Resource type definition .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259Debug log levels ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Chapter 7 Testing agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261About the testing agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Dependencies for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Agent function for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262State definitions for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262Attributes for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262Resource type definition for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Sample configuration for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Debug log levels for ElifNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Dependencies for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Agent functions for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264State definitions for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Attributes for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Resource type definition for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Sample configuration for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Debug log levels for FileNone agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Dependencies for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266Agent functions for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266State definitions for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266Attribute for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Resource type definition for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . 267Sample configuration for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Debug log levels for FileOnOff agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

15Contents

FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Dependencies for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Agent functions for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268State definitions for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268Attribute for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269Resource type definition for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . 269Sample configuration for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269Debug log levels for FileOnOnly agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Chapter 8 Replication agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271About the replication agents ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Dependencies for RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Agent functions for RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273State definitions for RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Attributes for RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Resource type definitions for RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274Sample configurations for RVG agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Dependencies for RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Agent functions for RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276State definitions for RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277Attributes for RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277Resource type definitions for RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . 280Sample configurations for RVGPrimary agent ... . . . . . . . . . . . . . . . . . . . . . . . . 281

RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281Dependencies for RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Agent functions for RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282State definitions for RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Attributes for RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Resource type definitions for RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Sample configurations for RVGSnapshot ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

RVGShared agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286Resource type definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

RVGLogowner agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

Contents16

State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Resource type definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289RVGLogowner agent notes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

RVGSharedPri agent ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Dependencies ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Agent functions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292State definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292Attributes ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292Resource type definitions ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293Sample configurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

17Contents

Contents18

IntroducingBundled agents

This chapter includes the following topics:

About Bundled agents

Resources and their attributes

Modifying agents and their resources

Attributes

Zone-aware agents

IMF aware agents

Enabling debug log messages

About Bundled agentsBundled agents are Veritas Cluster Server (VCS) processes that manage resourcesof predefined resource types according to commands received from the VCSengine, HAD. You install these agents when you install VCS.

A node has one agent per resource type that monitors all resources of that type.For example, a single IP agent manages all IP resources.

When the agent starts, it obtains the necessary configuration information fromVCS. The agent then periodically monitors the resources, and updates VCS withthe resource status.

Agents can:

Bring resources online.

Take resources offline.

Monitor resources and report state changes.

1Chapter

For a more detailed overview of how agents work, refer to the Veritas ClusterServer Administrators Guide.

Resources and their attributesResources are parts of a system. They are known by their types, for example: avolume, a disk group, or an IP address. VCS includes a set of resource types.Different attributes define these resource types in the types.cf file. Each type hasa corresponding agent that controls the resource.

The VCS configuration file, main.cf, contains the values for the resource attributesand has an include directive to the types.cf file.

An attributes given value configures the resource to function in a specific way.By modifying the value of a resource attribute, you can change the way the VCSagent manages the resource. For example, the IP agent uses the Address attributeto determine the IP address to monitor.

Modifying agents and their resourcesUse the Cluster Manager (Java Console), Veritas Operations Manager, or thecommand line to dynamically modify the configuration of the resources managedby an agent.

VCS enables you to edit the main.cf file directly. To implement these changes,make sure to restart VCS.

See the Veritas Cluster Server Administrators Guide for instructions on how tocomplete these tasks.

AttributesAttributes contain data about the cluster, systems, service groups, resources,resource types, and the agent. An attribute has a definition and a value. You changeattribute values to configure VCS resources. Attributes are either optional orrequired, although sometimes attributes that are optional in one configurationmight be required in other configurations. Many optional attributes havepredefined or default values, which you should change as required.

A variety of internal use only attributes also exist. Do not modify theseattributesmodifying them can lead to significant problems for your clusters.

Attributes have type and dimension. Some attribute values can accept numbers,others can accept alphanumeric values or groups of alphanumeric values, whileothers are simple boolean on/off values.

Introducing Bundled agentsResources and their attributes

20

Table 1-1 Attribute data types

DescriptionData Type

Enclose strings, which are a sequence of characters, in double quotes("). Optionally enclose strings in quotes when they begin with a letter,and contains only letters, numbers, dashes (-), and underscores (_).

A string can contain double quotes, but the quotes must be immediatelypreceded by a backslash. In a string, represent a backslash with twobackslashes (\\).

string

Signed integer constants are a sequence of digits from 0 to 9. You canprecede them with a dash. They are base 10. Integers cannot exceedthe value of a 32-bit signed integer: 2147483647.

integer

A boolean is an integer with the possible values of 0 (false) and 1 (true).boolean

Table 1-2 Attribute dimensions

DescriptionDimension

A scalar has only one value. This is the default dimension.scalar

A vector is an ordered list of values. Each value is indexed using apositive integer beginning with zero. A set of brackets ([]) denotes thatthe dimension is a vector. Find the specified brackets after the attributename on the attribute definition in the types.cf file.

vector

A keylist is an unordered list of unique strings.keylist

An association is an unordered list of name-value pairs. An equal signseparates each pair. A set of braces ({}) denotes that an attribute is anassociation. Braces are specified after the attribute name on theattribute definition in the types.cf file, for example: strSnmpConsoles{}.

association

Zone-aware agentsTable 1-3 lists the ContainerOpts attribute default values for resource types.Symantec recommends that you do not modify these values.

Table 1-3 ContainerOpts attribute default values for applications and resourcetypes

PassCInfoRunInContainerResource Type

01Application

21Introducing Bundled agentsZone-aware agents

Table 1-3 ContainerOpts attribute default values for applications and resourcetypes (continued)

PassCInfoRunInContainerResource Type

01Apache

10IP

10IPMultiNIC

10IPMultiNICB

00Mount

10NIC

01Process

10Zone

For more information on using zones in your VCS environment, refer to theVeritasStorage Foundation and High Availability Solutions Virtualization Guide.

IMF aware agents Zone agent

Mount agent

Process agent

Application agent

Enabling debug log messagesTo help troubleshoot agent issues, you can enable debug log messages in the agentframework as well as the agents.

To enable agent framework debug log messages:

hatype -modify agent_name LogDbg -add DBG_AGDEBUG DBG_AGINFO

DBG_AGTRACE

For example:

# hatype -modify Mount LogDbg -add DBG_AGDEBUG DBG_AGINFO DBG_AGTRACE

To enable agent-specific debug log messages:

Introducing Bundled agentsIMF aware agents

22

# hatype -modify agent_name LogDbg -add debug_log_levels

For example:

# hatype -modify Mount LogDbg -add DBG_1 DBG_2 DBG_3 DBG_4 DBG_5 DBG_6

Alternatively, you can also use the following command:

# hatype -modify Mount LogDbg -add 1 2 3 4 5 6

Agent-specific debug log level information is specified in the agents description.For example, for information about the Mount agent, See Debug log levels forMount agent on page 72.

23Introducing Bundled agentsEnabling debug log messages

Introducing Bundled agentsEnabling debug log messages

24

Storage agents

This chapter includes the following topics:

About the storage agents

DiskGroup agent

DiskGroupSnap agent

Disk agent

Volume agent

VolumeSet agent

Mount agent

Zpool agent

About the storage agentsStorage agents monitor shared storage and make shared storage highly available.Storage includes shared disks, disk groups, volumes, and mounts.

DiskGroup agentThe DiskGroup agent brings online, takes offline, and monitors Veritas VolumeManager (VxVM) disk groups. This agent uses VxVM commands. You can use thisagent to monitor or make disk groups highly available.

When the value of the StartVolumes and StopVolumes attribute is 1, the DiskGroupagent brings the volumes online and takes them offline during the import anddeport operations of the disk group.

2Chapter

For important information on this agent, See Notes for DiskGroup agenton page 33.

Dependencies for DiskGroup agentThe DiskGroup resource does not depend on any other resources.

Figure 2-1 Sample service group that includes a DiskGroup resource

Application

IP Mount

NIC Volume

DiskGroup

Agent functions for DiskGroup agent

Imports the disk group using the vxdg command.Online

Deports the disk group using the vxdg command.Offline

Determines if the disk group is online or offline using the vxdgcommand. The Monitor function changes the value of the VxVMnoautoimport flag from off to on. This action allows VCS to maintaincontrol of importing the disk group. The monitor function usesfollowing command to set the noautoimport flag to on.

# vxdg -g disk_group set autoimport=no

Monitor

Terminates all ongoing resource actions and takes the resourceofflineforcibly when necessary.

Clean

Storage agentsDiskGroup agent

26

The DiskGroup info agent function gets information from the VolumeManager and displays the type and free size for the DiskGroupresource.

Initiate the info agent function by setting the InfoInterval timing toa value greater than 0.

In the following example, the info agent function executes every 60seconds:

# haconf -makerw

# hatype -modify DiskGroup InfoInterval 60

The command to retrieve information about the DiskType and FreeSizeof the DiskGroup resource is:

# hares -value diskgroupres ResourceInfo

Output includes:

DiskType sliced

FreeSize 35354136

The value specified is in kilo bytes.

Info

Different action agent functions follow:

license.vfd

Checks for valid Veritas Volume manager licenseif one is notfound use the vxlicinst utility to install a valid license key.

disk.vfd

Checks if all disks in diskgroup are visible on hostif it fails, checkif the path to disks exists from the host and check if LUN maskingand zoning are set properly.

udid.vfd

Checks the UDIDs (unique disk identifiers) of disks on the clusternodesif it fails, ensure that the disks that are used for the diskgroup are the same on all cluster nodes.

verifyplex.vfd

Checks if the number of plexes on each site for the Campus Clustersetup are set properlyif it fails, check that the sites, disks, andplexes are set properly for a Campus Cluster setup.

volinuse

Checks if open volumes are in use or file systems on volumes thatare mounted outside of VCS configuration.

See High availability fire drill on page 33.

Action

27Storage agentsDiskGroup agent

State definitions for DiskGroup agent

Indicates that the disk group is imported.ONLINE

Indicates that the disk group is not imported.OFFLINE

Indicates that the disk group has unexpectedly deported or becomedisabled.

FAULTED

Indicates that a problem exists either with the configuration or theability to determine the status of the resource. One cause of this stateis when I/O fencing is not configuredthe cluster level attributeUseFence is not set to "SCSI3" but the Reservation attribute value is"SCSI3".

UNKNOWN

Attributes for DiskGroup agent

Table 2-1 Required attributes

DescriptionRequiredattribute

Name of the disk group that is configured with Veritas VolumeManager.

Type and dimension: string-scalar

DiskGroup

Table 2-2 Optional attributes

DescriptionOptional attributes

If the value is 1, and SCSI-3 fencing is used, the agentmonitors the SCSI reservation on the disk group. If thereservation is missing, the monitor agent function takesthe service group containing the resource offline.

Type and dimension: boolean-scalar

Default: 0

Note: If the MonitorReservation attribute is set to 0, andthe value of the clusterwide attribute UseFence is set toSCSI3, and the disk group is imported without SCSIreservation, then the monitor agent function takes theservice group containing the resource offline.

MonitorReservation


28

Table 2-2 Optional attributes (continued)


PanicSystemOnDGLoss




Determines whether to panic the node if the disk groupbecomes disabled or monitor program times out. A lossof storage connectivity can cause the disk group to becomedisabled. VxVM commands not responding properly cancause monitor program to timeout.

Note: System administrators may want to set a high valuefor FaultOnMonitorTimeout to increase system tolerance.

This attribute accepts following values 0, 1, 2,3

0 : Do not halt the system

1 : halt the system if either disk group goes intodisabled state or the disk group resource faults due tomonitor timeout

2: halt the system if disk group goes into disabled state

3: halt the system if disk group resource faults due tomonitor timeout

If the value of the attribute is 0, and the disk groupbecomes disabled, the following occurs:

If the cluster has I/O fencing enabled, the DiskGroupresource is marked FAULTED. This state results in theagent attempting to take the service group offline.

As part of bringing the DiskGroup resource offline,the agent attempts to deport the disabled disk group.Even if disabled disk group fails to deport, theDiskGroup resource enters a FAULTED state. Thisstate enables the failover of the service group thatcontains the resource. To fail back the DiskGroupresource, manually deport the disk group afterrestoring storage connectivity.

If the cluster does not use I/O fencing, a message islogged and the resource is reported ONLINE. Theresource is reported ONLINE so that it does not failover, which ensures data integrity.

Notes:

The PanicSystemOnDGLoss attribute does not dependon the MonitorReservation attribute.

Symantec recommends to configure volume resourcefor each volume in the diskgroup to detect storageconnectivity loss more effectively.

If PanicSystemOnDGLoss is set to non-zero value, the


30



system panic is initiated usinguadmin 5 0 command.This command halts the system. An administratorneeds to bring up the system.

Type and dimension: integer-scalar

Default: 0

If value of this attribute is 1, the DiskGroup onlinefunction starts all volumes belonging to that disk groupafter importing the group.

Note: With VxVM version 5.1.100.0 onwards, if the VeritasVolume Manager default autostartvolumes at system levelis set to on, all the volumes of the disk group will bestarted as a part of the import disk group.


Default: 1

StartVolumes

If value is 1, the DiskGroup offline function stops allvolumes belonging to that disk group before it deportsthe disk group.


Default: 1

StopVolumes

This attribute enables the DiskGroup resource toforcefully go offline even if open volumes are mountedoutside of VCS control. When the value of this attributeis 1 and the disk group has open volumes, the followingoccurs:

The agent attempts to unmount the file systems onopen volumes. If required, the agent attempts to killall VCS managed and un-managed applications usingthe file systems on those open volumes.

The agent attempts to forcefully unmount the filesystems to close the volumes.

Type and dimension: integer-scalar

Default: 0

UmountVolumes




Determines if you want to enable SCSI-3 reservation. Thisattribute can have one of the following three values:

ClusterDefaultThe disk group is imported with SCSI-3reservation if the value of the cluster-level UseFenceattribute is SCSI3. If the value of the cluster-levelUseFence attribute is NONE, the disk group is importedwithout reservation.

SCSI3The disk group is imported with SCSI-3reservation if the value of the cluster-level UseFenceattribute is SCSI3.

NONEThe disk group is imported without SCSI-3reservation.

Type and dimension: string-scalar

Default: ClusterDefault

Example: "SCSI3"

Reservation

Table 2-3 Internal attributes

DescriptionAttribute

Do not use. For internal use only.tempUseFence

Number of threads used within the agent process for managingresources. This number does not include threads used for otherinternal purposes.

Do not modify this attribute for this agent.

Setting this attribute to a higher value may result in agent functiontimeouts due to serialization of underlying commands.

Type and dimension: static integer-scalar

Default: 1

NumThreads

Do not use. For internal use only.DiskGroupType

Resource type definition for DiskGroup agentThe resource definition for this agent on Solaris follows:

type DiskGroup (

static keylist SupportedActions = { "license.vfd", "disk.vfd",


32

"udid.vfd", "verifyplex.vfd", "checkudid",

"campusplex", "numdisks", "joindg", "splitdg",

"getvxvminfo", "volinuse" }

static int OnlineRetryLimit = 1

static str ArgList[] = { DiskGroup, StartVolumes,

StopVolumes, MonitorOnly, MonitorReservation, tempUseFence,

PanicSystemOnDGLoss, DiskGroupType, UmountVolumes,

Reservation, ConfidenceLevel }

str DiskGroup

boolean StartVolumes = 1

boolean StopVolumes = 1

static int NumThreads = 1

boolean MonitorReservation = 0

temp str tempUseFence = INVALID

int PanicSystemOnDGLoss = 0

str DiskGroupType = private

int UmountVolumes = 0

str Reservation = ClusterDefault

)

Notes for DiskGroup agentThe DiskGroup agent has the following notes:

High availability fire drill

Using volume sets

Setting the noautoimport flag for a disk group

Configuring the Fiber Channel adapter

High availability fire drillThe high availability fire drill detects discrepancies between the VCS configurationand the underlying infrastructure on a node. These discrepancies might preventa service group from going online on a specific node.

For DiskGroup resources, the high availability fire drill checks for:

The Veritas Volume Manager license

Visibility from host for all disks in the disk group

The same disks for the disk group on cluster nodes

Equal number of plexes on all sites for the disk group in a campus cluster setup


For more information about using the high availability fire drill see the VeritasCluster Server Administrators Guide.

Using volume setsWhen you use a volume set, set StartVolumes and StopVolumes attributes of theDiskGroup resource that contains a volume set to 1. If a file system is created onthe volume set, use a Mount resource to mount the volume set.

See the Mount agent description for more information.

Setting the noautoimport flag for a disk groupVCS requires that the noautoimport flag of an imported disk group be explicitlyset to true. This value enables VCS to control the importation and deportation ofdisk groups as needed when bringing disk groups online and taking them offline.

To check the status of the noautoimport flag for an imported disk group

# vxprint -l disk_group | grep noautoimport

If the output from this command is blank, the noautoimport flag is set to falseand VCS lacks the necessary control.

The Monitor function changes the value of the VxVM noautoimport flag from offto on. It changes the value instead of taking the service group offline. This actionallows VCS to maintain control of importing the disk group.

The following command changes the autoimport flag to false:


For VxVM versions 4.1 and 5.0 or laterThe Monitor function changes the value of the VxVM noautoimport flag from offto on. It changes the value instead of taking the service group offline. This actionallows VCS to maintain control of importing the disk group.

The following command changes the autoimport flag to false:


Configuring the Fiber Channel adapterMost Fiber Channel (FC) drivers have a configurable parameter called "failover".This configurable parameter is in the FC drivers configuration file. This parameter


34

is the number of seconds that the driver waits before it transitions a disk targetfrom OFFLINE to FAILED. After the state becomes FAILED, the driver flushes allpending fiber channel commands back to the application with an error code.Symantec recommends that you use a non-zero value that is smaller than any ofthe MonitorTimeout values of the Disk Group resources. Use this value to avoidexcessive waits for monitor timeouts.

Refer to the Veritas Dynamic Multi-Pathing Administrator's Guide for moreinformation.

Refer to the Fiber Channel adapter's configuration guide for further information.

Sample configurations for DiskGroup agent

DiskGroup resource configurationExample of a disk group resource in the Share Out mode.

DiskGroup dg1 (

DiskGroup = testdg_1

)

Debug log levels for DiskGroup agentThe DiskGroup agent uses the following debug log levels:

DBG_1, DBG_4, DBG_5

DiskGroupSnap agentUse the DiskGroupSnap agent to perform fire drills in a campus cluster. TheDiskGroupSnap agent enables you to verify the configuration and data integrityin a Campus Cluster environment with VxVM stretch mirroring. The agent alsosupports SCSI-3 fencing.

Note: The DiskGroupSnap agent requires the Global Cluster Option (GCO) licenseenabled on all systems in the cluster.

For more information on fire drills, refer to the Veritas Cluster ServerAdministrators Guide.

You must define the DiskGroupSnap agent in a separate FireDrill service groupwhich is similar to the Application service group. The FireDrill service group

35Storage agentsDiskGroupSnap agent

might contain resources similar to the Application service group, for exampleMount, Application, and so on.

The FireDrill service group must also contain a resource of type DiskGroupSnapsuch that the Mount resource depends on the DiskGroupSnap resource. The mainDiskGroup must contain multiple sites registered in it with the value of the''siteconsistent'' attribute set to on.

When the DiskGroupSnap agent goes online, the agent detaches one of the sitesfrom the main DiskGroup and imports the detached site on the fire drill host asan independent DiskGroup with a different name. The volumes on the DiskGroupare also imported and mounted with same names on the fire drill host.

The DiskGroupSnap agent provides Gold and Bronze configurations for the firedrill, which can be specified using the agent's FDType attribute. The configurationdecides the site to be detached from the DiskGroup for fire drill testing. The Goldconfiguration is the default option in which the agent selects a site from theDiskGroup that is neither the local VxVM site nor the site on which the DiskGroupis online. With the Gold configuration, you can also specify an alternate site todetach through the agent's FDSiteName attribute. With the Bronze configuration,the agent uses the local VxVM site name as the site to detach from the DiskGroup.

For important information about this agent, See Notes for DiskGroupSnap agenton page 39.

Dependencies for DiskGroupSnap agentThe DiskGroupSnap resource does not depend on any other resources. The servicegroup that contains the DiskGroupSnap agents resource has an offline localdependency on the applications service group. The offline local dependency isto make sure the firedrill service group and the application service group are notonline at the same site at the same time.

Storage agentsDiskGroupSnap agent

36

Figure 2-2 Sample service group that includes a DiskGroupSnap resource

Offline local dependency

App

lication

servicegrou

pFire

drill

servicegrou

p

Application

Mount

DiskGroupSnap

Application

Mount

DiskGroup

Agent functions for DiskGroupSnap agent

Verifies that the applications disk group is in a valid campus clusterconfiguration. It detaches the site that the value of the FDSiteNameattribute specifies. It then creates another disk group to be used forthe fire drill on the detached site. After the completion of Onlinefunction, the agent creates a lock file in the lock directory(/var/VRTSvcs/lock) to indicate that the resource is online.

Online

This re-attaches the site that the value of the FDSiteName attributespecifies back to the applications disk group. After the completion ofOffline function the agent removes the lock file from the lock directory(/var/VRTSvcs/lock) to indicate that the resource is Offline.

Offline

Monitors the DiskGroupSnap resource by checking the existence ofthe Lock file in /var/VRTSvcs/lock directory..

Monitor

Takes the DiskGroupSnap resource offline.Clean

If the DiskGroupSnap resource has a parent resource that is notONLINE, then it deletes the online lock file of the DiskGroupSnapresource. This marks the DiskGroupSnap resource as OFFLINE.

Open

State definitions for DiskGroupSnap agent

The DiskGroupSnap resource functions normally.ONLINE

The DiskGroupSnap resource is not running.OFFLINE

37Storage agentsDiskGroupSnap agent

A configuration error exists.UNKNOWN

The DiskGroupSnap resource is taken offline unexpectedly outside ofVCS control.

FAULTED

Attributes for DiskGroupSnap agent

Table 2-4 Required attributes

DescriptionRequiredattribute

The name of the DiskGroup resource from the application servicegroup.

Type-dimension: string-scalar

Example: "dgres"

TargetResName

Specifies the configuration to be used for the fire drill. The possiblevalues for this attribute are:

Bronze

Gold (default)

The Bronze configuration uses the local host's VxVM site name as thesite to be detached from the DiskGroup. This action leaves theDiskGroup vulnerable to site disaster since a copy of the productionvolume might not be available when the fire drill is in progress.

In the Gold configuration there are at least three copies of the parentvolume available on different sites, hence, even after detaching onesite the volume is not vulnerable to site disaster while the fire drill isin progress.

FDType

Vcs Bundled Agents 60 Sol

Documents

Transcript of Vcs Bundled Agents 60 Sol