Resource attributes

Resource attributes lists resource attributes.

Resource attributes

Resource Attributes

Description

ArgListValues 

(agent-defined) 

List of arguments passed to the resource's agent on each system.This attribute is resource- and system-specific, meaning that the list of values passed to the agent depend on which system and resource they are intended. 

  • Type and dimension: string-vector
  • Default: non-applicable.

AutoStart 

(user-defined) 

Indicates the resource is brought online when the service group is brought online. 

  • Type and dimension: boolean-scalar
  • Default: 1

ComputeStats 

(user-defined) 

Indicates to agent framework whether or not to calculate the resource's monitor statistics. 

  • Type and dimension: boolean-scalar
  • Default: 0

ConfidenceLevel 

(agent-defined) 

Indicates the level of confidence in an online resource. Values range from 0-100. Note that some VCS agents may not take advantage of this attribute and may always set it to 0. Set the level to 100 if the attribute is not used. 

  • Type and dimension: integer-scalar
  • Default: 0

Critical 

(user-defined) 

Indicates whether a fault of this resource should trigger a failover of the entire group or not. If Critical is 0, the resource fault will not cause group failover. 

  • Type and dimension: boolean-scalar
  • Default: 1

Enabled 

(user-defined) 

Indicates agents monitor the resource.  

If a resource is created dynamically while VCS is running, you must enable the resource before VCS monitors it. For more information on how to add or enable resources, see the chapters on administering VCS from the command line and graphical user interfaces. 

When Enabled is set to 0, it implies a disabled resource.  

See Troubleshooting VCS startup

  • Type and dimension: boolean-scalar
  • Default: If you specify the resource in main.cf prior to starting VCS, the default value for this attribute is 1, otherwise it is 0.

Flags 

(system use only) 

Provides additional information for the state of a resource. Primarily this attribute raises flags pertaining to the resource. Values: 

normal—Standard working order. 

restarting —The resource faulted and that the agent is attempting to restart the resource on the same system. 

state unknown—The latest monitor call by the agent could not determine if the resource was online or offline. 

monitor timedout —The latest monitor call by the agent was terminated because it exceeded the maximum time specified by the static attribute MonitorTimeout. 

unable to offline—The agent attempted to offline the resource but the resource did not go offline. This flag is also set when a resource faults and the clean function completes successfully, but the subsequent monitor hangs or is unable to determine resource status. 

  • Type and dimension: integer-scalar
  • Default: Not applicable.

Group 

(system use only) 

String name of the service group to which the resource belongs. 

  • Type and dimension: string-scalar
  • Default: Not applicable.

IState 

(system use only) 

 

The internal state of a resource. In addition to the State attribute, this attribute shows to which state the resource is transitioning. Values:
not waiting—Resource is not in transition. 

waiting to go online—Agent notified to bring the resource online but procedure not yet complete. 

waiting for children online—Resource to be brought online, but resource depends on at least one offline resource. Resource transitions to waiting to go online when all children are online. 

waiting to go offline—Agent notified to take the resource offline but procedure not yet complete. 

waiting to go offline (propagate)—Same as above, but when completed the resource's children will also be offline. 

waiting to go online (reverse)—Resource waiting to be brought online, but when it is online it attempts to go offline. Typically this is the result of issuing an offline command while resource was waiting to go online. 

waiting to go offline (reverse/propagate)—Same as above, but resource propagates the offline operation. 

  • Type and dimension: integer-scalar
  • Default: 1

    not waiting

LastOnline 

(system use only) 

Indicates the system name on which the resource was last online. This attribute is set by VCS. 

  • Type and dimension: string-scalar
  • Default: Not applicable

MonitorOnly 

(system use only) 

Indicates if the resource can be brought online or taken offline. If set to 0, resource can be brought online or taken offline. If set to 1, resource can only be monitored. 

Note   This attribute can only be modified by the command hagrp -freeze.

  • Type and dimension: boolean-scalar
  • Default: 0

MonitorTimeStats 

(system use only) 

 

Valid keys are Average and TS. Average is the average time taken by the monitor function over the last Frequency number of monitor cycles. TS is the timestamp indicating when the engine updated the resource's Average value. 

  • Type and dimension: string-association
  • Default: Average = 0

    TS = ""

Name 

(system use only) 

Contains the actual name of the resource. 

  • Type and dimension: string-scalar
  • Default: Not applicable.

Path 

(system use only) 

 

Set to 1 to identify a resource as a member of a path in the dependency tree to be taken offline on a specific system after a resource faults. 

  • Type and dimension: boolean-scalar
  • Default: 0

Probed 

(system use only) 

Indicates whether the state of the resource has been determined by the agent by running the monitor function. 

  • Type and dimension: boolean-scalar
  • Default: 0

ResourceInfo 

(system use only) 

This attribute has three predefined keys: 

State: values are Valid, Invalid, or Stale 

Msg: output of the info function captured on stdout by the agent framework 

TS: timestamp indicating when the ResourceInfo attribute was updated by the agent framework 

  • Type and dimension: string-association
  • Default:

    State = Valid

    Msg = ""

    TS = ""

ResourceOwner 

(user-defined) 

Used for VCS email notification and logging. VCS sends email notification to the person designated in this attribute when an event occurs related to the resource. VCS also logs the owner name when an event occurs. 

  • Type and dimension: string-scalar
  • Default: If ResourceOwner is not specified in main.cf, the default value is "unknown".

Signaled 

(system use only) 

Indicates whether a resource has been traversed. Used when bringing a service group online or taking it offline. 

  • Type and dimension: integer-association
  • Default: Not applicable.

Start 

(system use only) 

Indicates whether a resource was started (the process of bringing it online was initiated) on a system. 

  • Type and dimension: integer -scalar
  • Default: 0

State 

(system use only) 

Resource state displays the state of the resource and the flags associated with the resource. (Flags are also captured by the Flags attribute.) This attribute and Flags present a comprehensive view of the resource's current state. Values: 

online 

offline 

faulted 

online|state unknown 

online|monitor timedout 

online|unable to offline 

offline|state unknown 

faulted|restarting 

A faulted resource is physically offline, though unintentionally. 

  • Type and dimension: integer -scalar
  • Default: 0

 

TriggerEvent 

(system use only) 

A flag that turns Events on or off. 

  • Type and dimension: boolean-scalar
  • Default: 0