Vcs Bundled Agents 601 Sol

8/12/2019 Vcs Bundled Agents 601 Sol

1/306

VeritasCluster Server 6.0.1

Bundled Agents ReferenceGuide - Solaris

September 2012


2/306

Veritas Cluster Server Bundled Agents Reference Guide

Thesoftwaredescribedin this book is furnishedundera license agreement andmaybe used

only in accordance with the terms of the agreement.

Product version: 6.0.1

Document version: 6.0.1 Rev 1

Legal Notice

Copyright 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 of

Symantec corporation or its affiliates in the U.S. and other countries. Other names may be

trademarks of their respective owners.The product described in this document is distributed under licenses restricting its use,

copying, distribution, and decompilation/reverse engineering. No part of this document

may be reproduced in any form by any means without prior written authorization of

Symantec Corporation and its licensors, if any.

THE DOCUMENTATIONIS PROVIDED"ASIS" ANDALL EXPRESS ORIMPLIED 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

BELEGALLYINVALID. SYMANTECCORPORATION SHALL NOTBELIABLEFORINCIDENTAL

OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING,

PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINEDIN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE.

TheLicensedSoftwareand Documentation are deemedto be commercial computer software

as defined in FAR12.212 andsubjectto restricted rights as defined in FARSection 52.227-19

"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, "Rights in

Commercial Computer Software or Commercial Computer Software Documentation", as

applicable, and any successor regulations. Any use, modification, reproduction release,

performance,display or disclosure of theLicensedSoftwareandDocumentation by theU.S.

Government shall be solely in accordance with the terms of this Agreement.


3/306

Symantec Corporation

350 Ellis Street

Mountain View, CA 94043

http://www.symantec.com
http://www.symantec.com/http://www.symantec.com/


4/306

Technical Support

Symantec Technical Support maintains support centers globally. Technical

Supports primary role is to respond to specific queries about product features

andfunctionality. The Technical Support group also createscontentfor ouronline

Knowledge Base. The Technical Support group works collaboratively with the

other functional areas within Symantec to answer your questions in a timely

fashion.Forexample,theTechnicalSupport groupworkswith Product Engineering

andSymantec Security Response to provide alerting services andvirus definition

updates.

Symantecs support offerings include the following:

A range of support options that give you the flexibility to select the right

amount of service for any size organization Telephone and/or Web-based support that provides rapid response and

up-to-the-minute information

Upgrade assurance that delivers software upgrades

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

days a week basis

Premium service offerings that include Account Management Services

For information about Symantecs support offerings, you can visit our Web site

at the following URL:

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

All support services will be delivered in accordance with your support agreement

and the then-current enterprise technical support policy.

Contacting Technical Support

Customers with a current support agreement may access Technical Support

information 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 be

at thecomputer on which theproblem occurred, in case it is necessaryto replicate

the problem.

When you contact Technical Support, please have the following information

available:

Product release level
http://www.symantec.com/business/support/index.jsphttp://www.symantec.com/business/support/contact_techsupp_static.jsphttp://www.symantec.com/business/support/contact_techsupp_static.jsphttp://www.symantec.com/business/support/index.jsp


5/306

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 registration

If your Symantecproduct requires registrationora license key, accessourtechnical

support Web page at the following URL:

www.symantec.com/business/support/

Customer service

Customer service information is available at the following URL:

www.symantec.com/business/support/

Customer Service is available to assist with non-technical questions, such as the

following types of issues:

Questions regarding product licensing or serialization

Product registration updates, such as address or name changes

General product information (features, language availability, local dealers)

Latest information about product updates and upgrades

Information about upgrade assurance and support contracts

Information about the Symantec Buying Programs

Advice about Symantec's technical support options

Nontechnical presales questions

Issues that are related to CD-ROMs or manuals
http://www.symantec.com/business/support/http://www.symantec.com/business/support/http://www.symantec.com/business/support/http://www.symantec.com/business/support/


6/306

Support agreement resources

If you want to contact Symantec regarding an existing support agreement, please

contact 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

Documentation

Product guides are available on the media in PDF format. Make sure that you are

