Purpose
Observes resource variable instances
that are updated by resource monitors and generates and reports events
to client programs.
Syntax
hagsd [-a] [-s] [-k] [-d] [-c] [-u] [-t] [-o] [-r] [-h] daemon_name
Description
The hagsd daemon is part of the group services subsystem, which provides
a general-purpose facility for coordinating and monitoring changes
to the state of an application that is running on the nodes of a cluster.
This daemon provides most of the services of the subsystem. daemon_name specifies the name used by the daemon
to name log files and identify its messages in the AIX® error log.
One
instance of the hagsd daemon executes on
each cluster node. The hagsd daemon is
under the control of the system resource controller (SRC).
Because the daemon is under SRC control, it is better not to start
it directly from the command line. It is normally called by the grpsvcsctrl command, which is in turn called by
the cluster startup process. If you must start or stop the daemon
directly, use the startsrc or stopsrc command.
Flags
- -a
- Adds the subsystems.
- -s
- Starts the subsystems.
- -k
- Stops the subsystems.
- -d
- Deletes the subsystems.
- -c
- Cleans the subsystems, that is, delete them from all system partitions.
- -u
- Unconfigures the subsystems from all system partitions.
- -t
- Turns tracing on for the subsystems.
- -o
- Turns tracing off for the subsystems.
- -r
- Refreshes the subsystem.
- -h
- Displays usage information.
Parameters
- daemon_name
- Specifies the name used by the daemon to name log files and identify
its messages in the AIX error log.
Security
You must have root privilege to run this script.
Exit Status
- 0
- Indicates the successful completion of the command.
- 1
- Indicates that an error occurred.
Restrictions
This command is valid in a
PSSP environment only.
Standard Output
When the -h flag is specified, this command's usage statement is written
to standard output.
Standard Error
This command writes error
messages (as necessary) to standard error.
Examples
- To add the group services subsystems to the SRC in the current
system partition, set the SP_NAME environment variable to the appropriate
system partition name and enter:
hagsctrl -a
- To start the group services subsystems in the current system partition,
set the SP_NAME environment variable to the appropriate system partition
name and enter:
hagsctrl -s
- To stop the group services subsystems in the current system partition,
set the SP_NAME environment variable to the appropriate system partition
name and enter:
hagsctrl -k
- To delete the group services subsystems from the SRC in the current
system partition, set the SP_NAME environment variable to the appropriate
system partition name and enter:
hagsctrl -d
- To clean up the group services subsystems on all system partitions,
enter:
hagsctrl -c
- To unconfigure the group servicess subsystem from all system partitions,
on the control workstation, enter:
hagsctrl -u
- To turn tracing on for the group services daemon in the current
system partition, set the SP_NAME environment variable to the appropriate
system partition name and enter:
hagsctrl -t
- To turn tracing off for the group services daemon in the current
system partition, set the SP_NAME environment variable to the appropriate
system partition name and enter:
hagsctrl -o
Location
- /usr/sbin/rsct/bin/hagsd
- Contains the hagsd daemon
Files
- /var/ha/log/hags_nodenum_instnum. syspar_name
- Contains the log of the hagsd daemons
on the nodes.
- /var/ha/log/hags.syspar_name_nodenum_instnum.syspar_name
- Contains the log of each hagsd daemon
on the control workstation.
The file names include the following variables:
- nodenum is the node number on which
the daemon is running
- instnum is the instance number of the
daemon
- syspar_name is the name of the system
partition in which the daemon is running.