Maintenance Commands Hagrp (1M)
Name Hagrp - Perform VCS Service Group Operations
Synops Hagrp -Add Group
HAGRP -AUTOENABLE GROUP -SYS SYSTEM
Hagrp-Clear Group [-sys system]
HAGRP-DELETE GROUP
HAGRP-DEP [Group (s)]
HAGRP -DISABLE Group [-sys system]
HAGRP-Disableresources Group
Hagrp -display [group] [-ttribute attribute (s)] [- SYS System (s)]
Hagrp -ENable group [-sys system]
HAGRP -ENABLESOURES GROUP
HAGRP-Flush Group -sys System
HAGRP -FREEZE Group [-Persistent]
HAGRP -HELP [-Modify | -Link | -List]
HAGRP -LINK PARENT_GROUP CHILD_GROUP DepENDENCY
HAGRP -LIST [Conditional (s)]
HAGRP -MODIFY MODIFY_OPTIONS
Hagrp -offline group -sys system
Hagrp [-nopre] -online group -sys system
HAGRP -RESOURFES GROUP
HAGRP -STATE Group -Sys system
HAGRP -SWITCH Group -to System
HAGRP -UNFREEZE Group [-Persistent]
HAGRP -UNLINK PARENT_GROUP CHILD_GROUP
VCS 2.0 Last Change: January 2002 1
Maintenance Commands Hagrp (1M)
HAGRP -VALUE Group Attr [SYSTEM]
Availability VRTSVCCS
DESCRIPTION A service group is an instance of a computer service that is made highly available with VCS. A group comprises one or more resources of various resource types, such as disks, volumes, or databases. Use the hagrp command to view infor- mation about And manage each group.
Options -add Group Add a service group to the cluster.
-autoenable group -sys system When VCS does not know the status of a given ser- vice group on a given system, it marks that ser- vice group as auto-disabled by setting the AutoDisabled attribute to 1 for that system. This can happen if VCS is not running on that system, or if all the resources in the service group on that system are not probed yet. A service group can not be onlined or failed over if it is auto- disabled.If you want to override this behavior, you can use the autoenable option to clear the AutoDisabled flag for a service group on a system. for example, "hagrp -autoenable foo -sys bar" will clear the AutoDisabled flag for the service group foo on system bar.
CAUTION:. To bring a group online manually after VCS has autodisabled it, make sure that the group is not fully or partially active on any system that has the AutoDisabled attribute set to 1 by VCS Specifically, verify that all resources that may be corrupted by Being Active ON Multiple Sys- Tems Are Brought Down On The Designated Systems. Then, Clear The Autodisabled Attribute for Each System:
# haGrp -autoenable service_group -sys system_name
-clear group [-sys system] Clear all faulted, non-persistent resources in the specified group by changing their state from faulted to offline If no system is specified, all resources are cleared on all systems in theVCS 2.0 Last change:. January 2002 2
Maintenance Commands Hagrp (1M)
Group's systemlist. a message isprinted if no faulted, non-personistent resources exist.
-delete group delete a service group. The group must resources, Use the Hares Command.
-DEP [Group (s)] Display Dependencies Between Groups.
-disable group [-sys system] disable a service group. Actions Such as Onlineing and Switch Are Not Permitted on The Group.
-disableresources Group disable all resources in a service group. Agents do not monitor the resources in the group.
-display [group] [-ttribute attribute (s)] [-sys system (s)]
Display The Attributes and Their Values for a Specified Group (OR All Groups, if no group isot specified).
-enable group [-sys system] enable a service group.
--enableresources Group enable all resources in a service group. Agents Monitor The Resources in the group.
-flush group -sys system Flush a service group and enable corrective action. All resources in the group that are waiting to go online automatically transition to not waiting. Resources waiting to go offline remain in that state. Failovers and switches in progress are Cancelled.-freeze group [-persistent] Freeze a service group (Disables Onlineing and Off "and failover).
-help [-modify | -link | -list] Display information about using hagrp The -modify option provides modify specific help; the -link option provides link specific help; the -list option provides list specific help..
-LINK PARENT_GROUP CHILD_GROUP Dependency Specify Dependencies Between Service Groups. The
VCS 2.0 Last Change: January 2002 3
Maintenance Commands Hagrp (1M)
Variable Dependency is One of the Following:
Online Global [Soft] When VCS Starts, The Child Group Must Be Online On Some System in The Cluster Before The Parent Group Can CAN com Online.
With the dependency set to firm, if the child group faults, the parent group must go off- line until the child group fails over to another system, at which time the parent can return online. If VCS can not bring the child group online in the Cluster, The Parent Group Remains Offline.
With the dependency set to soft, if the child group faults and fails over, the parent group continues online If VCS can not bring the child group online in the cluster, the parent group remains online.online local [firm | soft]. When VCS starts .
With the dependency set to firm, if the child group faults, the parent group must go off- line. If the child fails over, the parent group comes back online on the same system as the child. If VCS can not bring the child group online In The Cluster, The Parent Group Remains Offline.
With the dependency set to soft, if the child group faults, the parent group continues to run on the local system until the child fails over to another system in the cluster, at which time the parent group will fail over to the same system as the CHILD. IF VCS Cannot Bring The Child Group Online In The Cluster, The Parent Group Remains Online.
Online Remote [Soft] When VCS Starts, The Child Must Be Online On Any Other System in The Cluster Before The Parent Can Go Online.
With the dependency set to firm, if the child group faults, The Parent Group Goes Offline.
VCS 2.0 Last Change: January 2002 4Maintenance Commands Hagrp (1M)
When the child group fails over to another system in the cluster, the parent group comes back online on a system other than the system on which the child is online. If VCS can not bring the child group online in the cluster, the parent group remains offline .
With the dependency set to soft, if the child group faults, the parent group continues online unless VCS attempts to fail over the child group to the system on which the parent group is running; in this case, the parent group is taken offline, to Be Onlined Else- Where. if the child group cannot Go Online Anywhere In The Cluster, The Parent Stays Online.
OFFLINE LOCAL THE Child Group Must Be Offline On The Same System Before The Parent Group Can Go Online.
A Group Dependency Tree May Be at Most Three Lev- Els Deep, And Each Parent Can Have Only One Child.
Parallel parent groups dependent on parallel child groups are not supported in online global or online remote dependencies. The configuration of parallel parent groups dependent on a failover child group is not supported in online local dependencies.
-list [conditional (s)] Displays a list of groups whose values match given conditional statement (s) Conditional state- ments can take three forms:.!. Attribute = Value, Attribute = Value, Attribute = ~ Value Multiple conditional statements imply AND logic. If no condi- tional statement is specified, all groups in the cluster are listed.-modify modify_options The -modify option lets you modify a service group's attributes. you must make the configura- tion read-write before modifying any attributes. Some attributes, such as ProbesPending, are inter- nal to VCS and can not be modified. You can modify any attribute that can be configured in main.cf. Modifiable attributes can be of any type or dimen- sion, and can be global Or Local to a System. Use "Hagrp -help-modify" to find out details SYNTAX
VCS 2.0 Last Change: January 2002 5
Maintenance Commands Hagrp (1M)
TO Modify Attributes of Any Dimension. Modifying Some Attributes May Have Subtle Implications. Look at Documentation ON Individual Attribute for Details.
-offline Group -sys System Stop a Service Group by Taking Its Resources Off- Line on The Specified System.
-online [-nopre] group -sys system Start a service group by bringing its resources online. Resources that have their AutoStart attri- bute set to zero (the default is one) are not started by this command unless resources that have AutoStart set to one depend on the resources. The -nopre option can be used within a user-defined PreOnline event trigger script to bring a service group online without the executing the PreOnline trigger again.-resources group List resources for a service group.
-state Group -sys System Display The Current State of The Specified Group on The Specified System.
-switch group -to system Switch a service group from the system on which it is active to the specified system. This applies only to failover groups (groups that have the Parallel attribute set to zero).
-unfreeze group [-persistent] Thaw a service group (reenable online, offlin- ing, and failover).
-unlink parent_group child_group Remove Dependencies Between Two Service Groups. Note That The Dependency is not specific.
-value group attr [system] The -value option provides the value of a single group attribute. For example, "hagrp -value groupX State sysb" displays the value of the State attribute for group groupX on system sysb. The system name must be . specified for local attribute values but not for global attribute values The -value option is used instead of the -display option when one specific attribute value is needed rather than a table of many attribute values.VCS 2.0 Last change: January 2002 6
Maintenance Commands Hagrp (1M)
Examples to Online Group DB_GRP on System Thor01, Enter:
# haGrp -online db_grp -sys thor01
NOTES The VCS server may ignore some hagrp commands. For example, VCS does not allow you to online a failover service group on a system if the group is online elsewhere in the cluster, or if the group is faulted on that system.
See Also Hares (1M)
VCS 2.0 Last Change: January 2002 7