using the current version of the documentation. The document version appears

on page 2 of each guide. The latest product documentation is available on the

Symantec Web site.

https://sort.symantec.com/documents

Your feedback on product documentation is important to us. Send suggestions

for improvements and reports on errors or omissions. Include the title and

document version (located on the second page), and chapter and section titles of

the text on which you are reporting. Send feedback to:

[email protected]

For information regarding the latest HOWTO articles, documentation updates,

or to ask a question regarding product documentation, visit the Storage andClustering Documentation forum on Symantec Connect.

https://www-secure.symantec.com/connect/storage-management/

forums/storage-and-clustering-documentation

About Symantec Connect

Symantec Connect is the peer-to-peer technical community site for Symantecs

enterprise customers. Participantscanconnect andshare information with other

product users, including creating forum posts, articles, videos, downloads, blogs

and suggesting ideas, as well as interact with Symantec product teams and

Technical Support. Content is rated by the community, and members receivereward points for their contributions.

http://www.symantec.com/connect/storage-management
mailto:[email protected]:[email protected]:[email protected]://sort.symantec.com/documentsmailto:[email protected]://www-secure.symantec.com/connect/storage-management/forums/storage-and-clustering-documentationhttps://www-secure.symantec.com/connect/storage-management/forums/storage-and-clustering-documentationhttp://www.symantec.com/connect/storage-managementhttp://www.symantec.com/connect/storage-managementhttps://www-secure.symantec.com/connect/storage-management/forums/storage-and-clustering-documentationhttps://www-secure.symantec.com/connect/storage-management/forums/storage-and-clustering-documentationmailto:[email protected]://sort.symantec.com/documentsmailto:[email protected]:[email protected]:[email protected]


7/306

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

Chapter 1 Introducing Bundled agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .19

About Bundled agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

Resources and their attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . .20

Modifying agents and their resources.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .20

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .20Zone-aware agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

IMF aware agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Enabling debug log messages.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .22

Chapter 2 Storage agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

About the storage agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . .25

DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

Dependencies for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .26

Agent functions for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .26

State definitions for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .28Attributes for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .28

Resource type definition for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .34

Notes for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .35

Sample configurations for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Debug log levels for DiskGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .37

DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Dependencies for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .38

Agent functions for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39

State definitions for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39

Attributes for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .39

Notes for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .41

Resource type definition for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . .45

Sample configurations for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . .45

Debug log levels for DiskGroupSnap agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52

Disk agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . 52

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52

State definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52

Contents


8/306

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..53

Resource type definition... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . .53

Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53

Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .53Dependencies for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .54

Agent functions for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .54

State definitions for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .54

Attributes for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .55

Resource type definition for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

Sample configuration for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

Debug log levels for Volume agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .56

VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56

Dependencies for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .56

Agent functions for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .56

State definitions for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .57Attributes for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .57

Resource type definition for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .57

Sample configurations for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58

Agent notes for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .58

Inaccessible volumes prevent the VolumeSetagentfromcoming

online.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58

Debug log levels for VolumeSet agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .58

Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 58

Dependencies for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . .59

Agent functions for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .60State definitions for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .62

Attributes for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .62

Resource type definition for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68

Notes for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .68

High availability fire drill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .69

VxFS file system lock.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . .69

IMF usage notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70

IPv6 usage notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70

Support for loopback file system... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .70

Enabling Level two monitoring for the Mount agent.. . . . . . . . . . . . . . . . . . . .72

ZFS file system and pool creation example.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72Sample configurations for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .73

Debug log levels for Mount agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .73

Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .73

Limitations for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . .74

Dependencies for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .74

Agent functions for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .74

State definitions for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .75

Contents8


9/306

Attributes for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .76

Resource type definition for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78

Sample configurations for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .79

Debug log levels for Zpool agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .80

Chapter 3 Network agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81

About the network agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . .81

Agent comparisons.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .81

IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .83

High availability fire drill for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..83

Dependencies for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . .83

Agent functions for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .84

State definitions for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .84

Attributes for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .85Resource type definition for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .87

