volume-config man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

volume-config(4)		 File Formats		      volume-config(4)

NAME
       volume-config - Solaris Volume Manager volume configuration information
       for top down volume creation with metassist

SYNOPSIS
       /usr/share/lib/xml/dtd/volume-config.dtd

DESCRIPTION
       A volume configuration file, XML-based and compliant with  the  volume-
       config.dtd  Document Type Definition, describes the detailed configura‐
       tion of the volume or volumes to be created, including the names, sizes
       and configurations of all the components used in the volume or volumes.
       This configuration file	can  be	 automatically	generated  by  running
       metassist with the -d option, or can be manually created.

       The  volume  configuration  file	 can then be used to either generate a
       command file or to directly create volumes  by  running	metassist  and
       specifying the volume configuration file as input to the command.

       As  a  system administrator, you would want to change, manually create,
       or edit the volume configuration file only if there are	small  details
       of  the	configuration  that you want to change. For example, you might
       want to change names for	 volumes  or  hot  spare  pools,  mirror  read
       option, or stripe interlace values.

       It  would  be possible to also select different devices or change slice
       sizes or make similar changes, but that is generally  not  recommended.
       Substantial changes to the volume-config file could result in a poor or
       non-functional configuration.

       With a volume-config file, you can run metassist and provide  the  file
       as  input  to the command to generate either a command file or to actu‐
       ally set up the configuration.

   Defining Volume Configuration
       The top level element <volume-config> surrounds the  volume  configura‐
       tion  data.  This  element  has	no  attributes. A volume configuration
       requires exactly one <diskset> element, which must be the first element
       of  the	volume configuration. Additionally, the volume-config can have
       zero or more of the following elements:	<disk>, <slice>, <hsp>,	 <con‐
       cat>,  <stripe>,	 <mirror>   as required to define the configuration of
       the volume to be created.

   Defining Disk Set
       Within the <volume-config> element, a <diskset> element must exist. The
       <diskset>  element,  with the name attribute, specifies the name of the
       diskset in which to create the volume  or  volumes.  This  element  and
       attribute  are  required.  If this named disk set does not exist, it is
       created upon implementation of this volume configuration.

   Defining Slice
       The volume configuration format provides for  a	<slice>	 element  that
       defines	the  name  of  a  slice to use as a component of a volume. The
       <slice> element requires a name attribute which specifies  a  full  ctd
       name.  If the <slice> is newly created as part of the volume configura‐
       tion, the startsector and sizeinblocks attributes must be specified. If
       the  slice was previously existing, these attributes need not be speci‐
       fied.

   Defining Hot Spare Pool
       The volume configuration format	provides  for  a  <hsp>	 element  that
       defines the name of a hot spare pool to use as a component of a config‐
       uration. The <hsp> element requires a name attribute which specifies  a
       hot spare pool name.

       Slices  defined	by <slice> elements contained in the <hsp> element are
       included in the hot spare pool when metassist creates it."

   Defining Stripe
       The <stripe> element defines stripes (interlaced RAID 0 volumes) to  be
       used  in a volume. The <stripe> element takes a required name attribute
       to specify a name conforming to Solaris Volume Manager naming  require‐
       ments.  If  the	name specifies an existing stripe, no <slice> elements
       are required. If the name specifies a new stripe, the <slice>  elements
       to  construct  the slice must be specified within the <stripe> element.
       The <stripe> elements takes an optional interlace  attribute  as	 value
       and units (for example, 16KB, 5BLOCKS, 20MB). If this value isn't spec‐
       ified, the Solaris Volume Manager default value is used.

   Defining Concat
       The <concat> element defines concats (non-interlaced RAID 0 volumes) to
       be  used	 in  a	configuration.	It  is the same as a <stripe> element,
       except that the interlace attribute is not valid.

   Defining Mirror
       The <mirror> element defines mirrors (RAID 1 volumes) to be used	 in  a
       volume  configuration.  It  can	contain	 combinations  of <concat> and
       <stripe> elements (to explicitly determine which volumes	 are  used  as
       submirrors).

       The  <mirror> element takes a required name attribute to specify a name
       conforming to Solaris Volume Manager naming requirements.

       The <mirror> element takes an optional read  attribute  to  define  the
       mirror  read options (ROUNDROBIN, GEOMETRIC, or FIRST) for the mirrors.
       If this attribute is not specified, the Solaris Volume Manager  default
       value is used.

       The  <mirror>  element  takes an optional write attribute to define the
       mirror write options (PARALLEL, SERIAL, or FIRST) for the  mirrors.  If
       this  attribute	is  not	 specified, the Solaris Volume Manager default
       value  is  used.	  The  <mirror>	 element  takes	 an  optional  passnum
       attribute  (0-9) to define the mirror passnum that defines the order in
       which mirrors are resynced at boot, if required.	 Smaller  numbers  are
       resynced	 first. If this attribute is not specified, the Solaris Volume
       Manager default value is used.

EXAMPLES
       Example 1: Specifying a Volume Configuration

       The following is an example volume configuration:

       <!-- Example configuration -->
       <volume-config>
	 <!-- Specify the existing disk set to use -->
	 <diskset name="redundant"/>

       <!-- Create slices -->
       <slice name="/dev/dsk/c0t0d1s7" startsector="1444464" \
	    sizeinblocks="205632BLOCKS"/>
       <slice name="/dev/dsk/c0t0d1s6" startsector="1239840" \
	    sizeinblocks="102816KB"/>

       <!-- Create a  concat -->
       <concat name="d12">
       <slice name="/dev/dsk/c0t0d0s7"/>
       <slice name="/dev/dsk/c0t0d0s6"/>
       <slice name="/dev/dsk/c0t0d1s7"/>
       <slice name="/dev/dsk/c0t0d1s6"/>

       <!-- Create (and use) a HSP -->
       hsp name="hsp0">
       <slice name="/dev/dsk/c0t0d4s0"/>
       <slice name="/dev/dsk/c0t0d4s1"/>
       <slice name="/dev/dsk/c0t0d4s3"/>
       <slice name="/dev/dsk/c0t0d4s4"/>
       </hsp>

       </concat>

       <!-- Create a stripe -->
       <stripe name="d15" interlace="32KB">
       <slice name="/dev/dsk/c0t0d0s7"/>
       <slice name="/dev/dsk/c0t0d1s7"/>

       <!-- Use a previously-defined HSP -->
       <hsp name="hsp0"/>
       </stripe>

       <!-- Create a  mirror -->
       <mirror name="d10">

       <!-- Submirror 1: An existing stripe -->
       <stripe name="d11"/>

       <!-- Submirror 2: The concat defined above -->
       <concat name="d12"/>

       <!-- Submirror 3: A stripe defined here -->
       <stripe name="d13">
       <slice name="/dev/dsk/c0t0d2s6"/>
       <slice name="/dev/dsk/c0t0d2s7"/>
       <slice name="/dev/dsk/c0t0d3s6"/>
       slice name="/dev/dsk/c0t0d3s7"/>
       </stripe>

       </mirror>

       </volume-config>

FILES
       /usr/share/lib/xml/dtd/volume-config.dtd

SEE ALSO
       metassist(1M), metaclear(1M), metadb(1M),  metadetach(1M),  metahs(1M),
       metainit(1M),  metaoffline(1M),	metaonline(1M), metaparam(1M), metare‐
       cover(1M), metareplace(1M),  metaroot(1M),  metaset(1M),	 metasync(1M),
       metattach(1M), mount_ufs(1M), mddb.cf(4)

       Solaris Volume Manager Administration Guide

SunOS 5.10			  8 Aug 2003		      volume-config(4)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net