Home > Veritas Storage Foundation™ Volume Manager Manual Pages
Table of contents
vxmake - format of a vxmake description file
Descriptions of configuration records can be given to the
vxmake utility either on the command line or in a file.
Descriptions given on the command line can specify only one new
record. Descriptions given in a description file can specify more
than one record. The description file format is a convenient way of
indicating record contents for other uses as well. For example, the
vxprint utility can print records in this format to provide
input to a shell or awk script that can be more easily parsed
than other verbose formats.
Note: Although it is possible to use vxmake to create
new volumes from an appropriate description file,
it is recommended that you use vxassist,
vxvoladm, or the graphical user interface instead.
Note: The Configuration Backup and Restore utilities,
vxconfigbackup and vxconfigrestore, are the recommended method
for backing up and restoring volume hierarchies.
In many places within the utility set where a user can specify a field
name and a value, a format is used that specifies only one
configuration field, rather than complete configuration records.
vxmake description files specify configuration records, one
after another. Each record description specifies a record type, name,
and zero or more fields.
The record type is a single keyword from the set vol,
plex, sd, dm, or dg, to indicate a volume,
plex, subdisk, disk media, or disk group record, respectively. The
record name must be specified on the same line as the record type
keyword.
The vxmake utility does not take disk media or disk group
record descriptions on input. The vxprint utility can print
descriptions of disk media and disk group records in this format
though.
Fields are specified as a field name and a field value separated by a
single = character. A record description can span more than one
line if its continuation lines begin with a character that is a space
or tab. Empty lines are ignored and do not end a record description.
Comments can be included in a record description. A comment is
introduced with the character #, either at the beginning of a
line, or after a blank that is not used as part of a field value.
Comments continue until the next new line character or until the
end-of-file.
A field specification normally ends with the next white-space
character. A field can be extended until the end of a line by
preceding the field value with one double-quote character ("). Such
quoted strings extend until the next newline, rather than until a
double quote. This makes vxmake descriptions easier to
generate within shell scripts.
An example of a valid configuration file is
vol v1 usetype=gen # simple gen volume with no plexes
plex p1 # plex with no subdisk
plex p2 sd=s1:0,s2:1 # striped plex with two columns
# and a comment
comment="This is a comment
layout=stripe ncolumn=2 stwidth=64k
plex p2 sd=s3:16384 # free plex with hole at beginning
# subdisks
sd s1 disk=disk01 len=1g+512m offset=0
sd s2 disk=disk02 len=512m-1 offset=0
sd s3 path=disk03 len=32768 offset=512m-1
Sometimes a utility gets field descriptions from somewhere other than
a vxmake description file and uses that field description to
set a field in a volume, plex, or subdisk record. In these cases, the
utility itself has a quoting convention for separating one field from
another. An example of a utility that does this is vxedit.
The vxedit utility takes field descriptions from the command
line. For example, the following vxedit command sets a comment
for the record named v1:
vxedit set comment="Henry \"Hank\" Finklestein's volume" v1
Shell quoting conventions are sufficient to allow for double quotes
and spaces, so no quoting conventions are defined for these simple
field descriptions.
Within vxmake description files any volume, plex, or subdisk
field can be specified. However, some field settings are ignored.
This allows a user to use a command such as:
vxprint -vpshm v1
to get a set of record descriptions that can be fed back into
vxmake, possibly with some changes. If this is done, then any
field that cannot be set is ignored, but the resulting record
hierarchy, plex layout, and subdisk offsets are the same, along with
most or all fields that are normally administrator-definable.
Different fields have different properties with respect to the
description language. The classes of fields are
-
boolean
-
Boolean fields contain a truth value. The value for a boolean field
can be either off or on. Alternately, yes or
no, or true or false can be used. vxprint
prints truth values as on or off.
-
device-number
-
Device numbers define the major and minor number of a device. These
numbers are in the form major-number.minor-number where
major-number and minor-number are both simple numbers. In
some cases, the device number will be VOLNODEV, indicating that the
device number is undefined.
-
enumeration
-
An enumeration field can be set to one of a set of symbolic values.
The set of symbolic values for enumeration fields are specified in the
field descriptions below. The enumeration fields are listed in this
manual page in upper case. These enumeration constants can be given
as input in either all upper-case letters, or all lower-case letters.
-
length-number
-
Fields which define object sizes of some type, such as volume lengths,
plex offsets, or stripe widths, have the syntax of standard
Veritas Volume Manager length numbers, as defined in vxintro(1M).
This syntax consists of one or more numbers separated by + or -
to indicate addition or subtraction.
Each separate number in the string can have a prefix of 0x to
indicate that the number is in hexadecimal, or a prefix of 0 to
indicate octal. Suffix characters can be used to specify the unit for
the number. Defined suffixes are: b for 512-byte blocks,
s for standard system sectors, k for kilobytes, m
for megabytes, and g for gigabytes. Suffix letters can be
specified either upper case or lower case.
The size of a sector is system dependent. On most systems it is 512
bytes, the same as blocks. On systems that support disks with
differing sector sizes, one standard sector size is chosen as the
standard.
The unit for a number is in sectors by default. vxprint prints
length numbers as a decimal number of sectors, with no unit suffix.
Since b and B are valid digits in a hexadecimal number, a
single space must be used to separate the hexadecimal number from the
suffix. Double quote are not necessary in Record Description Format,
unlike the rules for string-valued fields that contain spaces.
Unless otherwise indicated, all length numbers must be greater than or
equal to zero.
-
name
-
A record name field can be an arbitrary string of up to fourteen
characters. However, a name cannot contain a null byte, white-space
characters, or the character /.
-
record ID or sequence number
-
These types are 64-bit numbers encoded as two 32-bit unsigned simple
numbers. These are values assigned to records or to configuration
changes, respectively. The record ID assigned to a record is
guaranteed to be unique within that disk group. Also, that record ID
will never be reused if the record is deleted.
Every time the configuration of a disk group is updated, the
configuration update sequence number is increased. The configuration
update sequence number only increases; it never decreases. This can
be used to determine the order in which records were changed, or as a
quick test for what has changed since a known time in the past.
Record IDs and sequence numbers have the form
high-part.low-part, where both high-part and
low-part are simple unsigned numbers.
-
simple-number
-
Simple numbers are used for counts or for other purposes besides
representation of a length of offset. Simple numbers can be specified
in decimal (default), hexadecimal, or octal using the 0x or
0 prefixing convention. No suffixes or arithmetic are defined
for simple numbers.
-
string
-
Other types of string fields can contain any characters other than a
null byte or a newline. Different string fields have different
length restrictions.
Some additional one-of-a-kind field types also exist. These are
described in the description for the corresponding field.
Many fields have aliases that can be used in vxmake
descriptions. In all cases, the vxprint -m format uses the
first name given for each field. However, alias field names can be
used in format strings specified to vxprint with the -F
option. All field names containing underscores have an alias that is
identical but lacks the underscores. For example, start_opts
has an alias of startopts.
The following fields are defined for volume records:
-
active
-
A boolean. This is set to on if the volume was open and had at
least one pending write at the time of the last system failure.
Utilities can use this flag to indicate that plex consistency recovery
should be performed. If this flag is off, the volume should not
require any recovery.
-
badlog
-
A boolean. This flag is set to on if write failures occur on
all logging subdisks for a volume that has dirty region logging
enabled. Dirty region logging cannot be re-enabled until this flag is
turned off. This flag can be turned off by changing the logging type
of the volume to NONE and setting it back to DRL.
-
bdev (alias: dev)
-
The block device number for the volume. This is a read-only field and
attempts to set it are ignored.
-
cache_name
-
A string containing the name of the cache if the volume is
a cache volume that is used in space-optimized instant snapshot operation.
This field is read-only.
-
cascaded
-
A boolean value indicating whether an instant snapshot volume
reads data from a sibling snapshot volume instead of from its parent volume.
This flag is read-only.
-
cdev
-
The character (raw) device number for the volume. This is a read-only
field and attempts to set it are ignored.
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
config_id, config_epoch
-
Simple unsigned number fields. These are the lower and upper 32 bits,
respectively, of the update_tid field. These fields are
provided for backward compatibility with earlier releases of VxVM.
This field is not printed by the -m flag to
vxprint.
These are read-only fields and attempts to set them will be ignored.
-
detach_tid
-
The configuration update sequence number in effect the last time the
plex was detached by an I/O failure. This is a read-only field and
attempts to set it are ignored.
-
fastresync
-
A boolean. This indicates whether or not FMR is enabled.
-
forceminor
-
A boolean. If this is on, then the volume can use one of the
reserved minor numbers (zero through four).
-
fstype
-
A name field. This is the file system type associated with the volume
contents. A usage type is free to use or ignore this value.
-
group
-
This is either a group name or a decimal group ID. The value
specifies the user that owns the volume block and character devices.
-
hasdcomap
-
A boolean value indicating whether the volume has a data change object
(DCO) volume.
The value of the instant field indicates whether
the DCO supports instant snapshot operations.
-
incomplete
-
A boolean value indicating whether the contents of an instant
snapshot volume are dependent on another volume
(that is, it is not fully synchronized).
This flag is read-only.
-
inst_invalid
-
A boolean value indicating whether an instant snapshot volume
is not usable. A volume fails to start if this flag is set on.
This flag is read-only.
-
inst_src_guid
-
The global unique ID of the source volume for an incomplete snapshot volume.
This field is read-only.
-
instant
-
A boolean value indicating whether the DCO that is associated with a volume
supports instant snapshot operations.
Note: Instant snapshot operations require that the DCO version is 20 or greater.
Version 0 DCOs do not support such operations.
This flag is read-only.
-
iosize
-
The smallest I/O size allowed on the volume. This corresponds to the
largest sector size for any disk included in the volume. The current
release of VxVM does not support disks with differing
sector sizes. As a result, in the current release this value will
always match the system default sector size (normally 512 bytes).
-
iscachevol
-
A boolean value indicating whether a volume is being used as
a cache volume for space-optimized instant snapshot operations.
This flag is read-only.
-
kstate
-
An enumeration field. This is the kernel-enabled state of the volume.
Possible values are ENABLED, DISABLED, and DETACHED.
-
lasterr
-
A simple number field. This is the sequence number of the last error
on the volume. It is a read-only field and attempts to set it are
ignored. This number does not have a default multiplier, so lack of a
suffix specifies a simple integer.
-
len
-
A length number field. This is the volume length. If a volume is
created in vxmake with a plex attribute that associates
plexes, the volume length will default to the length of the shortest
associated plex. If no plexes are associated at creation time, the
volume length defaults to zero, though a warning will be printed.
-
log_len
-
The length for the volume's logging area. This is primarily intended
for use with future logging types. When used with dirty region
logging, the only currently available method of logging, the value of
log_len must be an even number of blocks between two and ten
blocks long.
-
logmap_len=size
-
Specifies the maximum usable size of a DRL or DCM log.
This value must be a positive integer multiple of the
alignment value for the disk group (see vxdg(1M)).
-
log_serial_lo and log_serial_hi
-
Simple unsigned number fields. These values, taken together, yield a
value that is increased for every log write that occurs to a volume
with logging enabled.
These are read-only fields and attempts to set them are ignored.
-
log_type
-
An enumeration field. This is the logging type for the volume.
Possible values are: UNDEF, NONE, and DRL. The
first two possible values indicate that logging is disabled, and the
third value indicates use of dirty region logging, where block numbers
for write operations are logged before the corresponding blocks are
actually written to disk.
The UNDEF value indicates that no logging policy has yet been
chosen. If a log subdisk is associated to a volume with the
UNDEF policy, the policy will be changed to DRL
automatically.
-
logging
-
A boolean field. This is on if logging is enabled on the
volume. Logging is enabled for a volume if the log type for the
volume supports logging, the volume is enabled, the badlog flag
is not set, and the volume has at least one enabled, associated plex
with an enabled log subdisk. Normally, usage types do not enable
logging if only one plex in the volume has a log subdisk.
This is a read-only field and attempts to set it are ignored.
-
minor
-
A simple number field. This is the minor number to use for the volume
block and character devices. If volumes in two disk groups attempt to
use the same minor number, one of the volumes will be given a
different one. To determine the actual device number used for a
particular volume, get the cdev and bdev fields.
If a minor number is specified as input to vxmake, the number
will be used if it is not already in use, or is reserved; otherwise, a
minor number will be chosen that is not currently in use or reserved.
Minor numbers from zero to four are reserved for internal purposes.
-
mode
-
This is a symbolic or numeric file permission mode. This can be any
string that is acceptable to chmod(1) for setting the mode of a
file.
-
open
-
A boolean field. This is on if the volume is open or mounted.
This is a read-only field and attempts to set it are ignored.
-
pl_num (alias: nplex)
-
A number field. This is the number of plexes associated with the
volume. This is a read-only field and attempts to set it are ignored.
-
plex
-
A list of names for plexes to associate with the volume. The names
are separated in the list by a comma or by blanks. If a list is
specified as input to vxmake, then the indicated plexes will be
associated with the volume.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters. These are the
permanent utility fields, which are preserved across a reboot. The
first field is reserved for usage-type utilities. The second field is
reserved for utilities, such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store their own state
into records.
The third field is reserved for local installations.
-
.PD 0
-
read_pol, pref_name, pref_plex_rid,
-
.PD
-
current_read_pol (alias: creadpol)
read_pol is an enumeration field. This is the read policy for
the volume. Possible values are ROUND, PREFER,
SELECT. A value of ROUND indicates round-robin read
scheduling, PREFER indicates a preferred plex. Round-robin
scheduling scatters reads evenly between all plexes. Preferred-plex
read scheduling attempts to use a single plex for all reads.
Typically, if a volume consists of one striped plex and one
non-striped plex, it is better to read only from the striped plex.
This is because the striped plex can handle more write traffic and is
thus more likely to be free to accept read requests with a minimum of
delay.
If the SELECT read policy is used, the actual read policy
(round-robin or preferred plex), is chosen automatically. The policy
chosen with SELECT is to prefer a striped plex if there is
exactly one striped plex in the volume, and to use round-robin
otherwise. The read policy that is actually in effect is
stored in current_read_pol.
If a preferred plex policy is in effect, either because PREFER
is set or because the SELECT policy chose the preferred-plex
policy, the value of pref_name indicates the name of the
preferred plex. The SELECT policy sets the value of
pref_name automatically. The ROUND policy ignores any
value stored in pref_name.
The record ID for the preferred plex can be set or displayed with
pref_plex_rid.
-
r_all, r_some, w_all, w_some
-
Enumeration fields. These are the exception policies for the volume,
for read errors on all plexes, read errors on some plexes, write errors
on all plexes, and write errors on some plexes. Possible values for
these fields are
NO_OP,
FAIL_OP,
DET_PL,
FAIL_DET_PL,
DET_VOL,
FAIL_DET_VOL,
GEN_DET,
GEN_DET_SPARSE,
GEN_FAIL,
and
GEN_DET2.
Usage types normally ignore any attempts to set these fields in
vxmake.
-
restore
-
A boolean value indicating whether the contents of a
volume are being restored from an instant snapshot.
This flag is read-only.
-
rid
-
The record ID for the volume record.
-
rwback, krwback, rwback_offset
-
rwback and krwback are booleans. rwback_offset is a
length number. rwback is set to on to enable
read-writeback mode on a volume. If this is set, then reads from the
volume past rwback_offset perform a recovery procedure that
ensures that all plexes are consistent before the read operation
completes. Reads that occur at the current read-writeback offset will
advance the offset. If the read-writeback offset reaches the end of
the volume, read-writeback will be turned off. The value of
krwback indicates whether read-writeback is actually in effect.
These fields are set by usage types. Attempts to set these fields in
vxmake are ignored.
-
snap_after_restore
-
A boolean value indicating whether a snapshot volume was created
while its parent volume was being restored.
This flag is read-only.
-
source
-
The record ID of the source volume for an incomplete snapshot volume.
This field is read-only.
-
start_opts
-
A comment-type field of up to 32 characters. This field is used in a
usage-type-dependent manner. The existing usage types use this field
as a set of options to apply to the volume for the vxvol start
operation.
-
state
-
A comment field of up to fourteen characters. This field represents a
usage-type-dependent volume state.
Usage types normally ignore attempts to set this field in
vxmake.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters. These are the
temporary utility fields, which are cleared by a reboot. The first
field is reserved for usage-type utilities, and is typically used to
define operation locks. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA), that use the usage-type
utilities and that need to store their own state into records. The
third field is reserved for use by local installations.
-
update_tid
-
The configuration update sequence number for the last transaction to
update this record. This is a read-only field and attempts to set it
are ignored.
-
use_type
-
A name field. This is the name of the usage type for the volume.
-
user
-
This is either a user name or a decimal user ID. The value specifies
the user that owns the volume block and character devices.
-
vset_context
-
The context string assigned to this volume within a volume set.
This field is read-only.
-
vset_id
-
The index of this volume within a volume set.
This field is read-only.
-
vset_rid
-
The record ID of the volume set of which this volume is a member.
This field is read-only.
-
writeback
-
A boolean field. If on, then if a read failure on one plex of a
multiplex volume the block will be read from another plex and written
back to the plex with the failure. This often corrects the I/O
failure. If the writeback
succeeds, the failure is ignored and no action is taken to detach the
plex.
-
writecopy, specify_writecopy
-
Boolean fields. If writecopy is on, then writes to the
volume will be copied prior to being written to disk. This prevents
pages of memory that are undergoing changes from causing plexes in a
volume to become inconsistent.
Normally, writecopy is not needed because the system pager
ensures that a consistent version of each page is written to the
volume prior to a clean system shutdown. For most volumes, recovery
after an unclean system shutdown (that is, after a panic, unintended
reset, or power failure) recovers all blocks in a volume to have
consistent data between each plex.
However, volumes which use the dirty region logging or RAID-5 logging
features recover only those regions which were being written at the
time of an unclean shutdown.
If some regions were written inconsistently at some point
prior to a shutdown, then recovery may not ensure consistency of these
regions. (The dirty region logging feature is enabled when
log_type is set to DRL and at least one plex has a
log subdisk and the volume has at least two read-write mode plexes.)
If specify_writecopy is set to off, VxVM automatically
sets the value of writecopy to on if block-change logging
is enabled on the volume, and off otherwise.
If specify_writecopy is set to on,
the setting of the writecopy flag is overridden
and writecopy stabilization is enforced.
Note: To reduce the overhead of write operations, it is desirable to
turn off writecopy altogether for block-change logging volumes.
The behavior of specify_writecopy may change in a
future release so that when specify_writecopy is set to on,
the user is responsible for setting writecopy on or off,
and when specify_writecopy is set to off, VxVM is responsible
for setting writecopy on or off.
See the vxedit(1M) manual page for more information.
The following fields are defined for volume set records:
-
appvols
-
A comma-separated string that lists the component volumes of the volume
set.
-
ch
-
The content-handler string for the volume set.
-
comment
-
A comment string that describes the volume set.
-
context
-
A context string that defines the volume set for an application.
-
kstate
-
The kernel state of the volume set. This field is read-only.
-
state
-
The state of the volume set. This field is read-only.
-
vol_num
-
The number of volumes in the volume set. This field is read-only.
The following fields are defined for plex records:
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
compact
-
A boolean field. This is on if the plex is compact. A compact
plex has no holes; that is, has no regions within the length of the plex
that aren't backed by a subdisk. This is a read-only field and
attempts to set it are ignored.
-
complete
-
A boolean field. This is set to on to indicate to the
GEN_DET, GEN_DET2, and GEN_DET_SPARSE exception
policies
that the plex should be considered to
be complete, relative to any volume to which the plex is associated.
-
config_len
-
A length number field. This is the offset of the first block in the
plex that doesn't map to a subdisk. If the plex is compact,
contig_len will equal len; otherwise, contig_len
will identify where the first hole in the plex is.
This is a read-only field and attempts to set it are ignored.
-
iomode
-
A pseudo enumeration field. This field does not represent an explicit
enumeration field in the plex record. Rather it represents the
possible values in the plex pl_tflag structure element (which is
not accessible through the vxmake description format) that form
the I/O mode of the plex. Possible values are NONE, RO,
WO, and RW, which mean no I/O is possible, read-only,
write-only and read-write, respectively. In general, only RW
and WO are useful.
-
kdetach (alias: iofail)
-
A boolean field. This is set to on if the plex becomes detached
as a result of an I/O failure. If this is set, the plex contents may
be out-of-date and will require recovery from another plex in the
volume.
-
kstate
-
An enumeration field. This is the kernel-enabled state of the plex.
Possible values are ENABLED, DISABLED, and DETACHED.
-
lasterr
-
A number field. This is the sequence number of the last error on the
volume. It is a read-only field and attempts to set it are ignored.
-
layout
-
An enumeration field. This specifies how blocks in the plex address
space map onto blocks. Possible values are CONCAT and
STRIPE. A value of CONCAT indicates that subdisks are
simply concatenated together to form the blocks in the plex address
space. A value of STRIPE indicates that columns made up of subdisks
are mapped onto the plex address space.
-
len
-
A length number field. This is the length of the plex. The length of
a plex is computed from the end of the associated subdisk that has the
largest plex offset.
This is a read-only field and attempts to set it are ignored.
-
log
-
A boolean field. This is set to on to enable use of any log
subdisk associated with the plex. If off, then any associated
log subdisk is ignored.
-
log_sd
-
A name field. This is the name of an associated log subdisk, if such
a subdisk has been associated to the plex with the vxsd aslog
operation. This can be specified as input to vxmake to specify
that the subdisk should be associated to the plex by vxmake.
-
log_sd_rid
-
The record ID of the log subdisk. Attempts to set this field in
vxmake are ignored.
-
ncolumn
-
A number of stripe columns. If the value of layout is STRIPE,
then this specifies the number of columns in the striped plex. This number
must be nonnegative.
-
nodarec (alias: nodevice)
-
A boolean field. This is set to on if the disk for one of the
subdisks in the plex has the nodarec flag set. This implies
that the physical disk backing a subdisk either could not be found
after a reboot, or failed entirely during operation.
This is a read-only field and attempts to set it are ignored.
-
noerror
-
A boolean field. This field is on if I/O errors on the plex
should not result in actions based on the volume exception
policies. This maps onto setting the PL_PFLAG_NOERROR flag in
the plex pl_pflag structure element.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters. These are the
permanent utility fields. The first field is reserved for use by
usage-type utilities. The second field is reserved for use by
utilities, such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that
need to store their own state into records. The third field is
reserved for use by local installations.
-
removed
-
A boolean field. This is set to on if the disk for one of the
subdisks in the plex has the removed flag set. This implies
that the physical disk backing a subdisk was removed by the
vxdg rmdisk operation.
This is a read-only field and attempts to set it are ignored.
-
rid
-
The record ID for the plex record.
-
sd_num (alias: nsd)
-
A simple number field. This is the number of subdisks associated with
the plex. It is a read-only field and attempts to set it are ignored.
-
sd
-
A list of subdisks to associate with the plex. Each subdisk is
separated by a comma. A specific plex offset can be given for a
subdisk by following the subdisk name with a colon and a number. If
no plex offset is specified, then the subdisk is associated at the end
of the previous subdisk in the list. The default plex offset for the
first subdisk in the list is zero.
-
snap_rid
-
The record ID (rid) of the original volume. This field is set
during a snapshot operation.
-
sparse
-
A boolean field that indicates whether a plex is sparse (possibly
as a result of dissociating one or more subdisks).
-
st_width
-
A length number field. If the value of layout is STRIPE,
then this specifies the length of each stripe. This length must be
non-negative and must be an even multiple of a block (512 bytes on most
machines).
-
stale (alias: recover)
-
A boolean field. This is set to on if a disk is removed that
containing one of the subdisks in the plex, or if the disk for one of
the subdisks fails while the
plex is in use. If this is set, the plex contents may be out-of-date
and will require recovery from another plex in the volume.
-
state
-
A comment field of up to fourteen characters. This is a
usage-type-dependent volume state. Typically, usage types will ignore
any attempts to set this field in vxmake.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters. These are the
temporary utility fields. The first field is reserved for usage-type
utilities. The second field is reserved for utilities, such as
Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store their own
state into records. The third field is reserved for local
installations.
-
update_tid
-
The configuration update sequence number for the last transaction to
update this record. This is a read-only field and attempts to set it
are ignored.
-
v_name (alias: volume)
-
A name field. This is the name of the volume to which the plex is
associated. This is a read-only field when used with the
vxmake utility and attempts to set it are ignored.
-
vol_rid
-
The record ID of the associated volume. If the plex isn't associated,
the value of this field is 0.0.
-
volatile
-
A boolean field. This is on if any subdisk associated with the
plex has its volatile flag set to on; otherwise, this is
off. This is a read-only field and attempts to set it are
ignored.
The following fields are defined for subdisk records:
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
config_id, config_epoch
-
Simple unsigned number fields. These are the lower and upper 32 bits,
respectively, of the update_tid field. These fields are
provided for backward compatibility with earlier releases of VxVM.
This field is not printed by the -m flag to
vxprint.
These are read-only fields and attempts to set them will be ignored.
-
da_name (alias: device or accessname)
-
The name of the disk access record used to access the physical disk that backs
the subdisk. If the disk media record is in the nodarec or
removed state, then this will be empty. This can be used as an
alternative to setting dm_name
as a means of specifying the disk
to vxmake.
-
dev
-
This is the device number of the public region for the disk that the
subdisk resides on. If the disk is removed or failed, the value for
this field is VOLNODEV. This is a read-only field and attempts to
set it are ignored.
-
dev_offset
-
A length number. This is the offset of the subdisk from the beginning
of the device containing the private region of the disk that backs it.
This is not defined (prints as an empty string) if the disk media
record for the subdisk is in the removed or nodarec state.
This is a read-only field and attempts to set it are ignored.
-
dm_name (alias: disk or medianame)
-
The name of the disk media record that the subdisk is defined on.
This field is the primary means of defining the disk as input to
vxmake
-
dm_offset (alias: offset)
-
A length number. This is the offset of the subdisk from the beginning
of the private region of the disk that backs it. This is a read-only
field and attempts to set it are ignored.
-
dm_rid
-
The record ID of the disk media record that the subdisk is defined on.
This can be used as an alternative to setting dm_name as a means
of specifying the disk to vxmake.
-
is_log (alias: log)
-
A boolean field. This is on if the subdisk is associated with a
subdisk as a log subdisk.
-
len
-
A length number. This is the subdisk length. The length must
be a nonnegative number, and must be a multiple of a standard disk
block (512 bytes on most machines).
-
open
-
A boolean field. This is on if the associated volume is open or mounted.
This is a read-only field and attempts to set it are ignored.
-
path
-
A comment-type string field of up to 32 characters. This is the path
to the block device for the public region of the disk that the subdisk
resides on. If the disk is currently failed or removed, this field
is empty. This field can be specified as an alternative to setting
dm_name when creating a subdisk record, in which case it will be
used to determine the disk.
-
pl_offset
-
A length number. This is the offset of the subdisk in address space
of the plex address. If the subdisk is not associated, the field is
not defined (prints as an empty string). This is a read-only field
and attempts to set it are ignored.
-
pl_name (alias: plex)
-
A name field. This is the name of the plex to which the subdisk is
associated. This is a read-only field and attempts to set it are
ignored.
-
plex_rid
-
The record ID of the plex to which the subdisk is associated. If the
subdisk is not associated, this is 0.0. This is a read-only
field and attempts to set it are ignored.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters. These are the
permanent utility fields. The first field is reserved for usage-type
utilities. The second field is reserved for utilities, such as
Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store their own
state into records. The third field is reserved for local
installations.
-
rid
-
The record ID for the subdisk record.
-
subcache
-
A boolean value indicating whether a subdisk is a component of a
cache used for space-optimized instant snapshot operations.
This flag is read-only.
-
tent_move_src
-
A boolean value indicating a source subdisk in a tentative move operation.
This flag is read-only.
-
tent_move_tgt
-
A boolean value indicating a target subdisk in a tentative move operation.
This flag is read-only.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters. These are the
temporary utility fields. The first field is reserved for usage-type
utilities. The second field is reserved for utilities, such as
Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store their own
state into records. The third field is reserved for local
installations.
-
update_tid
-
The configuration update sequence number for the last transaction to
update this record. This is a read-only field and attempts to set it
are ignored.
-
volatile
-
A boolean field. This is set to on if the disk that backs the
subdisk is defined to be volatile. See vxdisk(1M) for
information on how to create a volatile disk with the
nopriv disk type. Typically, such disks represent RAM disks
defined in memory that is reset by a reboot or a power failure.
The following fields are defined for DCO records.
These fields may be used with the vxprint but not with the vxmake
command.
-
drl
-
A boolean value indicating whether dirty region logging (DRL) is enabled
for a version 20 DCO.
(The DRL maps are stored in the DCO volume.)
Note: DRL support within a DCO volume
requires that the DCO version is 20 or greater.
Version 0 DCOs do not support this feature.
This flag is read-only.
-
regionsz
-
Version 0 DCOs do not support this feature.
The DCO region size in blocks.
This field is read-only and does not apply to version 0 DCOs.
-
sequentialdrl
-
A boolean value indicating whether sequential DRL is enabled
for a version 20 DCO.
Note: DRL support within a DCO volume
requires that the DCO version is 20 or greater.
Version 0 DCOs do not support this feature.
This field is read-only and does not apply to version 0 DCOs.
-
version
-
The version number of the DCO.
Version 0 DCOs support Persistent FastResync.
Version 20 DCOs support full-sized and space-optimized
instant snapshot operations,
DRL and sequential DRL logs within the DCO volume,
and Persistent FastResync.
This field is read-only.
The following fields are defined for snap object records that
are used to implement instant snapshot operations
(see vxsnap(1M)).
These fields may be used with the vxprint command,
but not with the vxmake command.
-
child
-
A boolean value that indicates whether a snap object
is associated with a child snapshot volume.
This flag is read-only.
-
copymap
-
A boolean value that indicates whether a snap object
is in use by a copymap that is created during a reattach operation.
This flag is read-only.
-
guid
-
The global unique ID of the snap object.
This field is read-only.
-
parent
-
A boolean value that indicates whether a snap object
is associated with a parent volume.
This flag is read-only.
-
restore
-
A boolean value that indicates whether a snap object
is the source volume for a restore operation.
This flag is read-only.
-
restore_tgt
-
A boolean value that indicates whether a snap object
is the target volume for a restore operation.
This flag is read-only.
-
snap_delete
-
A boolean value that indicates whether
this snap object is to be deleted.
This flag is read-only.
-
snap_resync
-
A boolean value that indicates whether the snapshot that
is being tracked by this snap object must be resynchronized
when it is restarted.
This flag is read-only.
-
temp_restore
-
A boolean value that indicates whether a snap object
is a temporary state created during a restore operation.
This flag is read-only.
The following fields are defined for cache object records.
-
autogrow
-
A boolean value that indicates whether the cache volume can be grown
automatically as required.
-
autogrowby
-
A length value that specifies the amount by which the cache volume
is grown automatically if its usage reaches the value of highwatermark
and the new size would not exceed maxautogrow. The default value is
calculated as 10% of the cache size.
-
highwatermark
-
An integer value that specifies the percentage of the cache volume that
must be in use before the cache volume can be grown automatically.
-
maxautogrow
-
A length value that specifies the maximum size of the cache volume.
-
regionsize
-
A length number that determines the size of the volume
regions that are tracked and recorded in the cache. The value
must be a power of 2, and be greater than or equal to 16k (16KB).
The default regionsize is 64k (64KB).
Note: The region size cannot be increased once the cache object has been
created.
The following fields are defined for disk media records.
Note that disk media records cannot be created using vxmake.
-
allocator_nouse
-
A boolean. This is set to on if a disk is not to be used with
the Intelligent Storage Provisioning (ISP) feature.
-
allocator_reserved
-
A boolean. This is set to on if a disk is only to be used with
the Intelligent Storage Provisioning (ISP) feature.
-
atomic_iosize (alias: iosize)
-
The sector size of the device that backs the disk media record. This
field is undefined (prints as an empty string) if the disk media
record is in the removed or nodarec state.
-
autoconfig
-
A boolean. This is on if the disk access record that underlies
the disk media record was auto-configured during system startup.
This is off if the disk media record is in the nodarec or
removed state, or if the disk access record was created
explicitly with vxdisk define or vxdisk init.
See vxdisk(1M) for more information.
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
component
-
A boolean. This is on if the public and private regions are
on separate partition devices.
This if off if the disk media record
is in the removed or nodarec state.
-
da_name (alias: device or accessname)
-
The name of the disk access record that can be used to access the disk
that backs the disk media record. This is empty if the disk has the
removed or nodarec flags set.
-
da_type (alias: type)
-
The disk type for the disk access record that backs the disk media
record. See vxdisk(1M) for a description of disk types. This
field is empty if the disk media record is in the removed or
nodarec state.
-
device_tag
-
A name identifying the device that the disk access record references.
If two or more disk access records identify the same actual device
(for example, if they reference different sets of partitions of the
same physical disk), the device_tag will be the same for both
disk access records.
The device_tag field is inherited by the
disk media record from the disk access record.
This field is empty if the disk media record is in the removed
or nodarec state.
-
diskid
-
The disk ID for the physical disk that backs the disk media record.
This is a 64-byte string that matches the disk ID stored in the disk
header of the disk on which this disk media record is defined. This
field is empty if the disk is in the removed state.
diskid will be set to a new value if the disk media record is
reassociated using vxdg -k adddisk.
-
last_da_name (alias: last_device)
-
The name of the last disk access record used by the disk media record.
This is set whenever the disk access record changes. The disk access
record used for a disk media record can change if disks are moved
during a reboot, or if a disk is replaced. The last_da_name
field is preserved if a disk fails or is removed.
-
nodarec (alias: nodevice)
-
A boolean. This is on if the physical disk underlying the disk
media record could not be found during system startup, or if it failed
completely during system operation.
-
priv_bpath
-
The path to the block device containing the private region for the
disk. The private region is the region of the disk used to allocate
configuration information, disk headers, and other on-disk structures
that are used by VxVM.
None of the private region can
be allocated to volumes or used for uses outside of VxVM.
This field is empty if the disk media record is in the removed
or nodarec state, or if the disk does not have a private region
(for example, on nopriv-type disks).
-
priv_cpath
-
The path to the character (raw) device containing the private region
for the disk. This field is empty if the disk media record is in the
removed or nodarec state, or if the disk does not have a
private region (for example, on nopriv-type disks).
-
priv_offset, priv_len
-
Length number fields.
These define the offset and length of the
private region of the disk within the
device containing the
private region.
These fields are not defined (print as empty strings)
if the disk media record is in the removed or nodarec
state, or if the disk does not have a private region (for example,
on nopriv-type disks).
-
private
-
A boolean. This is on if the disk underlying the disk media
record has a private region (for example, if the disk is not a
nopriv-type disk). This if off if the disk media record
is in the removed or nodarec state.
-
.PD 0
-
pub_bdev (alias: pub_dev, bdev, or dev)
-
.PD 0
-
priv_bdev (alias: priv_dev)
The block device numbers of
the device containing the public and
private regions of the disk, respectively.
These fields are both
VOLNODEV if the disk media record is in the removed or
nodarec state. The priv_bdev field is VOLNODEV if the
disk does not have a private region (for example, on nopriv-type
disks).
-
pub_bpath (alias: bpath or path)
-
The path to the block device containing the
public region for the disk.
The public region is the region of
the disk from which subdisks are allocated.
The public region and the private region of a disk are
often defined on different partitions,
so different device nodes must
be used to access them.
This field is empty if the disk media record
is in the removed or nodarec state.
-
pub_cpath (alias: cpath)
-
The path to the character (raw) device containing the public region
for the disk. This field is empty if the disk media record is in the
removed or nodarec state.
-
pub_offset, pub_len (alias: len)
-
Length number fields.
These define the offset and length of the
public region of the disk within the
device containing the public region.
These fields are not defined (print as empty strings)
if the disk media record is in the removed or nodarec
state.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters.
These are the permanent utility fields.
The first field is reserved for internal Veritas Volume Manager purposes.
The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records. The third field is reserved for local
installations.
-
removed
-
A boolean. This is set to on if the disk is detached from its
backing store using the vxdg -k rmdisk operation. Detaching
the disk also clears the diskid field.
-
reserved
-
A boolean. This can be set or cleared (see vxedit(1M)) to
reserve or unreserve the disk. Reserving a disk prevents
vxassist from allocating subdisks from the disk, unless the
disk is specified explicitly on the vxassist command line.
-
rid
-
The record ID for the disk media record.
-
sd_num (alias: nsd)
-
A simple number field. This is the number of subdisks that are
defined on the disk media record.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters.
These are the temporary utility fields.
The first field is reserved for internal
Veritas Volume Manager purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records. The third field is reserved for local
installations.
-
update_tid
-
The configuration update sequence number for the last transaction to
update this record.
-
volatile
-
A boolean. This is on if the disk access record underlying the
disk media record was created with the volatile flag set. See
voldisk(1M) for information on how to create a nopriv-type
disk with the volatile flag set.
The following fields are defined for disk group records.
Note that disk group records cannot be created using vxmake.
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
dgid
-
The disk group ID of the disk group. This is a 64-byte string that is
assigned to the disk group when it is created. The form of the string
is chosen to substantially eliminate the chance that any two disk
groups ever created will have the same disk group ID.
-
import_id
-
A sequence number associated with the current import of the disk group.
Each time a disk group is imported, it is assigned a sequence
number from an increasing sequence.
This number can be saved and then used to find out whether a
disk group has been deported and then re-imported again.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters.
These are the permanent utility fields.
The first field is reserved for internal
Veritas Volume Manager purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records.
The third field is reserved for local installations.
-
real_name
-
This is the name of the disk group as it is defined within the disk
group.
VxVM supports an aliasing
feature, where a disk group is imported using a disk group name that
differs from the name as it appears in the disk group configuration.
Normally, these are the same.
real_name will always match the import name of the disk group.
-
rid
-
The record ID for the disk group record.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters. These are the
temporary utility fields. The first field is reserved for internal
Veritas Volume Manager purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records.
The third field is reserved for local installations.
-
update_tid
-
The configuration update sequence number for the last transaction to
update this record.
The following fields are defined for Replicated
Volume Group (RVG) records that are
used with Veritas Volume Replicator (VVR).
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
datavol
-
This is a comma-separated list of data volumes
that are associated with the RVG.
-
group
-
This is either a group name or a decimal group ID. The value
specifies the user that owns the volume block and character devices.
-
mode
-
This is a symbolic or numeric file permission mode. This can be any
string that is acceptable to chmod(1) for setting the mode of a
file.
-
primary
-
A boolean field.
If set to true, this is considered to be the primary RVG, and
writes to this RVG are replicated to any attached RLINK.
If set to false (default), this is a secondary RVG
which receives writes from the primary RVG.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters.
These are the permanent utility fields.
The first field is reserved for internal
VVR purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records.
The third field is reserved for local installations.
-
rlink
-
This is a comma-separated list of RLINKs that are associated with the RVG.
-
srl
-
This is the name of the Storage Replicator Log (SRL) volume for the RVG.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters. These are the
temporary utility fields. The first field is reserved for internal
VVR purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records.
The third field is reserved for local installations.
-
user
-
This is either a user name or a decimal user ID. The value specifies
the user that owns the volume block and character devices.
The following fields are defined for RLINK records that are
used with Veritas Volume Replicator (VVR).
-
bandwidth_limit
-
The maximum network bandwidth that can
be used to replicate data over an RLINK.
This field is enabled by setting it to a value in units of bits per second,
and disabled by setting to none (the default value).
The minimum allowed value is 56kbps (56 kilobits per second).
Refer to the vxedit(1M) manual page for more information.
-
comment
-
A comment-type field of up to 40 characters. This is reserved for use
by local installations.
-
latency_high_mark
-
Specifies the maximum number of outstanding requests
when latency protection is enabled.
-
latency_low_mark
-
If throttling has been enabled, specifies the level to which the number of
outstanding requests must drop before throttling is disabled.
-
latencyprot
-
Indicates whether latency protection is enabled for the RLINK.
The attribute may have one of the values: fail, off,
or override.
Refer to the vxedit(1M) manual page for more information.
-
local_host
-
The name of the local host.
This only needs to be set if a private network is used.
-
packet_size
-
Indicates the maximum number of bytes in a UDP packet
that can be sent from the primary to secondary.
It defaults to some reasonable non-zero value,
but can be tuned to the local environment for improved performance.
This field can only be set when the RLINK is using UDP as its
transport protocol.
-
protocol
-
This is the transport protocol that the RLINK uses for replication; either
UDP or TCP.
If no value is specified, the RLINK uses the default protocol, UDP.
-
putil0, putil1, putil2
-
Comment-type fields of up to fourteen characters.
These are the permanent utility fields.
The first field is reserved for internal
VVR purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records.
The third field is reserved for local installations.
-
remote_dg
-
The name of the remote disk group.
-
remote_host
-
The name or IP address of the remote host.
-
remote_rlink
-
The name of the remote RLINK.
-
srlprot
-
Indicates whether log protection is enabled for the RLINK.
Log protection prevents an RLINK from overflowing the SRL,
which would cause it to become stale.
This field may have one of the values: autodcm,
dcm, fail, off, or override.
Refer to the vxedit(1M) manual page for more information.
-
synchronous
-
Indicates whether replication should operate in synchronous or asynchronous
mode.
This field may have one of following values:
off, override or fail.
Refer to the vxedit(1M) manual page for more information.
-
timeout
-
The connection timeout value is the number of milliseconds to wait
before connections to remote nodes should time out.
It defaults to some reasonable non-zero value,
but can be tuned to the local environment for
improved performance.
The minimum allowed timeout is 1 millisecond.
-
tutil0, tutil1, tutil2
-
Comment-type fields of up to fourteen characters. These are the
temporary utility fields. The first field is reserved for internal
VVR purposes. The second field is reserved for utilities,
such as Veritas Enterprise Administrator (VEA),
that use the usage-type utilities and that need to store
their own state into records.
The third field is reserved for local installations.
awk(1),
chmod(1),
group(4),
passwd(4),
sh(1),
vradmin(1M),
vxassist(1M),
vxconfigbackup(1M),
vxconfigrestore(1M),
vxdg(1M),
vxdisk(1M),
vxedit(1M),
vxintro(1M),
vxprint(1M),
vxsnap(1M),
Last updated: 17 Jul 2008
Copyright ©2009 Symantec Corporation
All rights reserved.