Sample configurations for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .88

Debug log levels for IP agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .88

NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . 89

High availability fire drill for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .89

Dependencies for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .89

Agent functions for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .90

State definitions for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .90

Attributes for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . .91

Resource type definition for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .92

Sample configurations for NIC agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .93

Exclusive IP Zone configuration for NIC agent .. . . . . . . . . . . . . . . . . . . . . . . . . . .94

Debug log levels for NIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .95

IPMultiNIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95

Dependencies for IPMultiNIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .96

Agent functions for IPMultiNIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .96

State definitions for IPMultiNIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .96

Attributes for IPMultiNIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .97

Resource type definition for IPMultiNIC agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .98

Sample configuration: IPMultiNIC and MultiNICA... . . . . . . . . . . . . . . . . . . . . .99

Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .100MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100

Dependencies for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .100

Agent function for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .101

State definitions for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

Attributes for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .101

Resource type definition for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . .104

Notes for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .105

Contents


10/306

Using RouteOptions for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Sample configurations for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

Debug log levels for MultiNICA agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .108

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

IPMultiNICB agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Dependencies for IPMultiNICB agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110

Requirements for IPMultiNICB... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .110

Agent functions for IPMultiNICB agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .110

State definitions for IPMultiNICB agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .111

Attributes for IPMultiNICB agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .111

Resource type definition for IPMultiNICB agent.. . . . . . . . . . . . . . . . . . . . . . . .114

Manually migrating a logical IP address for IPMultiNICB

agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..114

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

MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115

Base and Multi-pathing modes for MultiNICB agent .. . . . . . . . . . . . . . . . . .116

Oracle trunking for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .116

The haping utility for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116

Dependencies for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .116

Agent functions for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .117

State definitions for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .117

Attributes for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .117

Optional attributes for Base and Mpathd modes for MultiNICBagent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119

Optional attributes for Base mode for MultiNICB agent .. . . . . . . . . . . . . .120

Optional attributes forMulti-pathing mode for MultiNICBagent

... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124

Resource type definition for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . .125

Solaris operating modes: Base and Multi-Pathing for MultiNICB

agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126

Base mode for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .126

Failover and failback for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

Multi-Pathing mode for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

Configuring MultiNICB and IPMultiNICB agents on Solaris11... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .128

Trigger script for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .128

Sample configurations for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .129

Debug log levels for MultiNICB agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..132

DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .132

Dependencies for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .132

Agent functions for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .133

Contents10


11/306

State definitions for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .134

Attributes for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .135

Resource type definition for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141

Agent notes for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . .141Sample configurations for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .146

Debug log levels for DNS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .148

Chapter 4 File share agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149

About the file service agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .149

NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .149

Dependencies for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .150

Agent functions for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .150

State definitions for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .151

Attributes for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .151Resource type definition for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .152

Notes for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .153

Sample configurations for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .154

Debug log levels for NFS agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .154

NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155

Dependencies for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .155

Agent functions for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .156

State definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .157

Attributes for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .158

Resource type definition for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . .159

Notes for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .159

Sample configurations for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .162

Debug log levels for NFSRestart agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .163

Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .163

Dependencies for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .164

Agent functions for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .164

State definitions for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .165

Attributes for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .165

Resource type definition for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166

Notes for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . .166

Sample configurations for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .166Debug log levels for Share agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .166

About the Samba agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . .167

The Samba agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . .167

Before using the Samba agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .167

Supported versions for Samba agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .168

Notes for configuring the Samba agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168

SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169

Contents


12/306

Dependencies for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .169

Agent functions for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .169

State definitions for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169

Attributes for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .170Resource type definitions for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . .172

Sample configurations for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . .172

Debug log levels for SambaServer agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172

SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172

Dependencies for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .173

Agent functions for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .173

State definitions for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173

Attributes for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .174

Resource type definition for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . .174

Sample configuration for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .174

Debug log levels for SambaShare agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175

Dependencies for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .175

Agent functions for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .176

State definitions for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .176

Attributes for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .177

Resource type definition for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178

