vsdchgserver Command

Purpose

vsdchgserver – Switches the server function for one or more virtual shared disks from the node that is currently acting as the server node to the other.

Syntax

vsdchgserver
-g vsd_global_volume_group_name -p primary_node
 
[-b secondary_node] [ -o EIO_recovery]

Description

The vsdchgserver command allows the serving function for a global volume group defined on a primary node to be taken over by the secondary node, or to be taken over by the primary node from the secondary node. This allows an application to continue to use virtual shared disks in situations where the cable or adapter between the physical disks and one of the attached nodes is not working.

The Recoverable virtual shared disk subsystem automatically updates the virtual shared disk devices if, and only if, the vsdchgserver command is used to flip the currently-defined primary node and secondary node in the global volume group specified in the -g flag.

Flags

-g
Specifies the Global Volume Group name for the volume group that represents all the virtual shared disks defined on a particular node.
-p
Specifies the primary server node number for the global volume group.
-b
Specifies the secondary node number for the global volume group. If the -b flag is not specified, the secondary node definition will be removed.
-o
Specified as 0, for no recovery on an EIO error, or 1, for recovery on an EIO error.

Parameters

None.

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 the RSCT: Administration Guide.

Standard Output

Current RVSD subsystem run level.

Examples

To change the primary server node for the global volume group node12vg to node 1 and the secondary node to node 2, with EIO recovery, enter:

vsdchgserver -g node12vg -p 1 -b 2 -o 1

Location

/opt/rsct/vsd/bin/vsdchgserver