About Veritas Volume Manager commands

About Veritas Volume Manager commands

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
Note:
If you have not installed database software, you can omit /opt/VRTSdbed/bin, /opt/VRTSdb2ed/bin and /opt/VRTSsybed/bin. Similarly, /opt/VRTSvxfs/bin is only required to access some VxFS commands.
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
Command
 Description
vxdctl license
 List licensed features of VxVM.
vxdisk [-g diskgroup] list [diskname]
Lists disks under control of VxVM.
Example:
# vxdisk -g mydg list
vxdg list [diskgroup]
Lists information about disk groups.
Example:
# vxdg list mydg
vxdg -s list
 Lists information about shared disk groups.
Example:
# vxdg -s list
 
vxinfo [-g diskgroup] [volume ...]
Displays information about the accessibility and usability of volumes.
See the Veritas Volume Manager Troubleshooting Guide.
Example:
# vxinfo -g mydg myvol1 \
  myvol2
vxprint -hrt [-g diskgroup] [object ...]
Prints single-line information about objects in VxVM.
Example:
# vxprint -g mydg myvol1 \
  myvol2
vxprint -st [-g diskgroup] [subdisk ...]
Displays information about subdisks.
Example:
# vxprint -st -g mydg
vxprint -pt [-g diskgroup] [plex ...]
Displays information about plexes.
Example: 
# vxprint -pt -g mydg
Table: Administering disks
Command
 Description
vxdiskadm
 Administers disks in VxVM using a menu-based interface.
vxdiskadd [devicename ...]
 Adds a disk specified by device name.
Example:
# vxdiskadd c0t1d0
 
vxedit [-g diskgroup] rename \
olddisk newdisk
 Renames a disk under control of VxVM.
Example:
# vxedit -g mydg rename \
  mydg03 mydg02

vxedit [-g diskgroup] set \
reserve=on|off diskname
 Sets aside/does not set aside a disk from use in a disk group.
Examples:
# vxedit -g mydg set \
  reserve=on mydg02
# vxedit -g mydg set \
  reserve=off mydg02

vxedit [-g diskgroup] set \
nohotuse=on|off diskname
 Does not/does allow free space on a disk to be used for hot-relocation.
Examples:
# vxedit -g mydg set \
  nohotuse=on mydg03
# vxedit -g mydg set \
  nohotuse=off mydg03

vxedit [-g diskgroup] set \
spare=on|off diskname
 Adds/removes a disk from the pool of hot-relocation spares.
Examples:
# vxedit -g mydg set \
  spare=on mydg04
# vxedit -g mydg set \
  spare=off mydg04
vxdisk offline devicename
 Takes a disk offline.
Example:
# vxdisk offline c0t1d0
vxdg -g diskgroup rmdisk diskname
Removes a disk from its disk group.
Example:
# vxdg -g mydg rmdisk c0t2d0
vxdiskunsetup devicename
 Removes a disk from control of VxVM.
Example:
# vxdiskunsetup c0t3d0
Table: Creating and administering disk groups
Command
 Description 
vxdg [-s] init diskgroup \
 [diskname=]devicename
Creates a disk group using a pre-initialized disk.
Example:
# vxdg init mydg \
  mydg01=c0t1d0
 
vxsplitlines -g diskgroup
 Reports conflicting configuration information.
Example:
# vxsplitlines -g mydg
vxdg [-n newname] deport diskgroup
Deports a disk group and optionally renames it.
Example:
# vxdg -n newdg deport mydg
vxdg [-n newname] import diskgroup
Imports a disk group and optionally renames it.
Example:
# vxdg -n newdg import mydg
vxdg [-n newname] -s import diskgroup
Imports a disk group as shared by a cluster, and optionally renames it.
Example:
# vxdg -n newsdg -s import \
  mysdg
 
vxdg [-o expand] listmove sourcedg \
targetdg object ...
 Lists the objects potentially affected by moving a disk group.
Example:
# vxdg -o expand listmove \
  mydg newdg myvol1
 
vxdg [-o expand] move sourcedg \
targetdg object ...
 Moves objects between disk groups.
Example:
# vxdg -o expand move mydg \
  newdg myvol1
 
vxdg [-o expand] split sourcedg \
targetdg object ...
 Splits a disk group and moves the specified objects into the target disk group.
Example:
# vxdg -o expand split mydg \
  newdg myvol2 myvol3
vxdg join sourcedg targetdg
 Joins two disk groups.
Example:
# vxdg join newdg mydg
 
vxdg -g diskgroup set \
activation=ew|ro|sr|sw|off
 Sets the activation mode of a shared disk group in a cluster.
Example:
# vxdg -g mysdg set \
 activation=sw
vxrecover -g diskgroup -sb
 Starts all volumes in an imported disk group.
Example:
# vxrecover -g mydg -sb
vxdg destroy diskgroup
 Destroys a disk group and releases its disks.
Example:
# vxdg destroy mydg
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
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:
# vxassist -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/\
  nmiror=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, as shown in this example:
# vxassist -g mydg make \
  cvol 1g layout=mirror \
  init=active mydg16 mydg17