Sample configuration for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .178

Debug log levels for NetBios agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .179

Chapter 5 Service and application agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181About the services and applications agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .181

Apache HTTP server agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . .181

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .183


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 184

Resource type definition... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . .188

Apache HTTP server notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .189

Sample configurations.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .192

Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194High availability fire drill for Application agent.. . . . . . . . . . . . . . . . . . . . . . . .195

Dependencies for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .195

Agent functions for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .195

State definitions for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197

Attributes for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .198

Resource type definition for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . .201

Notes for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . .202

Contents12


13/306

Sample configurations for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .204

Debug log levels for Application agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .205

CoordPoint agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206

Coordination Point server as a coordination point.. . . . . . . . . . . . . . . . . . . . .206SCSI-3 based disk as a coordination point .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .207


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 208

Resource type definition... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .208

Notes for the CoordPoint agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .209

Sample configuration... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . .210

Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .210

Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . 210

High availability fire drill for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211Dependencies for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .211

Agent functions for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .211

State definitions for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .212

Attributes for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .213

Resource type definition for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213

Usage notes for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .213

Sample configurations for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214

Debug log levels for Process agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .215

ProcessOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .215


Attributes .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216


ProcessOnOnly agent usage notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .217

Sample configurations .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .217

Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .217

Zone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .217

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .220

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 221Configuring the Zone agent for DR in a Global Cluster

environment.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . 225


Zone agent notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225

Using the Zone agent with IMF... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .226


Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .227

Contents


14/306

LDom agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .228

Configuring primary and guest domain dependenciesandfailure

policy.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .228

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .229


Attributes .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230

Configuring the LDom agent for DR in a Global Cluster

environment.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . 234


LDom agent notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235

About the auto-boot? variable.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .235


Sample configuration 2.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .235

Configuration (future LDom migration).. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .236Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .236

Project agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 236

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .237

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 237


Sample configuration... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . .238

Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .239

AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239

Dependencies for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 239Agent functions for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240

State definitions for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .241

Attributes for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .241

Resource type definition for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . .242

Sample configurations for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .242

Debug log levels for AlternateIO agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .245

Chapter 6 Infrastructure and support agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

About the infrastructure and support agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

NotifierMngr agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247Dependency... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .248


Attributes .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248


Sample configuration... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . .251

Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .253

Contents14


15/306

Proxy agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .253

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .254

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 254Resource type definition... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .255


Debug log levels .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256

Phantom agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 256

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .257



RemoteGroup agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258

Dependency... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .259State definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .259

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 260


Debug log levels.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .265

Chapter 7 Testing agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267

About the testing agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .267

ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..267

Dependencies for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .267

Agent function for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .268

State definitions for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .268

Attributes for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .268

Resource type definition for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . .269

Sample configuration for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269

Debug log levels for ElifNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . .269

FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269

Dependencies for FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .269

Agent functions for FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .270

State definitions for FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .270

Attribute for FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .270Resource type definition for FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . .270

Sample configuration for FileNone agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270

Debug log levels for FileNone agent .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .271

FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..271

Dependencies for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .271

Agent functions for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .271

State definitions for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .272

Contents


16/306

Attribute for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . .272

Resource type definition for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . .272

Sample configuration for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272

Debug log levels for FileOnOff agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .272FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273

Dependencies for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .273

Agent functions for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..273

State definitions for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273

Attribute for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .274

Resource type definition for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . .274

Sample configuration for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274

Debug log levels for FileOnOnly agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274

Chapter 8 Replication agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . .275

About the replication agents.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .275

RVG agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .275

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .276

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .277


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 277

Resource type definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .278


RVGPrimary agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .280


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 281



RVGSnapshot.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .286

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .286


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 287

Resource type definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .287Sample configurations.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .288

RVGShared agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .289


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 290


Contents16


17/306


RVGLogowner agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .290

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .291State definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .292

Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 292


RVGLogowner agent notes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .293


RVGSharedPri agent.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294

Dependencies.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295

Agent functions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .295


Attributes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 296

Resource type definitions.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .297Sample configurations.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .297

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299

