Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1 |
- describes the cluster DTD for the Oracle Solaris Cluster configuration XML file
clconfiguration describes the Documentation Type Definition (DTD) for the Oracle Solaris Cluster configuration eXtensible Markup Language (XML) file. The Oracle Solaris Cluster configuration file contains Oracle Solaris Cluster configuration information tagged with XML elements. The file can contain configuration information for one or more clusters, or even for a portion of a cluster. This Oracle Solaris 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 Oracle Solaris Cluster commands include an export subcommand that exports cluster object information in the format described in the DTD. Many Oracle Solaris Cluster commands have the option to add, create, and modify Oracle Solaris Cluster objects through the use of cluster configuration XML data.
The following list provides the element hierarchy required by the DTD. This list uses the following defaults for children and attribute properties:
Unless otherwise specified, one or more is required.
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>
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.
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.
<resourcetypeNodeList>
None
None
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.
None
Optional:
<propertyList>
<nodeList>
<clusterTransport>
<deviceList>
<clusterQuorum>
<deviceGroupList>
<resourcetypeList>
<resourcegroupList>
<resourceList>
<nasdeviceList>
<snmpmibList>
<snmphostList>
<snmpuserList>
Required:
name
The name of the cluster.
The root element of the cluster quorum configuration. All cluster quorum information is defined in the child elements of the <clusterQuorum> element.
<cluster>
Optional:
<quorumDeviceList>
<quorumNodeList>
None
The root element of the cluster transport configuration. All cluster transport information is displayed in a sublevel of the <clusterTransport> element.
<cluster>.
Optional:
<transportNodeList>
<transportSwitchList>
<transportCableList>
None
A cluster device ID pseudo-driver (DID) device.
<deviceList>
Optional:
<devicePath> (zero or more)
Required:
ctd
The UNIX disk name.
name
The instance number of the device.
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.
<devicegroupList>
Optional:
<devicegroupNodeList>
<memberDeviceList>
<propertyList>
Required:
name
The name of the device group. The name attribute can be any valid sequence of characters.
type
The type of the device group. The type attribute can have a value of rawdisk, vxvm, svm, or sds.
A list of all the cluster device groups.
<cluster>
Optional:
<devicegroup>
One <devicegroup> element can be used for each device group in the cluster.
None
The node on which a device group is located.
<devicegroupNodeList>
None
Required:
nodeRef
Specifies the name of a cluster node.
A list of nodes on which a device group is located.
<devicegroup> (1 or more)
Required:
<devicegroupNode> (1 or more)
None
A list of cluster DID devices.
<cluster>
Optional:
<device>
Fixed:
readonly
The readonly attribute has a fixed value of true.
The node and disk device on which a particular <device> exists.
<device>
None
Required:
nodeRef
The name of the node on which an instance exists.
One of the transport endpoints.
<transportCable>
None
Required:
name
The name of the adapter or switch.
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.
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:
port
The number of the port on the switch. Specify the port attribute only if the type attribute is set to switch.
The failover mode of a resource group.
<resourcegroup>
None
Required:
value
The value attribute can be set to failover or scalable.
Indicates whether a resource group is managed or unmanaged.
<resourcegroup>
None
Required:
value
The value attribute can be either true or false.
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.
<memberDeviceList>
None
Required:
name
The name of the member.
A list of device group members.
<devicegroup> (one or more)
Required:
<memberDevice>
None
Mapping between a generic method type and the actual method name for a specific resource type.
<methodList>
None
Required:
name
The actual name of the method for the resource type.
type
The type of method for the resource type. You can specify the following types:
MONITOR_CHECK
MONITOR_START
MONITOR_STOP
PRENET_START
START
STOP
VALIDATE
UPDATE
A list of all of the <method> elements that are available for a specific <resourcetype>.
<resourcetype>
Optional:
<method>
Fixed:
readonly
The readonly attribute has a fixed value of true.
A Boolean value that indicates a portion of an element's state in the cluster. For example, the <monitoredState> of a resource specifies whether the resource is monitored, but does not specify whether the resource is available.
<resource>
None
Required:
value
The value attribute can be set to true or false.
A single instance of a NAS device on the cluster.
<nasdeviceList>
Optional:
<nasdir>
Required:
name
The hostname of the NAS device.
type
The type of NAS device. You must specify sun_uss for a Sun ZFS Storage Appliance.
Optional:
userid
The user name that is required to access the NAS device.
A list of all NAS devices on the cluster.
<cluster>
Optional:
<nasdevice>
None
One directory on a NAS device. Each NAS device can have multiple NAS directories.
<nasdevice>
None
Required:
path
The path to the NAS directory.
A cluster node. Specify one <node> element for each node in the cluster.
<nodeList>
Optional:
<propertyList>
Required:
name
Must be equal to the name of the node.
Optional:
id
The cluster node ID. If not specified, the cluster node ID attribute is provided a default value of an empty string.
A list of all nodes in the cluster.
<cluster>
Optional:
<node>
At least one node attribute must be supplied for each node on the cluster.
None
A set of attributes that describes the <method> element timeout values and other parameters for a cluster resource type.
<parameterList>
None
Required:
extension
The extension attribute can be set to true or false.
name
The name of the parameter.
tunability
The value of the parameter's tunability. The tunability attribute can be set to one of the following values: atCreation, anyTime, or whenDisabled.
type
The type of the parameter. The type attribute can be set to one of the following values: boolean, enum, int , string, or stringArray.
Optional:
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.
description
A description of the parameter. If not defined, this attribute defaults to an empty string.
enumList
An enumerated list of objects. For example, the attribute might be a list of failover modes in order of preference.
maxLength
The maximum length of a string or stringArray type parameter.
minArrayLength
The minimum size of an stringArray type parameter.
minLength
The minimum length of a string or stringArray type parameter.
A list of <parameter> elements that describes a resource type.
<resourcetype>
Optional:
<parameter>
Fixed:
readonly
The readonly attribute has a fixed value of true.
A generic element that describes one property. The property is not specific to any subset of cluster related configuration.
<propertyList>
None
Required:
name
The name of the property.
value
The value of the property.
Optional:
readonly
The readonly attribute can be set to true or false. If this value is not specified, the attribute defaults to the value false.
type
The property type.
A list of <property> elements. The <propertyList> element is a generic element.
<cluster>, <deviceGroup>, <node>, <quorumDevice>, <quorumNode>, <resource>, <resourceNode>, <resourcegroup>, <resourceType>, <transportAdapter>, <transportType>
Optional:
<property>
Optional:
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.
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.
An individual cluster quorum device.
<quorumDeviceList>
Optional:
<propertyList>
The <quorumDevice> element can have only one <propertyList> child.
<quorumDevicePathList>
The <quorumDevice> element can have only one <quorumDevicePathList> child.
Required:
name
The name of the quorum device.
type
The type of quorum device that is referenced by this element. The type attribute can be set to scsi or quorum_server.
A list of all quorum devices in the cluster.
<clusterQuorum>
Optional:
<quorumDevice>
None
The path to a cluster quorum device.
<quorumDevicePathList>
Optional:
<state>
The <quorumDevicePath> element can have only one <state> child.
Required:
nodeRef
The name of the node that the quorum device resides on.
A list of all paths to a particular <quorumDevice>.
<quorumDevice>
Required:
<quorumDevicePath>
Fixed:
readonly
The readonly attribute is set to true.
A node in the cluster that participates in the cluster quorum.
<quorumNodeList>
Optional:
<propertyList>
Required:
<nodeRef>
The name of the node.
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.
<clusterQuorum>
Required:
<quorumNode>
Fixed:
readonly
The readonly attribute is set to true.
A cluster resource.
<resourceList>
Optional:
<resourceNodeList>
<propertyList>
Required:
name
The name of the resource.
resourcegroupRef
The resource group to which the resource belongs.
resourcetypeRef
The type of resource that is described by this element.
A list of the root node for the cluster resources that are defined in the configuration.
<cluster>
Optional:
<resource>
None
A cluster resource group.
<resourcegroupList>
Required:
<failoverMode>
<managedState>
<resourcegroupNodeList>
<resourcegroupResourceList>
<propertyList>
Required:
name
The name of the resource.
The root node for the cluster resource groups that are defined in the configuration.
<cluster>
Optional:
<resourcegroup>
None
The node on which a resource group is defined.
<resourcegroupNodeList>
None
Required:
nodeRef
The name of the cluster node.
The cluster nodes on which a particular resource group operates.
<resourcegroup>
Required:
<resourcegroupNode>
None
A cluster resource that belongs to a particular resource group.
<resourcegroupResourceList>
None
Required:
resourceRef
The name of the resource.
A list of the resources that are defined in a resource group.
<resourcegroup>
Optional:
<resourcegroupResource>
None
The node on which a resource is defined.
<resourceNodeList>
Required:
<state>
<monitoredState>
Optional:
<propertyList>
Required:
nodeRef
The name of the resource type.
A cluster resource type that is available in the cluster.
<resourcetypeList>
Optional:
<resourcetypeRTRFile>
<resourcetypeNodeList>
<methodList>
<parameterList>
<propertyList>
Required:
name
The name of the resource type.
The root node of the cluster resource types that are defined in the configuration.
<cluster>
Optional:
<resourcetype>
None
A node on which a resource type is defined.
<resourcetypeNodeList>
None
Required:
nodeRef
The name of the cluster node.
A list of the cluster nodes on which a particular resource type exists.
<resourcetype>
Required : The <resourcetypeNodeList> element must contain either one or more <resourcetypeNode> elements or exactly one <allNodes> element.
<resourcetypeNode>
<allNodes>
None
The name of a resource type registration (RTR) file that describes a particular resource type.
<resourcetype>
None
Required:
name
The name of the RTR file.
The SNMP host and community that are configured on a cluster node.
<snmphostList>
None
Required:
community
The SNMP community name.
name
The name of the instance.
nodeRef
The node on which the SNMP host and community exist.
A list of the SNMP hosts and communities that are configured on a cluster node.
cluster>
Optional:
<snmphost>
None
An SNMP MIB that is on a cluster node.
<snmpmibList>
Optional:
state
Required:
name
The name of the MIB.
nodeRef
The node on which the SNMP MIB exists.
Optional:
protocol
The SNMP protocol that the MIB will use. This attribute defaults to SNMPv2.
value
SNMPv3 or SNMPv2
A list of the SNMP MIBs that are on a cluster node.
<cluster>
Optional:
<snmpmib>
None
The SNMPv3 user that is configured on a cluster node.
<snmpuserList>
None
Required:
name
The name of the user.
nodeRef
The node on which the SNMPv3 user exists.
auth
The auth attribute can be set to MD5 or SHA.
Optional:
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.
defaultSecurityLevel
The security level of the user. The security attribute can be set to one of the following values:
authPriv
authNoPriv
noAuthNoPriv
A list of the SNMPv3 users that are configured on a cluster node.
<cluster>
<snmpuser>
None
The state of various objects within the cluster configuration. The <state> element is a generic element.
<quorumDevicePath>, <resourceNode>, snmpmib>, telemetryAttribute, <transportAdapter>, <transportCable>, <transportSwitch>
None
Required:
value
The value attribute can be set to enabled or disabled.
Cluster monitoring thresholds
<cluster>
Optional:
<telemetryObjectType>
None
The attributes of system resources that you can monitor.
<telemetryObjectType>
Required:
<state> (1 or more)
Required:
name
The name of the attribute.
The types of objects you can monitor.
<telemetrics>
Required:
<telemetryAttibute>
Required:
name
The name of the attribute.
A network adapter that is used in the private cluster transport.
<transportNode>
Optional:
<state>
<transportType>
<propertyList>
Required:
name
The name of the network adapter.
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.
<transportCableList>
Required:
<endpoint>
The <transportCable> element must have two <endpoint> elements. Each endpoint element must describe one of the cable endpoints.
Optional:
<state>
The <transportCable> element can have one <state> element.
None
A list of the network cables that are used to connect two cluster <endpoint> elements.
<clusterTransport>
Optional:
<transportCable>
None
One of the cluster nodes that is used in the private cluster transport. Specify one <transportNode> element for each node of the cluster.
<transportNodeList>
Optional:
<nodeRef>
Required:
transportAdapterList
The name of the cluster node.
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.
<clusterTransport>
Optional:
<transportNode>
None
A cluster transport switch.
<transportSwitchList>
Optional:
<state>
Required:
name
The name of the transport switch.
Optional:
port
The number of the port on the switch.
A list of the network switches that are used by the private cluster transport system.
<clusterTransport>
Optional:
<transportSwitch>
None
The type of network transport that is used for a <transportAdapter> element.
<transportAdapter>
Optional:
<propertyList>
Required:
value
The value attribute can be set to dlpi or rsm.
The document type definition (DTD) file that defines the structure of the Oracle Solaris Cluster configuration XML file.