# vxmake -g mydg cache cobj \
  cachevolname=cvol
 
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
Online manual pages
Displaying disk information
Displaying disk group information
Listing shared disk groups
Displaying volume information
Displaying subdisk information
Displaying plex information
Using vxdiskadd to put a disk under VxVM control
Renaming a disk
Reserving disks
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
Taking a disk offline
Removing a disk from a disk group
Removing a disk from a disk group
Creating a disk group
Creating a shared disk group
Handling conflicting configuration copies
Deporting a disk group
Importing a disk group
Importing disk groups as shared
Listing objects potentially affected by a move
Moving objects between disk groups
Splitting disk groups
Joining disk groups
Changing the activation mode on a shared disk group
Moving disk groups between systems
Destroying a disk group
Associating subdisks with plexes
Associating subdisks with plexes
Moving subdisks
Splitting subdisks
Joining subdisks
Moving relocated subdisks using vxassist
Moving relocated subdisks using vxunreloc
Dissociating subdisks from plexes
Removing subdisks
Dissociating subdisks from plexes
Creating plexes
Creating a striped plex
Attaching and associating plexes
Reattaching plexes
Detaching plexes
Taking plexes offline
Reattaching plexes
Moving plexes
Copying plexes
Reattaching plexes
Dissociating and removing plexes
Discovering the maximum size of a volume
Creating a volume on any disk
Creating a volume on specific disks
Creating a mirrored volume
Creating volumes with exclusive open access by a node
Creating a striped volume
Creating a RAID-5 volume
Mirroring across targets, controllers or enclosures
Creating a volume using vxmake
Initializing and starting a volume
Starting a volume
Initializing and starting a volume
Adding a mirror to a volume
Removing a mirror
Resizing volumes using vxassist
Resizing volumes using vxassist
Resizing volumes using vxresize
Preparing a volume for DRL and instant snapshots
Creating instant snapshots
Creating instant snapshots
Creating a shared cache object
Creating instant snapshots
Refreshing an instant snapshot
Dissociating an instant snapshot
Removing support for DRL and instant snapshots from a volume
Performing online relayout
Performing online relayout
Volume sets
Converting between layered and non-layered volumes
Removing a volume
Specifying task tags
Using the vxtask command
Using the vxtask command
Using the vxtask command
Using the vxtask command
Using the vxtask command
Using the vxtask command

Comments

Post a Comment

Popular posts from this blog

BMCs and the IPMI Protocol

Image
Baseboard Management Controllers (BMCs) are a type of embedded computer used to provide out-of-band monitoring for desktops and servers. These products are sold under many brand names, including HP iLO, Dell DRAC, Sun ILOM, Fujitsu iRMC, IBM IMM, and Supermicro IPMI. BMCs are often implemented as embedded ARM systems, running Linux and connected directly to the southbridge of the host system's motherboard. Network access is obtained either via 'sideband' access to an existing network card or through a dedicated interface. In addition to being built-in to various motherboards, BMCs are also sold as pluggable modules and PCI cards. Nearly all servers and workstations ship with or support some form of BMC. The Intelligent Platform Management Interface (IPMI) is a collection of specifications that define communication protocols for talking both across a local bus as well as the network. This specification is managed by Intel and currently comes in two flavors, ve...
Read more

Logical Domains Reference Manual

Image
Name ldm– command-line interface for the Logical Domains Manager Synopsis ldm or ldm --help [ subcommand ] ldm -V ldm add-domain -i file ldm add-domain [mac-addr= num ] [hostid= num ] [failure-policy=ignore|panic|reset|stop] [master= master-ldom1 ,..., master-ldom4 ] ldom ldm add-domain ldom ... ldm set-domain -i file ldm set-domain [failure-policy=ignore|panic|reset|stop] [master=[ master-ldom1 ,..., master-ldom4 ]] ldom ldm remove-domain -a ldm remove-domain ldom ... ldm list-domain [-e] [-l] [-o format ] [-p] [ ldom ...] ldm migrate-domain [-n] source-ldom [ user @] target-host [: target-ldom ] ldm add-vcpu number ldom ldm set-vcpu number ldom ldm remove-vcpu number ldom ldm add-crypto number ldom ldm set-crypto number ldom ldm remove-crypto number ldom ldm add-memory size [ unit ] ldom ldm set-memory size [ unit ] ldom ldm remove-memory size [ unit ] ldom ldm cancel-operation (migration | reconf) ldom ldm add-io [bypass=on] bus ...
Read more

Understanding How ZFS Calculates Used Space

This document explains how ZFS calculates the amount of used space within a zpool and provides examples of how various ZFS features affect that calculation. DETAILS A ZFS storage pool is a logical collection of devices that provide space for datasets such as filesystems, snapshots and volumes. A zfs pool can be used as a filesystem, i.e. such as mounting/unmounting; to take snapshots that provides read-only (clones are writable copies of snapshots) copies of the filesystem taken in the past; to create volumes that can be accessed as a raw and a block device and for setting properties on datasets. Interaction of all these datasets and associated properties such as quotas, reservations, compression and deduplication (Solaris 11 only) play a role in how ZFS calculates space usage. Neither the du nor df command have been updated to account for ZFS file system space usage. When calculating zfs space usage, always use the following command. # zfs list -r -o space <pool_name...
Read more