Contents


18/306

Contents18


19/306

Introducing Bundled 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 agentsareVeritas Cluster Server(VCS) processesthat manageresources

of predefined resource types according to commands received from the VCS

engine, 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 from

VCS. 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


20/306

For a more detailed overview of how agents work, refer to theVeritas Cluster

Server Administrators Guide.

Resources and their attributesResources are parts of a system. They are known by their types, for example: a

volume, 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 has

a corresponding agent that controls the resource.

The VCSconfiguration file, main.cf,contains the values forthe resource attributes

and 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.Forexample, the IP agent uses the Address attribute

to determine the IP address to monitor.

Modifying agents and their resourcesUse the Cluster Manager (Java Console), Veritas Operations Manager, or the

command line to dynamicallymodifytheconfiguration of the resourcesmanaged

by 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 Guidefor instructions on how to

complete these tasks.

AttributesAttributes contain data about the cluster, systems, service groups, resources,

resource types,and the agent. An attribute has a definitionand a value. You change

attribute values to configure VCS resources. Attributes are either optional or

required, although sometimes attributes that are optional in one configurationmight be required in other configurations. Many optional attributes have

predefined or default values, which you should change as required.

A variety of internal use only attributes also exist. Do not modify these

attributesmodifying 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, while

others are simple boolean on/off values.

Introducing Bundled agentsResources and their attributes

20


21/306


22/306

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

types(continued)

PassCInfoRunInContainerResource Type

01Apache

10IP

10IPMultiNIC

10IPMultiNICB

00Mount

10NIC

01Process

10Zone

01ProcessOnOnly

10Project

For more informationon usingzones in your VCS environment, referto theVeritas

Storage Foundation andHigh Availability SolutionsVirtualization Guide.

IMF aware agents Application agent. See Application agenton page 194.

DiskGroup agent. See DiskGroup agenton page 25.

Mount agent. See Mount agenton page 58.

Process agent. See Process agenton page 210.

Zone agent. See Zone agenton page 217.

Enabling debug log messagesTo help troubleshoot agent issues, youcanenabledebuglog messages in theagent

framework as well as the agents.

To enable agent framework debug log messages:

# hatype -modify agent_name LogDbg -add DBG_AGDEBUG DBG_AGINFO

DBG_AGTRACE

Introducing Bundled agentsIMF aware agents

22


23/306

For example:

# hatype -modify Mount LogDbg -add DBG_AGDEBUG DBG_AGINFO DBG_AGTRAC

To enable agent-specific debug log messages:

# 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

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 for

Mount agenton page 73.

Introducing Bundled agentsEnabling debug log messages


24/306

Introducing Bundled agentsEnabling debug log messages

24


25/306

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 sharedstorage andmake sharedstorage highlyavailable.

Storage includes shared disks, disk groups, volumes, and mounts.

DiskGroup agentThe DiskGroup agent brings online, takes offline, and monitors Veritas Volume

Manager (VxVM) disk groups. This agent uses VxVM commands. You can use this

agent to monitor or make disk groups highly available.

When thevalue of theStartVolumesandStopVolumes attribute is 1, theDiskGroup

agent brings the volumes online and takes them offline during the import and

deport operations of the disk group.

2Chapter


26/306

This agent is IMF-aware and uses asynchronous monitoring framework (AMF)

kernel driver for IMF notification. For more information about the Intelligent

Monitoring Framework (IMF) and intelligent resource monitoring, refer to the

Veritas Cluster Server Administrators Guide.

For important information on this agent, See Notes for DiskGroup agent

on page 35.

Dependencies for DiskGroup agent

The 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 vxdg

command. The Monitor function changes the value of the VxVM

noautoimport flag from off to on. This action allows VCS to

maintaincontrol of importing thediskgroup. Themonitorfunction

uses following command to set the noautoimport flag to on.

# vxdg -g disk_group set autoimport=no

If IMF is enabled for the DiskGroup agent, the resource is

monitoredasynchronously andany change in thediskgroup state

is immediatelysent to theDiskGroup agent forappropriateaction.

Monitor

