fs_config_data(4)fs_config_data(4)NAMEfs_config_data - Describes the configuration data for an AdvFS domain.
DESCRIPTION
The output of fs_save_config contains the AdvFS domain configuration
that is used as input to the fs_restore_config function. The configu‐
ration data file entities consist of domains, volumes, filesets, mount
points, disk groups and disk group disks, all specified in XML markup.
The fs_restore_config function requires that you provide a configura‐
tion remapping data file as input to the function. The remapping data
specifies how entities on the original system are remapped to the new
system.
For use of these functions, see their respective manpages.
NOTES
Leading and trailing white spaces in the value of an element are
ignored.
A character data element must have a non-blank value. For example,
<domain_name> </domain_name> is not acceptable. This is true for both
mandatory elements and optional elements. If no value is to be speci‐
fied with optional elements, then there is no need to include their
tags.
Current implementation supports processing one AdvFS domain at a time.
EXAMPLES
The following are examples of configuration and remapping definitions
that are the same for any type of domain configuration. The first line
is XML specific information, and must always be included. The follow‐
ing shows saved configuration data from a domain without LSM volumes.
This data can be used as input to a remap. <?xml version="1.0" encod‐
ing="UTF-8" standalone="yes"?>
<!DOCTYPE stor_config [
<!ELEMENT stor_config (hostinfo, advfs_domains,
lsm_config?)> <!-- stor_config is the root element -->
<!ELEMENT hostinfo (hostname, hostid)> <!ELEMENT hostname
(#PCDATA)> <!ELEMENT hostid (#PCDATA)>
<!ELEMENT advfs_domains (advfs_domain*)> <!-- 0 to n domains
may be specified. -->
<!ELEMENT advfs_domain (domain_id, domain_name,
domain_name_new?, vfast_attr?, advfs_volumes,
advfs_filesets)> <!-- domain_name_new is optional --> <!--
vfast_attr is optional -->
<!ELEMENT domain_id (#PCDATA)> <!ELEMENT domain_name
(#PCDATA)> <!ELEMENT domain_name_new (#PCDATA)>
<!ELEMENT vfast_attr (defragment, balance,
top_io_balance, domain_status)>
<!ELEMENT defragment (#PCDATA)> <!ELEMENT balance (#PCDATA)>
<!ELEMENT top_io_balance (#PCDATA)> <!ELEMENT domain_status
(#PCDATA)>
<!ELEMENT advfs_volumes (advfs_volume+)> <!-- At least one
volume is required in a domain -->
<!ELEMENT advfs_volume (vol_name, vol_name_new?)> <!--
vol_name_new is optional. -->
<!ELEMENT vol_name (#PCDATA)> <!ELEMENT vol_name_new
(#PCDATA)>
<!ELEMENT advfs_filesets (advfs_fileset*)> <!-- 0 to n file‐
sets in a domain. -->
<!ELEMENT advfs_fileset (fset_name, fset_name_new?,
is_mounted, mnt_point?, mnt_point_new?,
fstab_attr?, quotas)> <!-- fset_name_new, mnt_point,
fstab_attr are optional. -->
<!ELEMENT fset_name (#PCDATA)> <!ELEMENT fset_name_new
(#PCDATA)> <!ELEMENT is_mounted (#PCDATA)> <!ELEMENT
mnt_point (#PCDATA)> <!ELEMENT mnt_point_new (#PCDATA)>
<!ELEMENT fstab_attr (mnt_options, backup, fsck)> <!ELEMENT
mnt_options (#PCDATA)> <!ELEMENT backup (#PCDATA)> <!ELEMENT
fsck (#PCDATA)>
<!ELEMENT quotas (blk_hlimit, blk_slimit,
file_hlimit, file_slimit)> <!ELEMENT
blk_hlimit (#PCDATA)> <!ELEMENT blk_slimit (#PCDATA)> <!ELE‐
MENT file_hlimit (#PCDATA)> <!ELEMENT file_slimit (#PCDATA)>
<!ELEMENT lsm_config (volsave_header, volsave_volboot,
volsave_voldisk, lsm_diskgroups)> <!ELE‐
MENT volsave_header (#PCDATA)> <!ELEMENT volsave_volboot
(#PCDATA)> <!ELEMENT volsave_voldisk (#PCDATA)>
<!ELEMENT lsm_diskgroups (lsm_diskgroup+)>
<!-- At least one diskgroup is required. -->
<!-- If no diskgroup is involved, -->
<!-- leave out completely lsm_config. -->
<!ELEMENT lsm_diskgroup (volsave_allvol, dg_name,
dg_name_new?, dg_disks)>
<!-- dg_name_new is optional. -->
<!ELEMENT volsave_allvol (#PCDATA)> <!ELEMENT dg_name
(#PCDATA)> <!ELEMENT dg_name_new (#PCDATA)>
<!ELEMENT dg_disks (dg_disk+)>
<!-- At least one disk is required in a disk group. -->
<!ELEMENT dg_disk (dg_disk_name, dg_disk_name_new?)>
<!-- dg_disk_name_new is optional. -->
<!ELEMENT dg_disk_name (#PCDATA)> <!ELEMENT dg_disk_name_new
(#PCDATA)> ]>
<!-- The actual configuration data begins here. -->
<stor_config> <hostinfo> <hostname>any‐
host.zso.cpqcorp.net</hostname> <hostid>274149518</hostid>
</hostinfo> <advfs_domains> <advfs_domain>
<domain_id>991345149.758212</domain_id>
<domain_name>usr</domain_name> <advfs_volumes>
<advfs_volume> <vol_name>/dev/disk/dsk1</vol_name>
</advfs_volume> <advfs_volume>
<vol_name>/dev/disk/dsk2</vol_name> </advfs_volume>
</advfs_volumes> <advfs_filesets> <advfs_file‐
set> <fset_name>users</fset_name>
<is_mounted>1</is_mounted>
<mnt_point>/usr/users</mnt_point> <fstab_attr>
<mnt_options>rw,userquota,groupquota</mnt_options>
<backup>1</backup> <fsck>2</fsck>
</fstab_attr> <quotas>
<blk_hlimit>500000</blk_hlimit>
<blk_slimit>300000</blk_slimit>
<file_hlimit>9000</file_hlimit>
<file_slimit>7000</file_slimit> </quotas>
</advfs_fileset> <advfs_fileset>
<fset_name>var</fset_name> <is_mounted>1</is_mounted>
<mnt_point>/usr/var</mnt_point>
<fstab_attr> <mnt_options>rw</mnt_options>
<backup>1</backup> <fsck>2</fsck>
</fstab_attr> <quotas>
<blk_hlimit>0</blk_hlimit> <blk_slimit>0</blk_slimit>
<file_hlimit>0</file_hlimit>
<file_slimit>0</file_slimit> </quotas>
</advfs_fileset> </advfs_filesets> </advfs_domain>
</advfs_domains> </stor_config> The following is an example
of configuration data that can be used to remap a domain with LSM vol‐
umes. <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!DOCTYPE stor_config_changes [
<!ELEMENT stor_config_changes (hostinfo, advfs_domains,
lsm_config?)> <!-- stor_config_changes
is the root element --> <!-- lsm_config is optional. -->
<!ELEMENT hostinfo (hostname, hostid)> <!ELEMENT hostname
(#PCDATA)> <!ELEMENT hostid (#PCDATA)>
<!ELEMENT advfs_domains (advfs_domain*)> <!-- 0 to n domains
may have remapping data. -->
<!ELEMENT advfs_domain (domain_name, domain_name_new?,
advfs_volumes, advfs_filesets)> <!--
original domain_name needed for identification. --> <!--
domain_name_new is optional. -->
<!ELEMENT domain_name (#PCDATA)> <!ELEMENT domain_name_new
(#PCDATA)>
<!ELEMENT advfs_volumes (advfs_volume*)> <!-- 0 to n volumes
may have remapping data. -->
<!ELEMENT advfs_volume (vol_name, vol_name_new)> <!-- origi‐
nal vol_name needed for identification. -->
<!ELEMENT vol_name (#PCDATA)> <!ELEMENT vol_name_new
(#PCDATA)>
<!ELEMENT advfs_filesets (advfs_fileset*)> <!-- 0 to n file‐
sets may have remapping data.-->
<!ELEMENT advfs_fileset (fset_name, fset_name_new?,
mnt_point_new?)> <!-- original fset_name
needed for identification. -->
<!ELEMENT fset_name (#PCDATA)> <!ELEMENT fset_name_new
(#PCDATA)> <!ELEMENT mnt_point_new (#PCDATA)>
<!ELEMENT lsm_config (lsm_diskgroups)> <!ELEMENT
lsm_diskgroups (lsm_diskgroup+)>
<!-- At least one diskgroup is required. -->
<!-- If no diskgroup is involved, -->
<!-- leave out completely lsm_config. -->
<!ELEMENT lsm_diskgroup (dg_name, dg_name_new?, dg_disks)>
<!-- original dg_name is required for identification. -->
<!-- dg_name_new is optional. -->
<!ELEMENT dg_name (#PCDATA)> <!ELEMENT dg_name_new (#PCDATA)>
<!ELEMENT dg_disks (dg_disk*)> <!-- 0 to n diskgroup disks
may have remapping data. -->
<!ELEMENT dg_disk (dg_disk_name, dg_disk_name_new)> <!-- original
dg_disk_name is required for --> <!-- identification. --> <!-- leave
out dg_disk for dg disk that have no new name. -->
<!ELEMENT dg_disk_name (#PCDATA)> <!ELEMENT dg_disk_name_new
(#PCDATA)> ]>
<!-- The actual remapping data begins here. -->
<stor_config_changes> <hostinfo> <hostname>any‐
host.zso.cpqcorp.net</hostname> <hostid>274149518</hostid>
</hostinfo>
<advfs_domains> <advfs_domain>
<domain_name>usr</domain_name>
<domain_name_new>usr_clone</domain_name_new> <advfs_volumes>
<advfs_volume>
<vol_name>/dev/disk/dsk1</vol_name>
<vol_name_new>/dev/disk/dsk8</vol_name_new>
</advfs_volume> <advfs_volume>
<vol_name>/dev/vol/rootdg/vol1</vol_name>
<vol_name_new>/dev/vol/rootdg_clone/vol_usr</vol_name_new>
</advfs_volume> <advfs_volume>
<vol_name>/dev/vol/rootdg/vol2</vol_name>
<vol_name_new>/dev/vol/rootdg/vol_var</vol_name_new>
</advfs_volume> </advfs_volumes> <advfs_filesets>
<advfs_fileset> <fset_name>users</fset_name>
<fset_name_new>users_clone</fset_name_new>
<mnt_point>/usr/users</mnt_point>
<mnt_point_new>/usr_clone/users_clone</mnt_point_new>
</advfs_fileset> <advfs_fileset>
<fset_name>var</fset_name>
<fset_name_new>var_clone</fset_name_new>
<mnt_point>/usr/var</mnt_point>
<mnt_point_new>/usr_clone/var_clone</mnt_point_new>
</advfs_fileset> </advfs_filesets> </advfs_domain>
</advfs_domains>
<lsm_config> <lsm_diskgroups> <lsm_diskgroup>
<dg_name>rootdg</dg_name>
<dg_name_new>rootdg_clone</dg_name_new> <dg_disks>
<dg_disk> <dg_disk_name>/dev/disk/dsk11</dg_disk_name>
<dg_disk_name_new>/dev/disk/dsk12</dg_disk_name_new>
</dg_disk> <dg_disk>
<dg_disk_name>/dev/disk/dsk15</dg_disk_name>
<dg_disk_name_new>/dev/disk/dsk15</dg_disk_name_new>
</dg_disk> </dg_disks> </lsm_diskgroup>
</lsm_diskgroups> </lsm_config> </stor_config_changes>
SEE ALSO
Functions: fs_get_dom_list(3), fs_config_get_devs(3), fs_save_con‐
fig(3), fs_get_fset_list(3), fs_restore_config(3)fs_config_data(4)