Previous  |  Next  >  
Product: Volume Manager Manual Pages for Storage Foundation   
Manual: Maintenance Commands (1m)   

vxadm

NAME

vxadm - perform distributed VxVM operations

SYNOPSIS


vxadm [options] keyword operation argument...
vxadm [-n node_name] dg version dgname
vxadm help [keyword] [operation]
vxadm [-n node_name] -g dg_name snap addmap
source=
volume[/number=num][/alloc=storage_attributes]

vxadm [-n node_name] -g dg_name snap dis
source=
volume[/snapobjs={snapvol|snapobject}]

vxadm [-n node_name] -g dg_name snap make snapshot_tuple [snapshot_tuple]...
snapshot_tuple::
source={volume|volset}/snapvol={snapvolume|snapobject}\
[/alloc=storage_attributes][/autogrow=yes|no]\
[/cache=cache_object][/cachesize=size]\
[/comment=\"desc\"][/infrontof=frontvol]\
[/ncachemirror=number][/newvol=snapvolume|snapvolset]\
[/nmirror=number][/plex=plex[,plex...]]\
[/syncing={off|on|no|yes}]

vxadm [-n node_name] -g dg_name snap prepare
source=
{volume|volset}[/regionsize=size]\
[/drl={yes|no|sequential}][/ndcomirrors=num]

vxadm [-n node_name] -g dg_name snap reattach
source=
{volume|volset}/snapvol={snapvol|snapvolset}\
[/nmirrors=number]

vxadm [-n node_name] -g dg_name snap refresh
source=
{volume|volset}/snapvol={snapvolume|snapvolset}
[source={vol2|vset2}/snapvol={snapvol2|snapvset2}]...
[syncing={yes|no}]

vxadm [-n node_name] -g dg_name snap restore
tovol=
{volume|volset}[/source=snapvolume]\
[/destroy={yes|no}][/nmirrors=number]

vxadm [-n node_name] -g dg_name snap split source=volume
vxadm [-n node_name] -g dg_name snap syncstart source=volume
vxadm [-n node_name] -g dg_name snap syncwait source=volume
vxadm [-n node_name] -g dg_name snap unprepare
source=
{volume|volset}

vxadm [-n node_name] -g dg_name snpt create
source=volume[/snptname=snpt][/snapvolname=snapvol]
[/data={yes|no}]
[source=vol2[/snptname=snpt2][/snapvolname=snapvol2]
[/data={yes|no}]]...

vxadm [-n node_name] -g dg_name snpt remove source=volume [/snptname=snpt]
vxadm [-n node_name] -g dg_name snpt removeall source=volume
vxadm [-n node_name] -g dg_name snpt rename
source=volume/snptname=snpt/newname=snptnew
[source=vol2/snptname=snpt2/newname=snptnew2]...

vxadm [-n node_name] -g dg_name snpt setnodata
source=volume/snptname=snpt
[source=vol2/snptname=snpt2]...

DESCRIPTION

The vxadm utility allows you to perform a limited set of VERITAS Volume Manager (VxVM) operations on remote systems or clusters. The specified keyword and operation determine the action that is performed. Additional arguments and options determine the object on which the operation must be performed.

The vxadm command supports instant snapshot and snappoint operations on both local and shared disk groups. If the cluster functionality of VxVM is in use, vxadm operations are automatically directed to the master node for execution.

KEYWORDS

The following keywords are supported:

help

Displays information about the usage of keywords and operations.

dg

The dg version operation returns the version number of the specified disk group. This operation can be used to determine whether a disk group has been upgraded to VxVM 4.0 with a version number of 110. Instant snaphot and snappoint operations are available only on disk groups with a version number greater than or equal to 110.

snap

Performs instant snapshot operations in a manner similar to the vxsnap command. For more information about these operations, refer to the vxsnap(1M) manual page.

snpt

Performs snappoint operations in a manner similar to the vxsnptadm command. For more information about these operations, refer to the vxsnptadm(1M) manual page.

AUTHENTICATION

The vxadm utility uses the VERITAS Enterprise Administrator (VEA) infrastructure to perform distributed operations. Connection to the VEA server on a remote host requires the provision of a valid user ID and password. This information is read from the file /etc/vx/vxadm/vxpwd, which must contain the following user and password definition for each remote host that is to be administered:


remote_hostname<TAB>userid<TAB>password

Each field must be separate by one tab character. Comment lines in the vxpwd file must start with a # character in the first column.

Caution: As the password is stored in plain text, it is recommended that you the permissions on the /etc/vx/vxadm/vxpwd file to read-only for the owner root, and remove read, write or execute permission for group or any other user.

OPTIONS

-g dg_name>

Specifies the name of the disk group to which the operation is to be applied. If not specified, the default disk group is assumed if this is defined by defaultdg.

-n node_name

Specifies the host on which the operation should be performed. If the specified disk group is a cluster-sharable disk group, and the specified host is a slave node, the operation is diverted to the master node.

RETURN VALUES

The vxadm command returns 0 in the case of the successful execution of the operation. In the case of error, it returns one of the following error codes:

2

Usage error. An invalid option or argument was specified.

4

You do not have permission to connect to the local VEA server, or the user ID and password that are specified in the /etc/vx/vxadm/vxpwd for connecting to the VEA server on a remote host are incorrect.

Use the command /opt/VRTSob/bin/vxsvc -m on the intended host to check the status of VEA server:

Not Running

Restart the VEA server on the intended host.

Running

Check that the specified user ID has the appropriate privileges to run VEA on the specified host. Also ensure that the user ID and password entries that are specified for the host in the /etc/vx/vxadm/vxpwd file are correct.

Start Pending

Wait for the VEA server to start.

5

The format of the file /etc/vx/vxadm/vxpwd is incorrect, or the file does not contain an entry for the specified host.

6

Unspecified internal error.

Retry the command after restarting the VEA server on the intended host. If the problem persists, contact VERITAS customer support.

7

The object (such as a disk group, volume or plex) that was specified on the command line is invalid.

FILES

/etc/vx/vxadm/vxpwd

Contains user IDs and passwords for access to VEA servers on remote systems.

NOTES

No white space is allowed between attributes that are separated by slashes (/).

SEE ALSO

vxdg (1M), vxintro (1M), vxsnap (1M), vxsnptadm(1M)
 ^ Return to Top Previous  |  Next  >  
Product: Volume Manager Manual Pages for Storage Foundation  
Manual: Maintenance Commands (1m)  
VERITAS Software Corporation
www.veritas.com