| Note: it is not recommended to offline the GlobalService group when the Global Cluster option is in use. If the Global Cluster option is in use, the command offlines the specified global service group on specified system in the specified cluster. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. For a system whose name is not unique among clusters, specify the name of its cluster. Only global service groups can be taken offline from another cluster. |
| -offline [-force] [-ifprobed] group -any [-clus cluster | -localclus] |
| | The -any option can be used to stop a service group by taking its resources offline on any system within a cluster. The -force option is required to offline the ClusterService group. |
| Note: Symantec recommends that you do not offline the GlobalService group when you use global clusters. If you use global clusters, the command offlines the specified global service group on any system in the specified cluster. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. The -force option can be used to offline a global group on a cluster when another cluster having the authority for the group is faulted. Only global service groups can be taken offline from another cluster. |
| -switch group -to system [-clus cluster | -localclus [-nopre]] |
| | 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).If you use global clusters, the command switches a global service group from a system to a specified system in the specified remote cluster. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. Only global service groups can be switched within or across clusters from another cluster. If you set the value of the PreSwitch group attribute to 1 in the global group definition of the remote cluster, the VCS engine invokes PreSwitch action for the resources that support the PreSwitch action. The engine switches a service group normally if all the actions succeed. If any of the actions fail, then the engine aborts the switch operation. See Veritas Cluster Server User’s Guide for more information.
The -nopre option indicates that the VCS engine must switch the service group regardless of the value of the PreSwitch service group attribute. |
| -switch group -any [-clus cluster | -localclus] |
| | The -any option can be used to switch a service group to the best possible system on which it is currently not online, based on the value of the group’s FailOverPolicy attribute.If you use global clusters, the command switches a global service group from a system to a system in specified cluster, either local or remote. The -clus or -localclus option indicates a specific cluster. The -localclus option specifies the cluster in which the command is issued. Only global service groups can be switched within or across clusters from another cluster. With the -any option, the VCS engine does not invoke the PreSwitch action of any resources even if you set the value of the PreSwitch group attribute to 1.
If you run this command to switch a parallel global service group across clusters, VCS brings the parallel service group online on all possible nodes in the remote cluster. |
| -freeze group -persistent |
| | Freeze a service group (disables onlining, offlining, and failover). The -persistent flag indicates the freeze is maintained after a system is rebooted, or the engine is stopped and restarted. NOTE that the configuration must be read-write to use this option. |
| -freeze group [-clus cluster | -localclus] |
| | Freeze a service group (disable onlining, offlining, and failover). If the Global Cluster option is in use, the command freezes the specified global service group in the specified cluster. Use the -clus or-localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. Only global service groups can be frozen from another cluster. |
| -unfreeze group -persistent |
| | Thaw a service group (reenables onlining, offlining, and failover). The -persistent flag indicates the freeze is maintained after a system is rebooted. NOTE that the configuration must be read-write to use this option. |
| -unfreeze group [-clus cluster | -localclus] |
| | Thaw a service group (reenables onlining, offlining, and failover). If the Global Cluster option is in use, the command unfreezes the specified global service group in the specified cluster. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. Only global service groups can be unfrozen from another cluster. |
| -enable group [-sys system] |
| | Enable a service group. |
| -disable group [-sys system] |
| | Disable a service group. Actions such as onlining and switching are not permitted on the group. |
| -autoenable group -sys system |
| | When VCS does not know the status of a given service group on a given system, it marks that service 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 cannot 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 systems are brought down on the designated systems. Then, clear the AutoDisabled attribute for each system:# hagrp -autoenable service_group -sys system_name |
| -enableresources group |
| | Enable all resources in a service group. Agents monitor the resources in the group. |
| -disableresources group |
| | Disable all resources in a service group. Agents do not monitor the resources in the group. |
| -ignore group -clus cluster |
| | The -ignore option marks the selected remote group as offline on the specified remote cluster. The remote cluster specified should be in the faulted state. This option is used in conjunction with the -status and -failover options of the haclus command. This ignores groups from the faulted cluster as seen from the local cluster. Ignored groups will not be listed in the output of the -status and -failover options of the haclus command. |
| -display [group(s)] [-attribute attribute(s)] [-sys system(s)] [-clus cluster | -localclus] |
| | Display the attributes and their values for a specified group (or all groups if no group is specified). If the system is specified, display the attributes and values for the specified group on the specified system. If the cluster is specified, display the attributes and values for the specified group on the specified cluster. If the Global Cluster option is in use, the command displays the specified information for all systems on all clusters. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. For a system whose name is not unique among clusters, specify the name of its cluster. Only the values of attributes of global groups can be displayed across clusters. |
| -state [group(s)] [-sys system(s)] [-clus cluster | -localclus] |
| | Display the current state of the specified groups on the specified system (or all systems if no system is specified) in the specified cluster. If the Global Cluster option is in use, the command lists the state of the specified system. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. For a system whose name is not unique among clusters, specify the name of its cluster. Only the states of global groups can be displayed across clusters. |
| -list [conditional(s)] [-clus cluster | -localclus] |
| | Displays a list of groups whose values match given conditional statement(s). Conditional statements can take three forms: Attribute=Value, Attribute!=Value, Attribute=~Value. Multiple conditional statements imply AND logic. If no conditional statement is specified, all groups in the cluster are listed. If the Global Cluster option is in use, the command lists the specified global groups on all clusters. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. Only global groups can be displayed across clusters. |
| -value group attr system [-clus cluster | -localclus] |
| | The -value option provides the value of a single group attribute. For example, "hagrp -value groupX State sysb -clus C2" displays the value of the State attribute for the group "groupX" on system "sysb" in the remote cluster C2. If no cluster is specified, the local cluster is considered. 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. If the Global Cluster option is in use, the command displays the values for the attribute on all clusters. Use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. For a system whose name is not unique among clusters, specify the name of its cluster. Only a global group’s attribute value can be displayed across clusters. |
| -dep [group(s)] |
| | Display dependencies between groups. |
| -resources group [-clus cluster | -localclus] |
| | List resources for a service group. For global clusters, use the -clus or -localclus option to indicate a specific cluster. The -localclus option specifies the cluster in which the command is issued. |
| -wait group attribute value [-clus cluster] [-sys system] [-time timeout] |
| | The -wait option is for use in scripts to direct the hagrp command to block until the value of the attribute is changed as specified, or until the timeout expires. If a timeout is not specified, the command line interface blocks indefinitely. timeout is an integer specifying seconds. See EXAMPLES. The -wait option can be used only with changes to scalar attributes. The -sys option can be applied only when the scope of the attribute is local. The -clus option applies only when applying the -wait option in a Global Cluster environment. The scalar group level attributes on the remote cluster are limited to those capable of being displayed using the hagrp -display -clus remote_cluster command. |
| -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. |
| -modify modify_options |
| | The -modify option lets you modify a service group’s attributes. You must make the configuration read-write before modifying any attributes. Some attributes, such as ProbesPending, are internal to VCS and cannot be modified. You can modify any attribute that can be configured in main.cf. You may modify a scalar attribute’s existing value. You may not use -modify to change values already defined for a vector, a keylist, or an association attribute. For vector, keylist, and association attributes, use the modify_options, which include -add, -delete, -update, or -delete -keys. Refer to the following list of permissible -modify commands. You may display the commands by using -hagrp -help -modify.
|
|
| SCALAR | hagrp -modify group attr value [-sys system] |
| VECTOR | Use the following command only when the attribute has no value:hagrp -modify group attr value ... [-sys system]
For vector attributes that have values defined, only the following operations are allowed:
hagrp -modify group attr -add value ... [-sys system]
hagrp -modify group attribute -insert index value ... [-sys system]
You can use the -insert option to add one or more values at a given index. You must enter a valid integer for index that can range from 1 to the maximum number of values.
hagrp -modify group attr -delete key ... [-sys system]
hagrp -modify group attr -delete -keys [-sys system] |
| KEYLIST |
| | Use the following command only when the attribute has no value:hagrp -modify group attr key ... [-sys system]
For keylist attributes that have values defined, only the following operations are allowed.
hagrp -modify group attr -add key ... [-sys system]
hagrp -modify group attribute -insert index key ... [-sys system]
You can use the -insert option to add one or more values at a given index. You must enter a valid integer for index that can range from 1 to the maximum number of values that exist for the key.
hagrp -modify group attr -delete key ... [-sys system]
hagrp -modify group attr -delete -keys [-sys system] |
| ASSOCIATION |
| | Use the following command only when the attribute has no value:hagrp -modify group attr {key value} ... [-sys system]
For association attributes that have values defined, only the following operations are allowed.
hagrp -modify group attr -add {key value} ... [-sys system]
hagrp -modify group attr -update {key value} ... [-sys system]
hagrp -modify group attr -delete key ... [-sys system]
hagrp -modify group attr -delete -keys [-sys system] |
|
|
|
No comments:
Post a Comment