Top
PRIMECLUSTER  Reliant Monitor Services (RMS) with Wizard Tools Configuration and Administration Guide 4.6
FUJITSU Software

G.1 Available RMS CLI commands

hvassert

Tests an RMS resource for a specified resource state. It can be used in scripts when a resource must achieve a specified state before the script can issue the next command. Does not require root privilege.

hvcm

Starts the base monitor and the detectors for all monitored resources. In most cases, it is not necessary to specify options to the hvcm command.The base monitor is the decision-making module of RMS. It controls the configuration and access to all RMS resources. If a resource fails, the base monitor analyzes the failure and initiates the appropriate action according to the specifications for the resource in the configuration file.

hvconfig

Either displays the current RMS configuration or sends the current configuration to an output file. The output of the hvconfig command is equivalent to the running RMS configuration file, but does not include any comments that are in the original file. Also, the order in which the resources are listed in the output might vary from the actual configuration file.

hvdisp

Displays information about the current configuration for RMS resources. Does not require root privilege.

hvdispall

Display the resource information of all the nodes in RMS.

hvdump

Gets debugging information about RMS on the local node.

hvlogclean

Either saves old log files into a subdirectory whose name is the time RMS was last started, or, if invoked with the -d option, deletes old log files. In either case, hvlogclean creates a clean set of log files even while RMS is running.

hvreset

Reinitializes the graph of an RMS user application on one or more nodes in the RMS configuration. Running scripts will be terminated, ongoing requests will be cleaned up, and information about previous failures will be purged.

Note

The entire graph is returned to its initial consistent state by this command, but it may also become an inconsistent state. Therefore, use this command for test purposes only, and never execute it on a production cluster system.

hvsetenv

Provides an interface for changing the following RMS environment variables on the local node:

  • HV_RCSTART controls the automatic startup of RMS.

  • HV_AUTOSTARTUP controls the automatic startup of all applications.

For more information about these environment variables, see "Appendix E Environment variables".

hvshut

Shuts down RMS on one or more nodes in the configuration. The base monitor on the local node sends a message to other online nodes indicating which node or nodes will be shut down.

hvswitch

Manually switches control of a userApplication or a gResource between SysNodes in the RMS configuration.

hvutil

Provides general administration interface to RMS and performs the following administration tasks.

  • Dynamically setting logging levels

  • userApplication Offline

  • Clearing faulted resources

  • Stopping cluster nodes in the Wait state

  • Setting detector monitoring time periods

  • Setting maintenance mode, and so forth

Note

Setting high logging levels in hvutil can cause disk overflow if enabled for too long. See the section "F.4.1 Managing base monitor log levels" for more information.