Home > Veritas Cluster Server Manual Pages
HASYS (1M) |
|
Maintenance Commands |
Table of contents
hasys - add, modify, delete, display, or list information about a system
hasys -add system
hasys -delete system
hasys -freeze [-persistent] [-evacuate] system
hasys -unfreeze [-persistent] system
hasys -force system
hasys -load system value
hasys -display [system(s)] [-attribute attribute(s)] [-clus cluster | -localclus]
hasys -state [system] [-clus cluster | -localclus]
hasys -list [conditional(s)] [-clus cluster | -localclus]
hasys -value sys attr [-clus cluster | -localclus]
hasys -nodeid [nodeid]
hasys -updatelic -sys system
hasys -updatelic -all
hasys -modify modify_options
hasys -wait system attribute value [-clus cluster] [-time timeout]
hasys [-help [-modify | -list]]
VRTSvcs
The
hasys
command allows administrators to manage information about each system. (A system is an individual computer within a cluster.) See NOTES for how to specify "-" and "%" characters in the command line.
-
-add system
-
Add a system to the VCS configuration. The physical computer represented by this object does not need to exist or be a part of the cluster when the command is issued.
system
does not need to correspond to the hostname of the actual system, but it is recommended that you match the system with the hostname. If security is enabled,
system
must match the fully qualified hostname of the represented system.
-
-delete system
-
Delete a system from the configuration. The system must not be running VCS.
-
-freeze [-persistent] [-evacuate] system
-
Freeze a system. No group configured on the frozen system can come online, whether manually, by failover, or by switching until the system is thawed with the
-unfreeze
option. Using the
-persistent
option specifies that the system remains frozen after VCS has been stopped and restarted. Note that the configuration must be writable in order to use
-persistent
option. Groups online on the frozen system can be taken offline manually, by failover, or by being switched to another system. Using the
-evacuate
option specifies that all groups are switched before the system is frozen; if no other system is available for a service group, it is taken offline. Groups running on other systems do not fail over to a frozen system.
-
-unfreeze [-persistent] system
-
Thaw a frozen system so that group operations on that system are usable. Using the
-persistent
option specifies that a system remains thawed after VCS has been stopped and restarted. Note that the configuration must be writable in order to use
-persistent
option.
-
-force system
-
Force a system to start, even if it is waiting for administrative action. This command will overwrite the configuration on all systems in the cluster, so use it only if you are sure that the current configuration is valid.
-
-load system value
-
Change the load attribute of the specified system to the specified value. The load value is used for load balancing on failover. The
hasys
command enables users to supply their own load-balancing algorithm and communicate its results to the VCS server. The configuration does not have to be read-write for this command to succeed.
-
-display [system(s)] [-attribute attribute(s)] [-clus cluster | -localclus]
-
Display attribute names and values for all systems, if
system
is not specified. 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.
-
-state [system] [-clus cluster | -localclus]
-
Display the current state of the specified system. If system is not specified, the states of all systems are displayed. If the Global Cluster option is in use, the command lists the state of the specified system or of all systems if
system
is not specified. 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.
-
-list [conditional(s)] [-clus cluster | -localclus]
-
Displays a list of systems 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 systems in the cluster are listed. If the Global Cluster option is in use, the command lists the 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.
-
-value sys attr [-clus cluster | -localclus]
-
The
-value
option provides the value of a single system attribute. For example, "hasys -value sysb SysState" displays the value of the SysState attribute for system sysb. 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.
-
-nodeid [nodeid]
-
If nodeid is not specified, return the nodeid value for the specified system, as defined in the following file:
/etc/llttab
If nodeid is supplied,
hasys
sets the nodeid value for the current system. The value nodeid must be defined in /etc/llttab.
-
-updatelic -sys system
-
Can be used to update system level licensing on a particular node. To update the licensing on all nodes in a cluster at once, use the
-updatelic -all
option. VCS must be running on the node on which you are updating the licensing. The
hasys -updatelic -sys
command should only be run on a system after the license key has been added using the
vxlicinst
command.
Note:
hasys -updatelic
must be run on all nodes in a cluster before the
haclus -updatelic
can be run to update cluster level licensing.
-
-updatelic -all
-
Can be used to update system level licensing on all running systems in the cluster at one time. To update the licensing on a specific node, use the
-updatelic -sys
command. The
hasys -updatelic -all
command should only be run after the license key has been added to each system using the vxlicinst command.
Note:
hasys -updatelic -all
must be run in the cluster before the
haclus -updatelic
can be run to update cluster level licensing.
-
-wait system attribute value [-clus cluster] [-time timeout]
-
The
-wait
option is for use in scripts to direct the
hasys
command to block until the value of the attribute is changed as specified, or until the
timeout
expires.
timeout
is an integer specifying seconds. If a
timeout
is not specified, the command line interface blocks indefinitely. The
-wait
option can be used only with changes to scalar attributes. The
-clus
option applies only when applying the
-wait
option in a Global Cluster environment. The scalar system level attributes on the remote cluster are limited to those capable of being displayed using the
hasys -displaysystem-clusremote_cluster
command. See EXAMPLES.
-
[-help [-modify | -list]]
-
Displays information about using hasys. The
-modify
option provides modify specific help; the
-list
option provides list specific help.
-
-modify modify_options
-
The
-modify
option lets you modify a system's attributes. Some attributes 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
-hasys -help -modify.
-
SCALAR
-
hasys -modify sys attr value
-
VECTOR
-
Use the following command only when the attribute has no value:
hasys -modify sys attr value
For vector attributes that have values defined, only the following operations are allowed.
hasys -modify sys attr -add value
hasys -modify sys attr -delete -keys
Note:
You cannot delete an individual element of a VECTOR.
-
KEYLIST
-
Use the following command only when the attribute has no value:
hasys -modify sys attr key
For keylist attributes that have values defined, only the following operations are allowed.
hasys -modify sys attr -add key
hasys -modify sys attr -delete key
hasys -modify sys attr -delete -keys
-
ASSOCIATION
-
Use the following command only when the attribute has no value:
hasys -modify sys attr {key value}
For association attributes that have values defined, only the following operations are allowed.
hasys -modify sys attr -add {key value}
hasys -modify sys attr -update {key value}
hasys -modify sys attr -delete key
hasys -modify sys attr -delete -keys
From a script, to use the
-wait
option to direct the
hasys
command to block until system
S1
goes into the
RUNNING
state, enter:
hasys -wait S1 SysState RUNNING
If a system name is not specified, information regarding all systems is displayed.
If an attribute name is not specified, information regarding all system attributes is displayed.
When using the command to specify or modify an attribute's value that begins with a dash ("-"), precede the value with a percent sign ("%"). For example, specify -y as %-y. Likewise, precede a value that starts with a percent sign with another percent sign.
haconf(1M),
haclus(1M)
Copyright (c) 2008 Symantec.
All rights reserved.
Last updated: 07/03/2008
Copyright ©2009 Symantec Corporation
All rights reserved.