Terminates all ongoing resource actions and takes the resource

offlineforcibly when necessary.

Clean

Storage agentsDiskGroup agent

26


27/306

The DiskGroup info agent function gets information from the

Volume Manager and displays the type and free size for the

DiskGroup resource.

Initiate the info agent function by setting the InfoInterval timingto a value greater than 0.

In the following example, the info agent function executes every

60 seconds:

# haconf -makerw

# hatype -modify DiskGroup InfoInterval 60

The command to retrieve information about the DiskType and

FreeSize of 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 not

found use the vxlicinst utility to install a valid license key.

disk.vfd

Checks if all disks in diskgroup are visible on hostif it fails,

check ifthe path todisksexists from the host and check ifLUN

masking and zoning are set properly.

udid.vfd

Checks the UDIDs (unique disk identifiers) of disks on the

cluster nodesif it fails, ensure that the disks that are used for

the disk group are the same on all cluster nodes.

verifyplex.vfd

Checks if the number of plexes on each site for the Campus

Cluster setup are set properlyif it fails, check that the sites,

disks, and plexes are set properly for a Campus Cluster setup.

volinuse

Checks if open volumes are in use or file systems on volumes

that are mounted outside of VCS configuration.

See High availability fire drillon page 35.

Action



28/306

Initializes the agent to interface with Intelligent monitoring

framework (IMF). The function runs when the agent starts up.

imf_init

Waits fornotification about disk group state changes. Thefunction

runs after the agent initializes with IMF. The function waits for

notification. Upon receiving notification, the agent takes action

on the resource.

imf_getnotification

Registers the resource entities, which the agent must monitor

using IMF. Thefunction runs for each resource after theresource

goes into a steady state, either online or offline.

imf_register

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 become

disabled.

FAULTED

Indicates that a problem exists either with the configuration or the

ability to determine the status of the resource. One cause of this state

is when I/O fencing is not configuredthe cluster level attribute

UseFence is not set to "SCSI3" but the Reservation attribute value is

"SCSI3".

UNKNOWN

Attributes for DiskGroup agent

Table 2-1 Required attributes

DescriptionRequired

attribute

Name of the disk group that is configured with Veritas Volume

Manager.

Type and dimension: string-scalar

DiskGroup


28


29/306

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 the

reservation is missing, the monitor agent function takes

the service group containing the resource offline.

Type and dimension: boolean-scalar

Default: 0

Note: If theMonitorReservationattribute is setto 0, and

the value of the clusterwide attribute UseFence is set to

SCSI3, and the disk group is imported without SCSI

reservation, then the monitor agent function takes the

service group containing the resource offline.

MonitorReservation



30/306

Table 2-2 Optional attributes(continued)


PanicSystemOnDGLoss


30


31/306



Determines whether to panic the node if the disk groupbecomes disabled or monitor operation times out. A loss

ofstorage connectivitycan causethedisk group to become

disabled. VxVM commands not responding properly can

cause monitor operation to timeout.

Note: Systemadministratorsmay want to seta high value

for FaultOnMonitorTimeoutto increase systemtolerance.

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

0: Do not halt the system

1: halt the system if either disk group goes into

disabled state or the disk group resource faults due to

monitor timeout

2: halt thesystem only if disk group goes into disabled

state

3: halt the system only if disk group resource faults

due to monitor timeout

If the value of the attribute is 0, and the disk group

becomes disabled, the following occurs:

If the cluster has I/O fencing enabled (Cluster level

attributeUseFenceset toSCSI3),the monitor operation

on the DiskGroup resource is reported OFFLINE. Thisresults in theagentto call clean to take theDiskGroup

resource offline.

As part of bringing the DiskGroup resource offline,

the agent attempts to deport the disabled disk group.

Theclean operationsucceeds even if thedisabled disk

group fails to deport and the DiskGroup resource

enters into FAULTED state. This state enables the

failover of the service group that contains the

DiskGroup resource. To fail back the service group

containing the DiskGroup resource, manually deport

the disk group after restoringstorage connectivity on

the failed node.

If the cluster does not use I/O fencing, a message is

