ha.vsd Command

Purpose

Queries and controls the activity of the rvsd daemon of the recoverable virtual shared disk subsystem.

Syntax

ha.vsd: {adapter_recovery [on | off] | debug [off] | mksrc | query | quorum n | qsrc | refresh [noquorum] | reset | reset_quorum | rmsrc | start | stop | trace [off]}

Description

Use this command to display information about the recoverable virtual shared disk subsystem, to change the number of nodes needed for quorum, and to change the status of the subsystem.

Flags

-a: Specifies all virtual shared disks.
-v vsd_name_list: Specifies one or more virtual shared disk names, separated by commas.
-n node_list: Specifies one or more node numbers, separated by commas.

Parameters

adapter_recovery [on | off]

Enables or disables communication adapter recovery. The default is on.

The recoverable virtual shared disk subsystem must be restarted for this operand to take effect.

debug [off]

Specify debug to redirect the recoverable virtual shared disk subsystem's standard output and standard error to the console and cause the recoverable virtual shared disk subsystem to not respawn if it exits with an error. (You can use the lscons command to determine the current console.)

The recoverable virtual shared disk subsystem must be restarted for this operand to take effect.

Once debugging is turned on and the recoverable virtual shared disk subsystem has been restarted, ha.vsd trace should be issued to turn on tracing.

Use this operand under the direction of your IBM® service representative.

Note: The default when the node is booted is to have standard output and standard error routed to the console. If debugging is turned off standard output and standard error will be routed to /dev/null and all further trace messages will be lost. You can determine if debug has been turned on by issuing ha.vsd qsrc. If debug has been turned on the return value will be:

action = "2"

mksrc

Uses mkssys to create the recoverable virtual shared disk subsystem.

query

Displays the current status of the recoverable virtual shared disk subsystem in detail.

quorum n

Sets the value of the quorum, which is the total number of nodes that must join the group before the virtual shared disks will be activated. Usually, quorum is defined as a majority of the nodes that are defined as virtual shared disk nodes in an RSCT peer domain, but this command allows you to override that definition.

The Recoverable virtual shared disk subsystem must be in the active state when you issue this command. This is not a persistent change.

qsrc

Displays the System Resource Controller (SRC) configuration of the Recoverable virtual shared disk daemon.

refresh [noquorum]

Uses the refresh command to asynchronously start a refresh protocol to all running recoverable virtual shared disk subsystems. The quorum will be reset before the refresh occurs, unless noquorum is specified. Use ha.vsd query to check for completion. The following items are refreshed in the device driver:

Nodes that have been added or deleted
Virtual shared disks that have been added or deleted
Changed attribute size_in_MB for virtual shared disks

reset

Stops and restarts the recoverable virtual shared disk subsystem.

reset_quorum

Resets the default quorum.

rmsrc

Uses rmssys to remove the recoverable virtual shared disk subsystem.

start

Starts the recoverable virtual shared disk subsystem.

stop

Stops the recoverable virtual shared disk subsystem.

trace [off]

Requests or stops tracing of the recoverable virtual shared disk subsystem. The recoverable virtual shared disk subsystem must be in the active state when this command is issued.

This operand is only meaningful after the debug operand has been used to send standard output and standard error to the console and the recoverable virtual shared disk subsystem has been restarted.

Security

You must have root authority to run this command.

Exit Status

0: Indicates the successful completion of the command.
nonzero: Indicates that an error occurred.

Restrictions

You must issue this command from a node that is online in the peer domain. To bring a peer domain online, use the startrpdomain command. To bring a particular node online in an existing peer domain, use the startrpnode command. For more information on creating and administering an RSCT peer domain, refer to RSCT Administration Guide .

Examples

To stop the recoverable virtual shared disk subsystem and restart it, enter:

ha.vsd reset

The system returns the messages:

Waiting for the rvsd subsystem to exit.
rvsd subsystem exited successfully.
Starting rvsd subsystem.
rvsd subsystem started PID=xxx.

To change the quorum to five nodes of the RSCT peer domain, enter:
```
ha.vsd quorum 5
```
The system returns the message:
```
Quorum has been changed from 8 to 5.
```
To query the rvsd subsystem, enter:
```
ha.vsd query
```
The system displays a message similar to the following:
```
Subsystem         Group            PID     Status
      rvsd             rvsd             18320   active
      rvsd(vsd): quorum= 9/4, active=1, state=idle, isolation=member,
                 NoNodes=10, lastProtocol=nodes_failing,
                 adapter_recovery=on, adapter_status=up,
                 RefreshProtocol has never been issued from this node,
                 Running function level 4.1.0.0.
```
where:
quorum

Is the number of total nodes or server nodes that must join the group before virtual shared disks will be activated. In the system output above, quorum 9/4 indicates the total number of nodes (9) and the number of server nodes (4).

active

Indicates the activation status of the group that is being joined:
0:

the group is not active (quorum has not been met).

1:

the group is active and the shared disks have been activated.

state

Indicates the current protocol that is running.

isolation

Indicates the group membership status
isolated:

a group "join" has not been proposed.

proposed:

a group "join" has been proposed.

member:

we are a member (provider) of the group.

NoNodes

Indicates the number of nodes that have joined the group

lastProtocol

Indicates the last protocol that was run across the group.

adapter_recovery

Indicates communication adapter recovery support:
on:

adapter recovery is enabled.

off:

adapter recovery is disabled.

adapter_status

Indicates communication adapter status:
up:

the adapter is up.

down:

the adapter is down.

unknown:

the adapter status is unknown.

RefreshProtocol ...

Indicates whether a refresh protocol has been issued from this node. If so, the date and time of success or error will be displayed.

Running function level

Indicates the function level that the subsystem is running, in version, release, modification, fix level format (vrmf). (Coexistence with lower levels of the subsystem, may restrict us to running at a reduced function level.)

Location

/opt/rsct/vsd/bin/ha.vsd