![]() |
< Previous | Next > |
Product: Volume Manager Guides | |
Manual: Volume Manager 4.1 Administrator's Guide |
Appendix: Commands SummaryThis appendix summarizes the usage and purpose of important commonly used commands in VERITAS Volume Manager (VxVM). References are included to longer descriptions in the remainder of this book. Most 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:
$ 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 % 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. A list of manual pages is provided in Online Manual Pages. 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. The following tables summarize the commonly used commands:
Obtaining Information About Objects in VxVM
Lists disks under control of VxVM. See Displaying Disk Information.
Lists information about disk groups. See Displaying Disk Group Information.
Lists information about shared disk groups. See Listing Shared Disk Groups.
Displays information about the accessibility and usability of volumes. See "Listing Unstartable Volumes" in the VERITAS Volume Manager Troubleshooting Guide.
Prints single-line information about objects in VxVM. See Displaying Volume Information.
Displays information about subdisks. See Displaying Subdisk Information.
Displays information about plexes. See Displaying Plex Information.
Adds a disk specified by device name. See Using vxdiskadd to Place a Disk Under Control of VxVM.
Renames a disk under control of VxVM. See Renaming a Disk.
Sets aside/does not set aside a disk from use in a disk group. See Reserving Disks.
Does not/does allow free space on a disk to be used for hot-relocation. See Excluding a Disk from Hot-Relocation Use and Making a Disk Available for Hot-Relocation Use.
Adds/removes a disk from the pool of hot-relocation spares. See Marking a Disk as a Hot-Relocation Spare and Removing a Disk from Use as a Hot-Relocation Spare.
Takes a disk offline. See Taking a Disk Offline.
Removes a disk from its disk group. See Removing a Disk from a Disk Group.
Removes a disk from control of VxVM. See Removing a Disk from a Disk Group.
Creating and Administering Disk Groups
Creates a disk group using a pre-initialized disk. See Creating a Disk Group and Creating a Shared Disk Group.
Reports conflicting configuration information. See Handling Conflicting Configuration Copies in a Disk Group.
Deports a disk group and optionally renames it. See Deporting a Disk Group.
Imports a disk group and optionally renames it. See Importing a Disk Group.
Imports a disk group as shared by a cluster, and optionally renames it. See Importing Disk Groups as Shared.
Lists the objects potentially affected by moving a disk group. See Listing Objects Potentially Affected by a Move.
Moves objects between disk groups. See Moving Objects Between Disk Groups.
Splits a disk group and moves the specified objects into the target disk group. See Splitting Disk Groups.
Joins two disk groups. See Joining Disk Groups.
Sets the activation mode of a shared disk group in a cluster. See Changing the Activation Mode on a Shared Disk Group.
Starts all volumes in an imported disk group. See Moving Disk Groups Between Systems for an example of its use.
Destroys a disk group and releases its disks. See Destroying a Disk Group.
Creating and Administering Subdisks
Creates a subdisk. See Creating Subdisks.
Associates subdisks with an existing plex. See Associating Subdisks with Plexes.
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. See Associating Subdisks with Plexes.
# vxsd -g mydg assoc vol01-01 \ mydg10-01:0 mydg11-01:1 mydg12-01:2
Replaces a subdisk. See Moving Subdisks.
Splits a subdisk in two. See Splitting Subdisks.
# vxsd -g mydg -s 1000m split \ mydg03-02 mydg03-02 mydg03-03
Joins two or more subdisks. See Joining Subdisks.
Relocates subdisks in a volume between disks. See Moving and Unrelocating Subdisks Using vxassist.
Relocates subdisks to their original disks. See Moving and Unrelocating Subdisks Using vxunreloc.
Dissociates a subdisk from a plex. See Dissociating Subdisks from Plexes.
Removes a subdisk. See Removing Subdisks.
Dissociates and removes a subdisk from a plex. See Dissociating Subdisks from Plexes.
Creating and Administering Plexes
vxmake [-g diskgroup] plex plex \ sd=subdisk1[,subdisk2,...]
Creates a concatenated plex. See Creating Plexes.
vxmake [-g diskgroup] plex plex \ layout=stripe|raid5 stwidth=W \ ncolumn=N sd=subdisk1[,subdisk2,...]
Creates a striped or RAID-5 plex. See Creating a Striped Plex.
# vxmake -g mydg plex pl-01 \ layout=stripe stwidth=32 \
Attaches a plex to an existing volume. See Attaching and Associating Plexes and Reattaching Plexes.
Detaches a plex. See Detaching Plexes.
Takes a plex offline for maintenance. See Taking Plexes Offline.
Re-enables a plex for use. See Reattaching Plexes.
Replaces a plex. See Moving Plexes.
Copies a volume onto a plex. See Copying Plexes.
Sets the state of a plex in an unstartable volume to CLEAN. See Reattaching Plexes.
Dissociates and removes a plex from a volume. See Dissociating and Removing Plexes.
vxassist [-g diskgroup] maxsize \ layout=layout [attributes]
Displays the maximum size of volume that can be created. See Discovering the Maximum Size of a Volume.
vxassist -b [-g diskgroup] make \ volume length [layout=layout ] [attributes]
Creates a volume. See Creating a Volume on Any Disk and Creating a Volume on Specific Disks.
# 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. See Creating a Mirrored Volume.
# 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. See Creating Volumes with Exclusive Open Access by a Node.
# 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. See Creating a Striped Volume and Creating a RAID-5 Volume.
# 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. See Mirroring across Targets, Controllers or Enclosures.
# 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. See Creating a Volume Using vxmake.
# vxmake -g mydg -Uraid5 vol r5vol \ plex=raidplex,raidlog1,raidlog2
Initializes and starts a volume for use. See Initializing and Starting a Volume and Starting a Volume.
Initializes and zeros out a volume for use. See Initializing and Starting a Volume.
Adds a mirror to a volume. See Adding a Mirror to a Volume.
Removes a mirror from a volume. See Removing a Mirror.
Grows a volume to a specified size or by a specified amount. See Resizing Volumes using vxassist.
Shrinks a volume to a specified size or by a specified amount. See Resizing Volumes using vxassist.
vxresize -b -F xvfs [-g diskgroup] \ volume length diskname ...
Resizes a volume and the underlying VERITAS File System. See Resizing Volumes using vxresize.
Prepares a volume for instant snapshots and for DRL logging. See Preparing a Volume for DRL and Instant Snapshots.
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. See Creating Instant Snapshots.
# vxsnap -g mydg make \ source=myvol/newvol=mysnpvol\
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 Snapshot and Creating Instant Snapshots.
vxmake [-g diskgroup] cache \
Creates a cache object for use by space-optimized instant snapshots. See Creating a Shared Cache Object. 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
vxsnap [-g diskgroup] make \ source=volume/newvol=snapvol\ /cache=cache_object
Takes a space-optimized instant snapshot of a volume. See Creating Instant Snapshots.
# vxsnap -g mydg make \ source=myvol/newvol=mysosvol\
Refreshes a snapshot from its original volume. See Refreshing an Instant Snapshot (vxsnap refresh).
Turns a snapshot into an independent volume. See Dissociating an Instant Snapshot (vxsnap dis).
Removes support for instant snapshots and DRL logging from a volume. See Removing Support for DRL and Instant Snapshots from a Volume.
vxassist [-g diskgroup] relayout volume \ [layout=layout] [relayout_options]
Performs online relayout of a volume. See Performing Online Relayout.
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. See Performing Online Relayout.
# vxassist -g mydg relayout \ vol3 layout=raid5 \ stripeunit=16 ncol=4
Reverses the direction of a paused volume relayout. See Controlling the Progress of a Relayout.
vxassist [-g diskgroup] convert volume \ [layout=layout] [convert_options]
Converts between a layered volume and a non-layered volume layout. See Converting Between Layered and Non-Layered Volumes.
Removes a volume. See Removing a Volume.
Monitoring and Controlling Tasks
Specifies a task tag to a VxVM command. See Specifying Task Tags.
Lists tasks running on a system. See vxtask Usage.
Monitors the progress of a task. See vxtask Usage.
Suspends operation of a task. See vxtask Usage.
Lists all paused tasks. See vxtask Usage.
Resumes a paused task. See vxtask Usage.
Cancels a task and attempts to reverse its effects. See vxtask Usage.
|
^ Return to Top | < Previous | Next > |
Product: Volume Manager Guides | |
Manual: Volume Manager 4.1 Administrator's Guide | |
VERITAS Software Corporation
www.veritas.com |