test veritas logo


HASYS(1M)

NAME

hasys - add, modify, delete, display, or list information about a system

SYNOPSIS

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 -util system

hasys -value sys attr [-clus cluster | -localclus]

hasys -nodeid [nodeid]

hasys -updatelic -sys system

hasys -updatelic -all

hasys -modify modify_options

hasys -dumptunables system

hasys -wait system attribute value [-clus cluster] [-time timeout]

hasys [-help [-modify | -list]]

AVAILABILITY

VRTSvcs

DESCRIPTION

The hasys command allows administrators to manage information about each system. (A system is an object representing an individual computer within a cluster.) See NOTES for how to specify "-" and "%" characters in the command line.

OPTIONS

-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.
-delete system
  Delete a system from the configuration. The system must be in EXITED or UNKNOWN state.
-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 DynamicLoad 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 engine. 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.
-util system
  Display the resource utilization of the following system attributes:
o Capacity
o HostAvailableForecast
o HostUtilization
o ServerCapacity
o ServerAvailableForecast The -util option is applicable only if you set the cluster attribute Statistics to Enabled, and define at least one key in the cluster attribute HostMeters. The command also indicates if the HostUtilization and HostAvailableForecast values are stale.

The ServerCapacity value indicates the total CPU and memory of the physical server and the ServerAvailableForecast value indicates the available CPU and memory on the physical server. These values help in determining whether a virtual machine can be brought online on a physical server, depending on the available CPU and memory capacity.

Note that the system parameter is optional, if you do not specify the value of the parameter, the command displays the attributes for all the systems in the 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 displays the nodeid value for the corresponding 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. You must run the hasys -updatelic command only after you add a license key using the vxlicinst command or after you set the product license level using the vxkeyless 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. You must run the hasys -updatelic command only after you add a license key using the vxlicinst command or after you set the product license level using the vxkeyless command.
Note: hasys -updatelic -all must be run in the cluster before the haclus -updatelic can be run to update cluster level licensing.
-dumptunables system
  Can be used to inspect the environment variables of the VCS engine (HAD) that is running on a system. The system must be in a RUNNING state.
-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 attribute -insert index value

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.

hasys -modify sys attr -delete key ...

hasys -modify sys attr -delete -keys

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 attribute -insert index key

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.

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

EXAMPLES

From a script, to use the -wait option to direct the hasys\fR command to block until system S1 goes into the RUNNING state, enter:

     hasys -wait S1 SysState RUNNING

NOTES

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.

SEE ALSO

haconf(1M), haclus(1M)


VCS 7.4.3 HASYS(1M)