logged and the resource is reported ONLINE. The

resource is reported ONLINE so that it does not fail

over, which ensures data integrity.

Notes:

ThePanicSystemOnDGLossattributedoesnot depend



32/306



on the MonitorReservation attribute. Symantec recommends to configure volume resource

for each volume in the diskgroup to detect storage

connectivity loss more effectively.

If PanicSystemOnDGLoss is set to non-zero value, the

systempanic is initiatedusinguadmin 5 0 command.

This command halts the system. An administrator

needs to bring up the system.

Type and dimension: integer-scalar

Default: 0

If value of this attribute is 1, the DiskGroup online

function starts all volumes belonging to that disk group

after importing the group.

Note: With VxVM version 5.1.100.0onwards, if theVeritas

VolumeManager default autostartvolumesat system level

is set to on, all the volumes of the disk group will be

started 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 deports

the disk group.


Default: 1

StopVolumes


32


33/306



This attribute enables the DiskGroup resource toforcefully go offline even if open volumes are mounted

outside of VCS control. When the value of this attribute

is 1 and the disk group has open volumes, the following

occurs:

The agent attempts to unmount the file systems on

open volumes. If required, the agent attempts to kill

all VCS managed and un-managed applications using

the file systems on those open volumes.

The agent attempts to forcefully unmount the file

systems to close the volumes.

Type and dimension: integer-scalar

Default: 0

UmountVolumes

Determines if you wantto enable SCSI-3 reservation.This

attribute can have one of the following three values:

ClusterDefaultThe disk groupis importedwith SCSI-3

reservation if the value of the cluster-level UseFence

attribute is SCSI3. If the value of the cluster-level

UseFence attributeisNONE, thedisk group is imported

without reservation.

SCSI3

The disk group is imported with SCSI-3reservation if the value of the cluster-level UseFence

attribute is SCSI3.

NONEThe disk group is imported without SCSI-3

reservation.

Type and dimension: string-scalar

Default: ClusterDefault

Example: "SCSI3"

Reservation

Table 2-3 Internal attributes

DescriptionAttribute

Do not use. For internal use only.tempUseFence



34/306

Table 2-3 Internal attributes(continued)

DescriptionAttribute

The number of threads that are used within the agent process formanaging resources. This number does not include the number of

threads that are used for other internal purposes.

Setting theNumThreads attribute to a higher value may decrease the

time required to go online or the time required to monitor a large

number of DiskGroup resources.

Type and dimension: static integer-scalar

Default: 1

Note: If there are many DiskGroup resources andif the resourcesare

taking moretime to comeonline, consider increasingtheNumThreads

attribute to a value greater than 1.

NumThreads

The attribute is deprecated.DiskGroupType

Resource type definition for DiskGroup agent

The resource definition for this agent on Solaris follows:

type DiskGroup (

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

"verifyplex.vfd", checkudid, numdisks, campusplex, volinuse,

joindg, splitdg, getvxvminfo }

static int OnlineRetryLimit = 1

static str ArgList[] = { DiskGroup, StartVolumes, StopVolumes, MonitorOn

MonitorReservation, tempUseFence, PanicSystemOnDGLoss, DiskGroupType,

UmountVolumes, Reservation, ConfidenceLevel }

static str IMFRegList[] = { DiskGroup, Reservation }

static int IMF{} = { Mode = 3, MonitorFreq = 5, RegisterRetryLimit = 3 }

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


34


35/306


36/306

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

# vxprint -l disk_group | grep noautoimport

If the output fromthis command is blank, the noautoimport flagis set to false

and VCS lacks the necessary control.

The Monitor function changes the value of the VxVM noautoimport flag from off

to on. It changes the value instead of taking the service group offline. This action

allows 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 later

The Monitor function changes the value of the VxVM noautoimport flag from off

to on. It changes the value instead of taking the service group offline. This action

allows 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".

Thisconfigurableparameteris in theFC drivers configuration file. Thisparameter

is the number of seconds that the driver waits before it transitions a disk target

from OFFLINE to FAILED. After the state be

Documents

Vcs Bundled Agents 601 Sol