clconfiguration(5CL) Sun Cluster Standards, Environments, and Macros clconfiguration(5CL)
NAME
clconfiguration - describes the cluster DTD for the Sun Cluster configuration XML file
DESCRIPTION
clconfiguration describes the Documentation Type Definition (DTD) for the Sun Cluster configuration eXtensible Markup Language (XML) file.
The Sun Cluster configuration file contains Sun Cluster configuration information tagged with XML elements. The file can contain configura-
tion information for one or more clusters, or even for a portion of a cluster. This Sun Cluster configuration information can be used for
many cluster functions, including cluster configuration backup and cluster duplication.
The DTD defines the elements, their relationships, and their attributes. The element names reflect the content that they provide. For
example, the element <devicegroup> defines cluster device groups. Elements might have attributes that are used to modify or refine their
properties or characteristics. Many of the object-oriented Sun Cluster commands include an export subcommand that exports cluster object
information in the format described in the DTD. Many Sun Cluster commands have the option to add, create, and modify Sun Cluster objects
through the use of cluster configuration XML data.
ELEMENT HIERARCHY
The following list provides the element hierarchy required by the DTD. This list uses the following defaults for children and attribute
properties:
required Unless otherwise specified, one or more is required.
optional Unless otherwise specified, there can be zero or one.
<propertyList>
<property>
<state>
<allNodes>
<-- Cluster -->
<cluster>
<-- Cluster Nodes -->
<nodelist>
<node>
<-- Cluster Transport -->
<clusterTransport>
<transportNodeList>
<transportNode>
<transportAdapter>
<transportType>
<transportSwitchList>
<transportSwitch>
<transportCableList>
<transportCable>
<endpoint>
<-- Cluster Global Devices -->
<deviceList>
<device>
<devicePath>
<-- Cluster Quorum -->
<clusterQuorum>
<quorumNodeList>
<quorumNode>
<quorumDeviceList>
<quorumDevice>
<quorumDevicePathList>
<quorumDevicePath>
<-- Cluster Device Groups -->
<devicegroupList>
<devicegroup>
<memberDeviceList>
<memberDevice>
<devicegroupNodeList>
<devicegroupNode>
<-- Cluster Resource Types -->
<resourcetypeList>
<resourcetype>
<resourcetypeRTRFile>
<resourcetypeNodeList>
<resourcetypeNode>
<methodList>
<method>
<parameterList>
<parameter>
<-- Cluster Resources -->
<resourceList>
<resource>
<resourceNodeList>
<resourceNode)
<monitoredState>
<-- Cluster Resource Groups -->
<resourcegroupList>
<resourcegroup>
<failoverMode>
<managedState>
<resourcegroupNodeList>
<resourcegroupNode>
<resourcegroupResourceList>
<resourcegroupResource>
<-- Cluster NAS Devices -->
<nasdeviceList>
<nasdevice>
<nasdir>
<-- Cluster SNMP -->
<snmpmibList>
<snmpmib>
<snmphostList>
<snmphost>
<snmpuserList>
<snmpuser>
<-- Cluster Telemetrics -->
<telemetrics>
<telemetryObjectType>
<telemetryAttribute>
ELEMENTS
This section lists and describes all of the elements that are defined in the cluster DTD. If an element has required children or
attributes, the required default is one. Optional elements default to zero or one.
<allNodes>
A list of all member nodes in the cluster. The <allNodes> element is a generic element.
The <allNodes> element is used to denote all nodes of the cluster.
Parent: <resourcetypeNodeList>
Children: None
Attributes: None
<cluster>
The root element of a complete cluster configuration XML file. Every cluster configuration XML file must begin with this element as
the root. The DTD can accept only one <cluster> element. Subsequent <cluster> elements in the cluster configuration XML file are
ignored.
Parent: None
Children: Optional:
o <propertyList>
o <nodeList>
o <clusterTransport>
o <deviceList>
o <clusterQuorum>
o <deviceGroupList>
o <resourcetypeList>
o <resourcegroupList>
o <resourceList>
o <nasdeviceList>
o <snmpmibList>
o <snmphostList>
o <snmpuserList>
Attributes: Required:
o name
The name of the cluster.
<clusterQuorum>
The root element of the cluster quorum configuration. All cluster quorum information is defined in the child elements of the <clus-
terQuorum> element.
Parent: <cluster>
Children: Optional:
o <quorumDeviceList>
o <quorumNodeList>
Attributes: None
<clusterTransport>
The root element of the cluster transport configuration. All cluster transport information is displayed in a sublevel of the <cluster-
Transport> element.
Parent: <cluster>.
Children: Optional:
o <transportNodeList>
o <transportSwitchList>
o <transportCableList>
Attributes: None
<device>
A cluster device ID pseudo-driver (DID) device.
Parent: <deviceList>
Children: Optional:
o
<devicePath> (zero or more)
Attributes: Required:
o ctd
The UNIX disk name.
o name
The instance number of the device.
<devicegroup>
The root element of a cluster device-group instance. All aspects of an individual device group are defined in the child elements of the
<devicegroup> element.
Parent: <devicegroupList>
Children: Optional:
o <devicegroupNodeList>
o <memberDeviceList>
o <propertyList>
Attributes: Required:
o name
The name of the device group. The name attribute can be any valid sequence of characters.
o type
The type of the device group. The type attribute can have a value of rawdisk, vxvm, svm, or sds.
<devicegroupList>
A list of all the cluster device groups.
Parent: <cluster>
Children: Optional:
o <devicegroup>
One <devicegroup> element can be used for each device group in the cluster.
Attributes: None
<devicegroupNode>
The node on which a device group is located.
Parent: <devicegroupNodeList>
Children: None
Attributes: Required:
o nodeRef
Specifies the name of a cluster node.
<devicegroupNodeList>
A list of nodes on which a device group is located.
Parent: <devicegroup> (1 or more)
Children: Required:
o <devicegroupNode> (1 or more)
Attributes: None
<deviceList>
A list of cluster DID devices.
Parent: <cluster>
Children: Optional:
o <device>
Attributes: Fixed:
o readonly
The readonly attribute has a fixed value of true.
<deviceNode>
The node and disk device on which a particular <device> exists.
Parent: <device>
Children: None
Attributes: Required:
o nodeRef
The name of the node on which an instance exists.
<endpoint>
One of the transport endpoints.
Parent: <transportCable>
Children: None
Attributes: Required:
o name
The name of the adapter or switch.
o nodeRef
The name of the node that hosts the specified adapter. The nodeRef attribute is required only if
the type attribute is set to adapter.
o type
The type attribute can be set to either adapter or switch.
If the type attribute is set to adapter, you must specify a nodeRef attribute.
If the type attribute is set to switch, you can specify a port attribute. However, the port
attribute is not required.
Optional:
o port
The number of the port on the switch. Specify the port attribute only if the type attribute is
set to switch.
<failoverMode>
The failover mode of a resource group.
Parent: <resourcegroup>
Children: None
Attributes: Required:
o value
The value attribute can be set to failover or scalable.
<managedState>
Indicates whether a resource group is managed or unmanaged.
Parent: <resourcegroup>
Children: None
Attributes: Required:
o value
The value attribute can be either true or false.
<memberDevice>
The member name of a particular device group. If the <devicegroup> is a set of type rawdisk, then you must specify one or more <member>
elements, each with the name of the raw-disk path.
Parent: <memberDeviceList>
Children: None
Attributes: Required:
o name
The name of the member.
<memberDeviceList>
A list of device group members.
Parent: <devicegroup> (one or more)
Children: Required:
o <memberDevice>
Attributes: None
<method>
Mapping between a generic method type and the actual method name for a specific resource type.
Parent: <methodList>
Children: None
Attributes: Required:
o name
The actual name of the method for the resource type.
o type
The type of method for the resource type. You can specify the following types:
o MONITOR_CHECK
o MONITOR_START
o MONITOR_STOP
o PRENET_START
o START
o STOP
o VALIDATE
o UPDATE
<methodList>
A list of all of the <method> elements that are available for a specific <resourcetype>.
Parent: <resourcetype>
Children: Optional:
o <method>
Attributes: Fixed:
o readonly
The readonly attribute has a fixed value of true.
<monitoredState>
A Boolean value that indicates a portion of an element's state in the cluster. For example, the <monitoredState> of a resource speci-
fies whether the resource is monitored, but does not specify whether the resource is available.
Parent: <resource>
Children: None
Attributes: Required:
o value
The value attribute can be set to true or false.
<nasdevice>
A single instance of a NAS device on the cluster.
Parent: <nasdeviceList>
Children: Optional:
o <nasdir>
Attributes: Required:
o name
The hostname of the NAS device.
o type
The type of NAS device. You must specify either sun or netapp.
Optional:
o userid
The user name that is required to access the NAS device.
<nasdeviceList>
A list of all NAS devices on the cluster.
Parent: <cluster>
Children: Optional:
o <nasdevice>
Attributes: None
<nasdir>
One directory on a NAS device. Each NAS device can have multiple NAS directories.
Parent: <nasdevice>
Children: None
Attributes: Required:
o path
The path to the NAS directory.
<node>
A cluster node. Specify one <node> element for each node in the cluster.
Parent: <nodeList>
Children: Optional:
o <propertyList>
Attributes: Required:
o name
Must be equal to the name of the node.
Optional:
o globaldevfs
The path to the global mount directory.
o id
The cluster node ID. If not specified, the cluster node ID attribute is provided a default value
of an empty string.
<nodeList>
A list of all nodes in the cluster.
Parent: <cluster>
Children: Optional:
o <node>
At least one node attribute must be supplied for each node on the cluster.
Attributes: None
<parameter>
A set of attributes that describes the <method> element timeout values and other parameters for a cluster resource type.
Parent: <parameterList>
Children: None
Attributes: Required:
o extension
The extension attribute can be set to true or false.
o name
The name of the parameter.
o tunability
The value of the parameter's tunability. The tunability attribute can be set to one of the fol-
lowing values: atCreation, anyTime, or whenDisabled.
o type
The type of the parameter. The type attribute can be set to one of the following values: bool-
ean, enum, int , string, or stringArray.
Optional:
o default
The default value of this parameter if a value is not explicitly specified. For example, the
default for the method element timeout is START.
o description
A description of the parameter. If not defined, this attribute defaults to an empty string.
o enumList
An enumerated list of objects. For example, the attribute might be a list of failover modes in
order of preference.
o maxLength
The maximum length of a string or stringArray type parameter.
o minArrayLength
The minimum size of an stringArray type parameter.
o minLength
The minimum length of a string or stringArray type parameter.
<parameterList>
A list of <parameter> elements that describes a resource type.
Parent: <resourcetype>
Children: Optional:
o <parameter>
Attributes: Fixed:
o readonly
The readonly attribute has a fixed value of true.
<property>
A generic element that describes one property. The property is not specific to any subset of cluster related configuration.
Parent: <propertyList>
Children: None
Attributes: Required:
o name
The name of the property.
o value
The value of the property.
Optional:
o readonly
The readonly attribute can be set to true or false. If this value is not specified, the
attribute defaults to the value false.
o type
The property type.
<propertyList>
A list of <property> elements. The <propertyList> element is a generic element.
Parents: <cluster>, <deviceGroup>, <node>, <quorumDevice>, <quorumNode>, <resource>, <resourceNode>, <resource-
group>, <resourceType>, <transportAdapter>, <transportType>
Children: Optional:
o <property>
Attributes: Optional:
o extension
This attribute can have one of the following values: true, false, mixed, or doesNotApply. If a
value is not specified, the extension attribute has a default value of doesNotApply.
o readonly
This attribute can have a value of true or false. If a value is not specified, the readonly
attribute has a default value of false.
<quorumDevice>
An individual cluster quorum device.
Parent: <quorumDeviceList>
Children: Optional:
o <propertyList>
The <quorumDevice> element can have only one <propertyList> child.
o <quorumDevicePathList>
The <quorumDevice> element can have only one <quorumDevicePathList> child.
Attributes: Required:
o name
The name of the quorum device.
o type
The type of quorum device that is referenced by this element. The type attribute can be set to
netapp_nas, scsi, or quorum_server.
<quorumDeviceList>
A list of all quorum devices in the cluster.
Parent: <clusterQuorum>
Children: Optional:
o <quorumDevice>
Attributes: None
<quorumDevicePath>
The path to a cluster quorum device.
Parent: <quorumDevicePathList>
Children: Optional:
o <state>
The <quorumDevicePath> element can have only one <state> child.
Attributes: Required:
o nodeRef
The name of the node that the quorum device resides on.
<quorumDevicePathList>
A list of all paths to a particular <quorumDevice>.
Parent: <quorumDevice>
Children: Required:
o <quorumDevicePath>
Attributes: Fixed:
o readonly
The readonly attribute is set to true.
<quorumNode>
A node in the cluster that participates in the cluster quorum.
Parent: <quorumNodeList>
Children: Optional:
o <propertyList>
Attributes: Required:
o <nodeRef>
The name of the node.
<quorumNodeList>
A list of all nodes that participate in the cluster quorum. In a functional cluster that is not in installmode, this list typically
contains all nodes in the cluster. In a cluster that is still in installmode, this list might contain only one of the cluster nodes.
Parent: <clusterQuorum>
Children: Required:
o <quorumNode>
Attributes: Fixed:
o readonly
The readonly attribute is set to true.
<resource>
A cluster resource.
Parent: <resourceList>
Children: Optional:
o <resourceNodeList>
o <propertyList>
Attributes: Required:
o name
The name of the resource.
o resourcegroupRef
The resource group to which the resource belongs.
o resourcetypeRef
The type of resource that is described by this element.
<resourceList>
A list of the root node for the cluster resources that are defined in the configuration.
Parent: <cluster>
Children: Optional:
o <resource>
Attributes: None
<resourcegroup>
A cluster resource group.
Parent: <resourcegroupList>
Children: Required:
o <failoverMode>
o <managedState>
o <resourcegroupNodeList>
o <resourcegroupResourceList>
o <propertyList>
Attributes: Required:
o name
The name of the resource.
<resourcegroupList>
The root node for the cluster resource groups that are defined in the configuration.
Parent: <cluster>
Children: Optional:
o <resourcegroup>
Attributes: None
<resourcegroupNode>
The node on which a resource group is defined.
Parent: <resourcegroupNodeList>
Children: None
Attributes: Required:
o nodeRef
The name of the cluster node.
Optional:
o Zone
The name of the zone.
<resourcegroupNodeList>
The cluster nodes on which a particular resource group operates.
Parent: <resourcegroup>
Children: Required:
o <resourcegroupNode>
Attributes: None
<resourcegroupResource>
A cluster resource that belongs to a particular resource group.
Parent: <resourcegroupResourceList>
Children: None
Attributes: Required:
o resourceRef
The name of the resource.
<resourcegroupResourceList>
A list of the resources that are defined in a resource group.
Parent: <resourcegroup>
Children: Optional:
o <resourcegroupResource>
Attributes: None
<resourceNode>
The node on which a resource is defined.
Parent: <resourceNodeList>
Children: Required:
o <state>
o <monitoredState>
Optional:
o <propertyList>
Attributes: Required:
o nodeRef
The name of the resource type.
Optional:
o zone
The name of the zone.
<resourcetype>
A cluster resource type that is available in the cluster.
Parent: <resourcetypeList>
Children: Optional:
o <resourcetypeRTRFile>
o <resourcetypeNodeList>
o <methodList>
o <parameterList>
o <propertyList>
Attributes: Required:
o name
The name of the resource type.
<resourcetypeList>
The root node of the cluster resource types that are defined in the configuration.
Parent: <cluster>
Children: Optional:
o <resourcetype>
Attributes: None
<resourcetypeNode>
A node on which a resource type is defined.
Parent: <resourcetypeNodeList>
Children: None
Attributes: Required:
o nodeRef
The name of the cluster node.
<resourcetypeNodeList>
A list of the cluster nodes on which a particular resource type exists.
Parent: <resourcetype>
Children: Required : The <resourcetypeNodeList> element must contain either one or more <resourcetypeNode> elements
or exactly one <allNodes> element.
o <resourcetypeNode>
o <allNodes>
Attributes: None
<resourcetypeRTRFile>
The name of a resource type registration (RTR) file that describes a particular resource type.
Parent: <resourcetype>
Children: None
Attributes: Required:
o name
The name of the RTR file.
<snmphost>
The SNMP host and community that are configured on a cluster node.
Parent: <snmphostList>
Children: None
Attributes: Required:
o community
The SNMP community name.
o name
The name of the instance.
o nodeRef
The node on which the SNMP host and community exist.
<snmphostList>
A list of the SNMP hosts and communities that are configured on a cluster node.
Parent: <cluster>
Children: Optional:
o <snmphost>
Attributes: None
<snmpmib>
An SNMP MIB that is on a cluster node.
Parent: <snmpmibList>
Children: Optional:
o state
Attributes: Required:
o name
The name of the MIB.
o nodeRef
The node on which the SNMP MIB exists.
Optional:
o protocol
The SNMP protocol that the MIB will use. This attribute defaults to SNMPv2.
o value
SNMPv3 or SNMPv2
snmpmibList
A list of the SNMP MIBs that are on a cluster node.
Parent: <cluster>
Children: Optional:
o <snmpmib>
Attributes: None
<snmpuser>
The SNMPv3 user that is configured on a cluster node.
Parent: <snmpuserList>
Children: None
Attributes: Required:
o name
The name of the user.
o nodeRef
The node on which the SNMPv3 user exists.
o auth
The auth attribute can be set to MD5 or SHA.
Optional:
o defaultUser
The defaultUser attribute can be set to yes or no. If a value is not specified, the attribute
defaults to whichever value is appropriate, based on the node configuration.
o defaultSecurityLevel
The security level of the user. The security attribute can be set to one of the following val-
ues:
o authPriv
o authNoPriv
o noAuthNoPriv
<snmpuserList>
A list of the SNMPv3 users that are configured on a cluster node.
Parent: <cluster>
Children: <snmpuser>
Attributes: None
<state>
The state of various objects within the cluster configuration. The <state> element is a generic element.
Parent: <quorumDevicePath>, <resourceNode>, <snmpmib>, <telemetryAttribute>, <transportAdapter>, <transportCable>,
<transportSwitch>
Children: None
Attributes: Required:
o value
The value attribute can be set to enabled or disabled.
<telemetrics>
Cluster monitoring thresholds
Parent: <cluster>
Children: Optional:
o <telemetryObjectType>
Attributes: None
<telemetryAttribute>
The attributes of system resources that you can monitor.
Parent: <telemetryObjectType>
Children: Required:
o <state> (1 or more)
Attributes: Required:
o name
The name of the attribute.
<telemetryObjectType>
The types of objects you can monitor.
Parent: <telemetrics>
Children: Required:
o <telemetryAttibute>
Attributes: Required:
o name
The name of the attribute.
<transportAdapter>
A network adapter that is used in the private cluster transport.
Parent: <transportNode>
Children: Optional:
o <state>
o <transportType>
o <propertyList>
Attributes: Required:
o name
The name of the network adapter.
<transportCable>
A network cable that is used in the private cluster transport. The cable does not necessarily imply a physical cable, but rather a
path between two <endpoint> elements.
Parent: <transportCableList>
Children: Required:
o <endpoint>
The <transportCable> element must have two <endpoint> elements. Each endpoint element must
describe one of the cable endpoints.
Optional:
o <state>
The <transportCable> element can have one <state> element.
Attributes: None
<transportCableList>
A list of the network cables that are used to connect two cluster <endpoint> elements.
Parent: <clusterTransport>
Children: Optional:
o <transportCable>
Attributes: None
<transportNode>
One of the cluster nodes that is used in the private cluster transport. Specify one <transportNode> element for each node of the clus-
ter.
Parent: <transportNodeList>
Children: Optional:
o <nodeRef>
Attributes: Required:
o transportAdapterList
The name of the cluster node.
<transportNodeList>
A list of the nodes that are used in the private cluster transport. This list of nodes always contains the same set of nodes as the
members of the cluster.
Parent: <clusterTransport>
Children: Optional:
o <transportNode>
Attributes: None
<transportSwitch>
A cluster transport switch.
Parent: <transportSwitchList>
Children: Optional:
o <state>
Attributes: Required:
o name
The name of the transport switch.
Optional:
o port
The number of the port on the switch.
<transportSwitchList>
A list of the network switches that are used by the private cluster transport system.
Parent: <clusterTransport>
Children: Optional:
o <transportSwitch>
Attributes: None
<transportType>
The type of network transport that is used for a <transportAdapter> element.
Parent: <transportAdapter>
Children: Optional:
o <propertyList>
Attributes: Required:
o value
The value attribute can be set to dlpi or rsm.
FILES
/usr/cluster/lib/xml/cluster.dtd
The document type definition (DTD) file that defines the structure of the Sun Cluster configuration XML file.
SEE ALSO
Intro(1CL), cluster(1CL)
http://www.w3.org/XML/
Sun Cluster 3.2 10 Sep 2007 clconfiguration(5CL)