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/VRTSdb2ed/bin:/opt/VRTSsybed/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/VRTSdb2ed/bin /opt/VRTSsybed/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
Command |
Description |
||
---|---|---|---|
vxmake [-g diskgroup] sd subdisk \ diskname,offset,length |
Creates a subdisk. See Creating subdisks. Example: # vxmake -g mydg sd \ mydg02-01 mydg02,0,8000 |
||
vxsd [-g diskgroup] assoc plex \ subdisk... |
Associates subdisks with an existing plex. Example: # vxsd -g mydg assoc home-1 \ mydg02-01 mydg02-00 \ mydg02-01 |
||
vxsd [-g diskgroup] assoc plex \ subdisk1:0 ... subdiskM:N-1 |
Adds subdisks to the ends of the columns in a striped or RAID-5 volume. Example: # vxsd -g mydg assoc \ vol01-01 mydg10-01:0 \ mydg11-01:1 mydg12-01:2 |
||
vxsd [-g diskgroup] mv oldsubdisk \ newsubdisk ... |
Replaces a subdisk. Example: # vxsd -g mydg mv mydg01-01 \ mydg02-01 |
||
vxsd [-g diskgroup] -s size split \ subdisk sd1 sd2 |
Splits a subdisk in two. Example: # vxsd -g mydg -s 1000m \ split mydg03-02 mydg03-02 \ mydg03-03 |
||
vxsd [-g diskgroup] join \ sd1 sd2 ... subdisk |
Joins two or more subdisks. Example: # vxsd -g mydg join \ mydg03-02 mydg03-03 \ mydg03-02 |
||
vxassist [-g diskgroup] move \ volume \!olddisk newdisk |
Relocates subdisks in a volume between disks.
Example: # vxassist -g mydg move \ myvol \!mydg02 mydg05
|
||
vxunreloc [-g diskgroup] original_disk |
Relocates subdisks to their original disks.
Example: # vxunreloc -g mydg mydg01 |
||
vxsd [-g diskgroup] dis subdisk |
Dissociates a subdisk from a plex.
Example: # vxsd -g mydg dis mydg02-01 |
||
vxedit [-g diskgroup] rm subdisk |
Removes a subdisk.
Example: # vxedit -g mydg rm mydg02-01 |
||
vxsd [-g diskgroup] -o rm dis subdisk |
Dissociates and removes a subdisk from a plex.
Example: # vxsd -g mydg -o rm dis \ mydg02-01 |
Table: Creating and administering plexes
Table: Creating volumes
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. See Creating a volume for use as a full-sized instant or linked break-off snapshot.
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
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
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
Creating a shared cache object
Refreshing an instant snapshot
Dissociating an instant snapshot
Removing support for DRL and instant snapshots from a volume