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. For information about creating snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide. 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. For information about snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide. 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. For information about snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide. 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. For information about creating snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide. Example: # vxsnap -g mydg make \ source=myvol/\ newvol=mysosvol/\ cache=cobj |
||
vxsnap [-g diskgroup] refresh snapshot |
Refreshes a snapshot from its original volume. For information about snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide. Example: # vxsnap -g mydg refresh \ mysnpvol |
||
vxsnap [-g diskgroup] dis snapshot |
Turns a snapshot into an independent volume. For information about snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide. Example: # vxsnap -g mydg dis mysnpvol |
||
vxsnap [-g diskgroup] unprepare \ volume |
Removes support for instant snapshots and DRL logging from a volume. For information about snapshots, see the Veritas Storage Foundation Advanced Features Administrator's Guide.
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
Displaying disk group information
Displaying subdisk information
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
Thin Reclamation of a disk, a disk group, or an enclosure
Removing a disk from a disk group
Removing a disk from a disk group
Handling conflicting configuration copies
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 disk groups between systems
Associating subdisks with plexes
Associating subdisks with plexes
Moving relocated subdisks using vxassist
Moving relocated subdisks using vxunreloc
Dissociating subdisks from plexes
Dissociating subdisks from plexes
Attaching and associating plexes
Dissociating and removing plexes
Discovering the maximum size of a volume
Creating a volume on specific disks
Creating volumes with exclusive open access by a node
Mirroring across targets, controllers or enclosures
Creating a volume using vxmake
Initializing and starting a volume
Initializing and starting a volume
Resizing volumes with vxassist
Resizing volumes with vxassist
Resizing volumes with vxresize
Preparing a volume for DRL and instant snapshots
Removing support for DRL and instant snapshots from a volume