Most Veritas Volume Manager (VxVM) commands (excepting daemons, library commands and supporting scripts) are linked to the /usr/sbin directory from the /opt/VRTS/bin directory. It is recommended that you add the following directories to your PATH environment variable:
If you are using the Bourne or Korn shell (sh or ksh), use the commands:
$ PATH=$PATH:/usr/sbin:/opt/VRTS/bin:/opt/VRTSvxfs/sbin:\ /opt/VRTSdbed/bin:/opt/VRTSob/bin $ MANPATH=/usr/share/man:/opt/VRTS/man:$MANPATH $ export PATH MANPATH
If you are using a C shell (csh or tcsh), use the commands:
% set path = ( $path /usr/sbin /opt/VRTSvxfs/sbin \ /opt/VRTSdbed/bin /opt/VRTSob/bin /opt/VRTS/bin ) % setenv MANPATH /usr/share/man:/opt/VRTS/man:$MANPATH
VxVM library commands and supporting scripts are located under the /usr/lib/vxvm directory hierarchy. You can include these directories in your path if you need to use them on a regular basis.
For detailed information about an individual command, refer to the appropriate manual page in the 1M section.
Commands and scripts that are provided to support other commands and scripts, and which are not intended for general use, are not located in /opt/VRTS/bin and do not have manual pages.
Commonly-used commands are summarized in the following tables:
Table: Obtaining information about objects in VxVM lists commands for obtaining information about objects in VxVM.
Table: Administering disks lists commands for administering disks.
Table: Creating and administering disk groups lists commands for creating and administering disk groups.
Table: Creating and administering subdisks lists commands for creating and administering subdisks.
Table: Creating and administering plexes lists commands for creating and administering plexes.
Table: Creating volumes lists commands for creating volumes.
Table: Administering volumes lists commands for administering volumes.
Table: Monitoring and controlling tasks lists commands for monitoring and controlling tasks in VxVM.
Table: Obtaining information about objects in VxVM
Table: Administering disks
Table: Creating and administering disk groups
Table: Creating and administering subdisks
Table: Creating and administering plexes
Command |
Description |
---|---|
vxmake [-g diskgroup] plex plex \ sd=subdisk1[,subdisk2,...] |
Creates a concatenated plex. Example: # vxmake -g mydg plex \ vol01-02 \ sd=mydg02-01,mydg02-02 |
vxmake [-g diskgroup] plex plex \ layout=stripe|raid5 stwidth=W \ ncolumn=N \ sd=subdisk1[,subdisk2,...] |
Creates a striped or RAID-5 plex. Example: # vxmake -g mydg plex pl-01 \ layout=stripe stwidth=32 \ ncolumn=2 \ sd=mydg01-01,mydg02-01 |
vxplex [-g diskgroup] att volume plex |
Attaches a plex to an existing volume.
Example: # vxplex -g mydg att vol01 \ vol01-02 |
vxplex [-g diskgroup] det plex |
Detaches a plex. Example: # vxplex -g mydg det vol01-02 |
vxmend [-g diskgroup] off plex |
Takes a plex offline for maintenance. Example: # vxmend -g mydg off vol02-02 |
vxmend [-g diskgroup] on plex |
Re-enables a plex for use.
Example: # vxmend -g mydg on vol02-02 |
vxplex [-g diskgroup] mv oldplex \ newplex |
Replaces a plex. Example: # vxplex -g mydg mv \ vol02-02 vol02-03 |
vxplex [-g diskgroup] cp volume \ newplex |
Copies a volume onto a plex. Example: # vxplex -g mydg cp vol02 \ vol03-01 |
vxmend [-g diskgroup] fix clean plex |
Sets the state of a plex in an unstartable volume to CLEAN.
Example: # vxmend -g mydg fix clean \ vol02-02 |
vxplex [-g diskgroup] -o rm dis plex |
Dissociates and removes a plex from a volume. Example: # vxplex -g mydg -o rm dis \ vol03-01 |
Table: Creating volumes
Command |
Description |
---|---|
vxassist [-g diskgroup] maxsize \ layout=layout [attributes] |
Displays the maximum size of volume that can be created. Example: # vxassist -g mydg maxsize \ layout=raid5 nlog=2 |
vxassist -b [-g diskgroup] make \ volume length [layout=layout] \ [attributes] |
Creates a volume.
Example: # vxassist -b -g mydg make \ myvol 20g layout=concat \ mydg01 mydg02 |
vxassist -b [-g diskgroup] make \ volume length layout=mirror \ [nmirror=N][attributes] |
Creates a mirrored volume.
Example: # vxassist -b -g mydg make \ mymvol 20g layout=mirror \ nmirror=2 |
vxassist -b [-g diskgroup] make \ volume length layout=layout \ exclusive=on [attributes] |
Creates a volume that may be opened exclusively by a single node in a cluster.
Example: # vxassist -b -g mysdg make \ mysmvol 20g layout=mirror \ exclusive=on |
vxassist -b [-g diskgroup] make \ volume length layout={stripe|raid5} \ [stripeunit=W] [ncol=N] \ [attributes] |
Creates a striped or RAID-5 volume.
Example: # vxassist -b -g mydg make \ mysvol 20g layout=stripe \ stripeunit=32 ncol=4 |
vxassist -b [-g diskgroup] make \ volume length layout=mirror \ mirror=ctlr [attributes] |
Creates a volume with mirrored data plexes on separate controllers. Example: # vxassist -b -g mydg make \ mymcvol 20g layout=mirror \ mirror=ctlr |
vxmake -b [-g diskgroup] \ -Uusage_type vol volume \ [len=length] plex=plex,... |
Creates a volume from existing plexes. Example: # vxmake -g mydg -Uraid5 \ vol r5vol \ plex=raidplex,raidlog1,\ raidlog2 |
vxvol [-g diskgroup] start volume |
Initializes and starts a volume for use. Example: # vxvol -g mydg start r5vol |
vxvol [-g diskgroup] init zero \ volume |
Initializes and zeros out a volume for use. Example: # vxvol -g mydg init zero \ myvol |
Table: Administering volumes
Command |
Description |
||
---|---|---|---|
vxassist [-g diskgroup] mirror \ volume [attributes] |
Adds a mirror to a volume.
Example: # vxassist -g mydg mirror \ myvol mydg10 |
||
vxassist [-g diskgroup] remove \ mirror volume [attributes] |
Removes a mirror from a volume.
Example: # vxassist -g mydg remove \ mirror myvol \!mydg11
|
||
vxassist [-g diskgroup] \ {growto|growby} volume length |
Grows a volume to a specified size or by a specified amount. Example: # vxassist -g mydg growby \ myvol 10g |
||
vxassist [-g diskgroup] \ {shrinkto|shrinkby} volume length |
Shrinks a volume to a specified size or by a specified amount. Example: # vxassist -g mydg shrinkto \ myvol 20g |
||
vxresize -b -F vxfs [-g diskgroup] \ volume length diskname ... |
Resizes a volume and the underlying Veritas File System. Example: # vxresize -b -F vxfs \ -g mydg myvol 20g mydg10 \ mydg11 |
||
vxsnap [-g diskgroup] prepare volume \ [drl=on|sequential|off] |
Prepares a volume for instant snapshots and for DRL logging.
Example: # vxsnap -g mydg prepare \ myvol drl=on |
||
vxsnap [-g diskgroup] make \ source=volume\ /newvol=snapvol\ [/nmirror=number] |
Takes a full-sized instant snapshot of a volume by breaking off plexes of the original volume.
Example: # vxsnap -g mydg make \ source=myvol/\ newvol=mysnpvol/\ nmirror=2 |
||
vxsnap [-g diskgroup] make \ source=volume/snapvol=snapvol |
Takes a full-sized instant snapshot of a volume using a prepared empty volume.
Example: # vxsnap -g mydg make \ source=myvol/snapvol=snpvol |
||
vxmake [-g diskgroup] cache \ cache_object cachevolname=volume \ [regionsize=size] |
Creates a cache object for use by space-optimized instant snapshots.
A cache volume must have already been created. After creating the cache object, enable the cache object with the vxcache start command. For example: # vxassist -g mydg make \ cvol 1g layout=mirror \ init=active mydg16 mydg17 # vxmake -g mydg cache cobj \ cachevolname=cvol # vxcache -g mydg start cobj |
||
vxsnap [-g diskgroup] make \ source=volume/newvol=snapvol\ /cache=cache_object |
Takes a space-optimized instant snapshot of a volume.
Example: # vxsnap -g mydg make \ source=myvol/\ newvol=mysosvol/\ cache=cobj |
||
vxsnap [-g diskgroup] refresh snapshot |
Refreshes a snapshot from its original volume.
Example: # vxsnap -g mydg refresh \ mysnpvol |
||
vxsnap [-g diskgroup] dis snapshot |
Turns a snapshot into an independent volume.
Example: # vxsnap -g mydg dis mysnpvol |
||
vxsnap [-g diskgroup] unprepare \ volume |
Removes support for instant snapshots and DRL logging from a volume. Example: # vxsnap -g mydg unprepare \ myvol |
||
vxassist [-g diskgroup] relayout \ volume [layout=layout] \ [relayout_options] |
Performs online relayout of a volume.
Example: # vxassist -g mydg relayout \ vol2 layout=stripe |
||
vxassist [-g diskgroup] relayout \ volume layout=raid5 \ stripeunit=W \ ncol=N |
Relays out a volume as a RAID-5 volume with stripe width W and N columns.
Example: # vxassist -g mydg relayout \ vol3 layout=raid5 \ stripeunit=16 ncol=4 |
||
vxrelayout [-g diskgroup] -o bg \ reverse volume |
Reverses the direction of a paused volume relayout.
Example: # vxrelayout -g mydg -o bg \ reverse vol3 |
||
vxassist [-g diskgroup] convert \ volume [layout=layout] \ [convert_options] |
Converts between a layered volume and a non-layered volume layout. Example: # vxassist -g mydg convert \ vol3 layout=stripe-mirror |
||
vxassist [-g diskgroup] remove \ volume volume |
Removes a volume.
Example: # vxassist -g mydg remove \ myvol |
Table: Monitoring and controlling tasks
Command |
Description |
---|---|
command [-g diskgroup] -t tasktag \ [options] [arguments] |
Specifies a task tag to a VxVM command.
Example: # vxrecover -g mydg \ -t mytask -b mydg05 |
vxtask [-h] [-g diskgroup] list |
Lists tasks running on a system.
Example: # vxtask -h -g mydg list |
vxtask monitor task |
Monitors the progress of a task.
Example: # vxtask monitor mytask |
vxtask pause task |
Suspends operation of a task.
Example: # vxtask pause mytask |
vxtask -p [-g diskgroup] list |
Lists all paused tasks. Example: # vxtask -p -g mydg list |
vxtask resume task |
Resumes a paused task.
Example: # vxtask resume mytask |
vxtask abort task |
Cancels a task and attempts to reverse its effects.
Example: # vxtask abort mytask |
More Information
Veritas Volume Manager manual pages
Using vxdiskadd to put a disk under VxVM control
Excluding a disk from hot-relocation use
Making a disk available for hot-relocation use
Marking a disk as a hot-relocation spare
Removing a disk from use as a hot-relocation spare
Importing disk groups as shared
Listing objects potentially affected by a move
Moving objects between disk groups
Changing the activation mode on a shared disk group
Moving relocated subdisks using vxunreloc
Creating a volume on specific disks
Creating volumes with exclusive open access by a node
Adding an instant snap DCO and DCO volume
Creating a volume for use as a full-sized instant or linked break-off snapshot
Creating a shared cache object
Refreshing an instant space-optimized snapshot