Home > Veritas Storage Foundation™ Volume Manager Manual Pages
VXDISKSETUP (1M) |
|
Maintenance Commands |
Table of contents
vxdisksetup, vxdiskunsetup - configure a disk for use with Veritas Volume Manager
vxdisksetup
[-ifB]
disk_address
[attribute ...]
vxdisksetup
[-ifB]
disk_address
format=aixdisk
[attribute ...]
vxdisksetup
[-if]
disk_address
format=cdsdisk
[attribute ...]
/etc/vx/bin/vxdiskunsetup
[-C]
[-F]
disk_address...
The vxdisksetup command configures the disk for
use by Veritas Volume Manager (VxVM).
vxdisksetup is called by the vxdiskadd
command as part of initial disk configuration.
It is not typically necessary to call this command directly.
Note: In release 4.0 of VxVM, the behavior of the vxdisksetup command
has been changed so that it only creates auto-configured disks
(with a disk access type of auto; see vxdisk(1M)), which can
have one of the following formats:
-
aixdisk
-
The disk is formatted to include a private region
that VxVM uses to store configuration information.
Following the private region, the remainder of the
disk forms the public region from which subdisks can be allocated.
This format can be applied to disks that can be used to boot the system.
If the disk is not initialized as a boot disk,
space is reserved on the disk to allow it
to be converted to cdsdisk format if required.
The aixdisk format is the default for EFI disks.
-
cdsdisk
-
The disk is formatted as a CDS disk that is suitable for moving between
different operating systems. This is the default format for non-EFI disks
(provided that the -i option is used to write the disk header).
It is not suitable for boot disks or EFI disks.
Note: As the CDS format is applied to the entire disk and is unsuitable for
boot disks, options and attributes that relate to partitions, slices
or booting are not applicable.
The CDS format is also incompatible with EFI disks.
-
none
-
The disk is unformatted.
Note: This value may be displayed, but it cannot be set as a valid format.
The vxdiskunsetup command reverses the configuration done by
vxdisksetup and makes the specified disks unusable by VxVM.
vxdiskunsetup can be applied only to VxVM-initialized disks
that are not in use within an imported disk group.
The disk_address argument passed to vxdisksetup or to
vxdiskunsetup directs the command to the device that corresponds to
the disk being operated upon.
The address usually takes the form enclosurename_#
or hdisk#.
The name must
reference a valid disk under the /dev/vx/rdmp directory.
The
vxdiskunsetup
command operates by removing the public and
private regions that were created by the last invocation of
vxdisksetup
on the specified disks.
After this operation, those disks are converted
from the online to the error state
state (as displayed by vxdisk list).
The /etc/default/vxdisk file can be used to set the default values
of the format and privlen attributes
for the vxdisk and vxdisksetup commands.
Values in this file override inbuilt values,
and may themselves be overridden by values
specified on the command line.
For details, see the vxdisk(1M) manual page.
-
-B
-
Initializes the Veritas Volume Manager private region
to begin at block number 2144.
This block is designated as the private region
offset for a Veritas Volume Manager root disk.
Without this option,
the private region is initialized to start at the default
block number 128.
Note: This option is not supported for cdsdisk format disks.
-
-C
-
vxdiskunsetup
usually does not operate on disks that
appear to be imported by some other host (for example, a host that
shares access to the disk).
In this case, the -C option can be
specified to force de-configuration of the disk,
effectively removing the
host locks that were detected by vxdiskunsetup.
-
-f
-
Forces a disk to be initialized even if it is a member of a deported
disk group.
-
-F
-
By default, the vxdiskunsetup command only operates on online disks.
It does not operate on disks that are imported or offline.
This option forces an unsetup operation to be performed on such disks.
-
-i
-
Writes a disk header to the disk,
initializes the private region of the disk and
makes the disk directly usable (as
a new disk in a disk group, for example).
Note: A disk that is a member of an imported disk group
cannot be initialized. The command also fails if the
disk is a member of a deported disk group.
The -f option can be used to override the latter restriction.
You can specify attributes to affect the layout strategy used by
vxdisksetup.
CAUTION: Take great care when using these attributes as
they can render a disk unusable by VxVM.
-
config
-
Sets up kernel logs or configuration databases on the disk.
This attribute has the opposite effect to the
noconfig attribute.
This is the default behavior if
the -i option is specified.
Otherwise, the attribute is ignored.
-
noconfig
-
Prevents setting up kernel logs or
configuration databases on the disk.
The size of the default private region
is set to 160 blocks,
which is the minimum allowed private region size.
noconfig
is ignored unless the -i
option is specified.
-
noreserve
-
Do not reserve space for conversion to other formats such as cdsdisk.
-
privlen=length
-
Specifies the length of the private region of the disk.
The default size of this area is 32MB.
The maximum possible size of the private region is 524288 blocks.
For cdsdisk format disks, privlen is silently
rounded up to the nearest multiple of 8KB if it is not already a multiple of
8KB.
-
privoffset=offset
-
Indicates the sector offset of the private region on the disk.
The default value for the private region offset is block number 128 for
non-boot disks and block number 2144 for boot disks.
For cdsdisk format disks, privoffset is silently
rounded up to the nearest multiple of 8KB that is larger than or equal to
128KB if it is not already a multiple of 8KB
or if its value is less than 128KB.
-
publen=length
-
Specifies the length of the public region of the disk.
This defaults to the size of the disk minus the private
area on the disk.
For cdsdisk format disks, publen is silently
rounded up to the nearest multiple of 8KB if it is not already
a multiple of 8KB.
-
puboffset=offset
-
Sets the offset on the disk where the public region starts.
By default, this is past the end of the private region.
For the aixdisk format,
128 blocks of disk space are reserved at the
end of the private region unless this is overridden by the value of
puboffset or the -B option is specified.
The reserved space allows for later conversion to the cdsdisk format.
For cdsdisk format disks, puboffset is silently
rounded up to the nearest multiple of 8KB if it is not already
a multiple of 8KB.
To initialize a disk for regular use, enter:
/etc/vx/bin/vxdisksetup -i enc1_3
To initialize a disk for normal use,
but set the private region size to 1MB
instead of the default size of 32MB, enter:
/etc/vx/bin/vxdisksetup -i hdisk12 privlen=1m
Force deconfiguration of a VxVM-initialized disk, enc3_5:
/etc/vx/bin/vxdiskunsetup -C enc3_5
The default private region size increased from
512KB to 1MB in release 3.2, and from
1MB to 32MB in release 5.0.
-
/etc/default/vxdisk
-
Defaults file used by the vxdisk and vxdisksetup utilities.
vxcdsconvert(1M),
vxdisk(1M),
vxdiskadd(1M),
vxintro(1M)
Last updated: 5 Jan 2006
Copyright ©2009 Symantec Corporation
All rights reserved.