Oracle® Solaris Cluster 参考手册

退出打印视图

 
更新时间： 2014 年 7 月，E51743-01
 
 

clconfiguration (5CL)

名称

clconfiguration - 描述 Oracle Solaris Cluster 配置 XML 文件的群集 DTD

描述

clconfiguration 描述 Oracle Solaris Cluster 配置可扩展标记语言 (eXtensible Markup Language, XML) 文件的文档类型定义 (Documentation Type Definition, DTD)。Oracle Solaris Cluster 配置文件包含使用 XML 元素进行标记的 Oracle Solaris Cluster 配置信息。该文件可能包含一个或多个群集（或甚至群集的一部分）的配置信息。该 Oracle Solaris Cluster 配置信息可用于许多群集功能，包括群集配置备份和群集复制。

DTD 可定义元素、元素的关系及属性。元素名称反映所提供的内容。例如，元素 <devicegroup> 定义群集设备组。元素可能具有用于修改或完善其属性或特征的特性。许多面向对象的 Oracle Solaris Cluster 命令包含 export 子命令，该子命令以 DTD 中描述的格式导出群集对象信息。许多 Oracle Solaris Cluster 命令具有通过使用群集配置 XML 数据添加、创建和修改 Oracle Solaris Cluster 对象的选项。

元素分层结构

以下列表提供了 DTD 所需的元素分层结构。该列表将以下默认值用于子项和特性属性：

必需

除非另有说明，需要一个或多个。

可选

除非另有说明，可以为零或一个。

<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>

元素

此部分列出并描述了群集 DTD 中定义的所有元素。如果元素具有必需的子项或属性，则必需项默认为一个。可选元素默认为零或一个。

<allNodes>

群集中所有成员节点的列表。<allNodes> 元素为通用元素。

<allNodes> 元素用于表示群集的所有节点。

父项：

<resourcetypeNodeList>

子项：

无

属性：

无

<cluster>

完整群集配置 XML 文件的根元素。每个群集配置 XML 文件都必须以此元素（作为根元素）开始。DTD 只能接受一个 <cluster> 元素。群集配置 XML 文件中的后续 <cluster> 元素将被忽略。

父项：

无

子项：

可选：

  • <propertyList>

  • <nodeList>

  • <clusterTransport>

  • <deviceList>

  • <clusterQuorum>

  • <deviceGroupList>

  • <resourcetypeList>

  • <resourcegroupList>

  • <resourceList>

  • <nasdeviceList>

  • <snmpmibList>

  • <snmphostList>

  • <snmpuserList>

属性：

必需：

  • name

    群集的名称。

<clusterQuorum>

群集法定配置的根元素。所有群集法定信息在 <clusterQuorum> 元素的子元素中进行定义。

父项：

<cluster>

子项：

可选：

  • <quorumDeviceList>

  • <quorumNodeList>

属性：

无

<clusterTransport>

群集传输配置的根元素。所有群集传输信息都显示在 <clusterTransport> 元素的子级别。

父项：

<cluster>。

子项：

可选：

  • <transportNodeList>

  • <transportSwitchList>

  • <transportCableList>

属性：

无

<device>

群集设备 ID 伪驱动程序 (DID) 设备。

父项：

<deviceList>

子项：

可选：

  • <devicePath>（零个或多个）

属性：

必需：

  • ctd

    UNIX 磁盘名称。

  • name

    设备的实例编号。

<devicegroup>

群集设备组实例的根元素。单个设备组的所有方面都在 <devicegroup> 元素的子元素中进行定义。

父项：

<devicegroupList>

子项：

可选：

  • <devicegroupNodeList>

  • <memberDeviceList>

  • <propertyList>

属性：

必需：

  • name

    设备组的名称。name 属性可以是任何有效的字符序列。

  • type

    设备组的类型。type 属性的值可以为 rawdisk、vxvm、svm 或 sds。

<devicegroupList>

所有群集设备组的列表。

父项：

<cluster>

子项：

可选：

  • <devicegroup>

    一个 <devicegroup> 元素可用于群集中的每个设备组。

属性：

无

<devicegroupNode>

设备组所在的节点。

父项：

<devicegroupNodeList>

子项：

无

属性：

必需：

  • nodeRef

    指定群集节点的名称。

<devicegroupNodeList>

设备组所在的节点的列表。

父项：

<devicegroup>（1 个或多个）

子项：

必需：

  • <devicegroupNode>（1 个或多个）

属性：

无

<deviceList>

群集 DID 设备列表。

父项：

<cluster>

子项：

可选：

  • <device>

属性：

固定：

  • readonly

    readonly 属性具有固定值 true。

<deviceNode>

存在特定 <device> 的节点和磁盘设备。

父项：

<device>

子项：

无

属性：

必需：

  • nodeRef

    存在实例的节点的名称。

<endpoint>

传输端点之一。

父项：

<transportCable>

子项：

无

属性：

必需：

  • name

    适配器或交换机的名称。

  • nodeRef

    托管指定适配器的节点的名称。仅当 type 属性设置为 adapter 时，才需要 nodeRef 属性。

  • type

    type 属性可以设置为 adapter 或 switch。

    如果 type 属性设置为 adapter，则必须指定 nodeRef 属性。

    如果 type 属性设置为 switch，则可以指定 port 属性。但是，port 属性不是必需的。

可选：

  • port

    交换机的端口号。仅当 type 属性设置为 switch 时，才指定 port 属性。

<failoverMode>

资源组的故障转移模式。

父项：

<resourcegroup>

子项：

无

属性：

必需：

  • value

    value 属性可以设置为 failover 或 scalable。

<managedState>

指示资源组受管理还是不受管理。

父项：

<resourcegroup>

子项：

无

属性：

必需：

  • value

    value 属性可以为 true 或 false。

<memberDevice>

特定设备组的成员名称。如果 <devicegroup> 是一组 rawdisk 类型，则必须指定一个或多个 <member> 元素，其中每个元素都带有原始磁盘路径的名称。

父项：

<memberDeviceList>

子项：

无

属性：

必需：

  • name

    成员的名称。

<memberDeviceList>

设备组成员列表。

父项：

<devicegroup>（一个或多个）

子项：

必需：

  • <memberDevice>

属性：

无

<method>

通用方法类型与特定资源类型的实际方法名称之间的映射。

父项：

<methodList>

子项：

无

属性：

必需：

  • name

    资源类型的方法的实际名称。

  • type

    资源类型的方法的类型。可以指定以下类型：

    • MONITOR_CHECK

    • MONITOR_START

    • MONITOR_STOP

    • PRENET_START

    • START

    • STOP

    • VALIDATE

    • UPDATE

<methodList>

适用于特定 <resourcetype> 的所有 <method> 元素的列表。

父项：

<resourcetype>

子项：

可选：

  • <method>

属性：

固定：

  • readonly

    readonly 属性的固定值为 true。

<monitoredState>

指示群集中元素状态的一部分的布尔值。例如，资源的 <monitoredState> 指定资源是否受监视，但不指定资源是否可用。

父项：

<resource>

子项：

无

属性：

必需：

  • value

    value 属性可以设置为 true 或 false。

<nasdevice>

群集上 NAS 设备的单个实例。

父项：

<nasdeviceList>

子项：

可选：

  • <nasdir>

属性：

必需：

  • name

    NAS 设备的主机名。

  • type

    NAS 设备的类型。必须为 Oracle ZFS Storage Appliance 指定 sun_uss。

可选：

  • userid

    访问 NAS 设备所必需的用户名。

<nasdeviceList>

群集中所有 NAS 设备的列表。

父项：

<cluster>

子项：

可选：

  • <nasdevice>

属性：

无

<nasdir>

NAS 设备的一个目录。每个 NAS 设备可以具有多个 NAS 目录。

父项：

<nasdevice>

子项：

无

属性：

必需：

  • path

    NAS 目录的路径。

<node>

群集节点。为群集中的每个节点指定一个 <node> 元素。

父项：

<nodeList>

子项：

可选：

  • <propertyList>

属性：

必需：

  • name

    必须等同于节点名称。

可选：

  • id

    群集节点 ID。如果未指定，则为群集节点 ID 属性提供空字符串默认值。

<nodeList>

群集中所有节点的列表。

父项：

<cluster>

子项：

可选：

  • <node>

    必须为群集上的每个节点至少提供一个 node 属性。

属性：

无

<parameter>

描述 <method> 元素超时值和群集资源类型的其他参数的一组属性。

父项：

<parameterList>

子项：

无

属性：

必需：

  • extension

    extension 属性可以设置为 true 或 false。

  • name

    参数的名称。

  • tunability

    参数可调性的值。tunability 属性可以设置为以下值之一：atCreation、anyTime 或 whenDisabled。

  • type

    参数类型。type 属性可以设置为以下值之一：boolean、enum、int、string 或 stringArray。

可选：

  • default

    如果未显式指定一个值，则为该参数的默认值。例如，method 元素超时的默认值为 START。

  • description

    参数的描述。如果未定义，则该属性默认为空字符串。

  • enumList

    对象的枚举列表。例如，属性可能为按照优先级顺序排列的故障转移模式的列表。

  • maxLength

    string 或 stringArray 类型参数的最大长度。

  • minArrayLength

    stringArray 类型参数的最小大小。

  • minLength

    string 或 stringArray 类型参数的最小长度。

<parameterList>

描述资源类型的 <parameter> 元素的列表。

父项：

<resourcetype>

子项：

可选：

  • <parameter>

属性：

固定：

  • readonly

    readonly 属性具有固定值 true。

<property>

描述一个属性的通用元素。该属性不特定于与群集相关的配置的任何子集。

父项：

<propertyList>

子项：

无

属性：

必需：

  • name

    属性的名称。

  • value

    属性的值。

可选：

  • readonly

    readonly 属性可以设置为 true 或 false。如果未指定该值，则属性默认为值 false。

  • type

    属性类型。

<propertyList>

<property> 元素的列表。 <propertyList> 元素为通用元素。

父项：

<cluster>, <deviceGroup>, <node>, <quorumDevice>, <quorumNode>, <resource>, <resourceNode> , <resourcegroup>, <resourceType>, <transportAdapter>, <transportType>

子项：

可选：

  • <property>

属性：

可选：

  • extension

    该属性可以具有以下值之一：true、false、mixed 或 doesNotApply。如果未指定值，则 extension 属性具有默认值 doesNotApply。

  • readonly

    该属性可以具有值 true 或 false。如果未指定值，则 readonly 属性具有默认值 false。

<quorumDevice>

单个群集法定设备。

父项：

<quorumDeviceList>

子项：

可选：

  • <propertyList>

    <quorumDevice> 元素只能有一个 <propertyList> 子项。

  • <quorumDevicePathList>

    <quorumDevice> 元素只能有一个 <quorumDevicePathList> 子项。

属性：

必需：

  • name

    法定设备的名称。

  • type

    该元素引用的法定设备的类型。type 属性可以设置为 scsi 或 quorum_server。

<quorumDeviceList>

群集中所有法定设备的列表。

父项：

<clusterQuorum>

子项：

可选：

  • <quorumDevice>

属性：

无

<quorumDevicePath>

群集法定设备的路径。

父项：

<quorumDevicePathList>

子项：

可选：

  • <state>

    <quorumDevicePath> 元素只能有一个 <state> 子项。

属性：

必需：

  • nodeRef

    法定设备驻留的节点名称。

<quorumDevicePathList>

特定 <quorumDevice> 的所有路径的列表。

父项：

<quorumDevice>

子项：

必需：

  • <quorumDevicePath>

属性：

固定：

  • readonly

    readonly 属性设置为 true。

<quorumNode>

参与群集法定的群集中的节点。

父项：

<quorumNodeList>

子项：

可选：

  • <propertyList>

属性：

必需：

  • <nodeRef>

    节点名称。

<quorumNodeList>

参与群集法定的所有节点的列表。在不处于 installmode 的功能群集中，该列表通常包含群集中的所有节点。在仍处于 installmode 的群集中，该列表可能只包含群集节点之一。

父项：

<clusterQuorum>

子项：

必需：

  • <quorumNode>

属性：

固定：

  • readonly

    readonly 属性设置为 true。

<resource>

群集资源。

父项：

<resourceList>

子项：

可选：

  • <resourceNodeList>

  • <propertyList>

属性：

必需：

  • name

    资源的名称。

  • resourcegroupRef

    资源所属的资源组。

  • resourcetypeRef

    该元素描述的资源的类型。

<resourceList>

在配置中定义的群集资源的根节点列表。

父项：

<cluster>

子项：

可选：

  • <resource>

属性：

无

<resourcegroup>

群集资源组。

父项：

<resourcegroupList>

子项：

必需：

  • <failoverMode>

  • <managedState>

  • <resourcegroupNodeList>

  • <resourcegroupResourceList>

  • <propertyList>

属性：

必需：

  • name

    资源的名称。

<resourcegroupList>

在配置中定义的群集资源组的根节点。

父项：

<cluster>

子项：

可选：

  • <resourcegroup>

属性：

无

<resourcegroupNode>

在其上定义资源组的节点。

父项：

<resourcegroupNodeList>

子项：

无

属性：

必需：

  • nodeRef

    群集节点的名称。

可选：

  • Zone

    区域的名称。

<resourcegroupNodeList>

运行特定资源组的群集节点。

父项：

<resourcegroup>

子项：

必需：

  • <resourcegroupNode>

属性：

无

<resourcegroupResource>

属于特定资源组的群集资源。

父项：

<resourcegroupResourceList>

子项：

无

属性：

必需：

  • resourceRef

    资源的名称。

<resourcegroupResourceList>

在资源组中定义的资源的列表。

父项：

<resourcegroup>

子项：

可选：

  • <resourcegroupResource>

属性：

无

<resourceNode>

在其上定义资源的节点。

父项：

<resourceNodeList>

子项：

必需：

  • <state>

  • <monitoredState>

可选：

  • <propertyList>

属性：

必需：

  • nodeRef

    资源类型的名称

可选：

  • zone

    区域的名称。

<resourcetype>

在群集中可用的群集资源类型。

父项：

<resourcetypeList>

子项：

可选：

  • <resourcetypeRTRFile>

  • <resourcetypeNodeList>

  • <methodList>

  • <parameterList>

  • <propertyList>

属性：

必需：

  • name

    资源类型的名称

<resourcetypeList>

在配置中定义的群集资源类型的根节点。

父项：

<cluster>

子项：

可选：

  • <resourcetype>

属性：

无

<resourcetypeNode>

在其上定义资源类型的节点。

父项：

<resourcetypeNodeList>

子项：

无

属性：

必需：

  • nodeRef

    群集节点的名称。

<resourcetypeNodeList>

存在特定资源类型的群集节点的列表。

父项：

<resourcetype>

子项：

必需：<resourcetypeNodeList> 元素必须包含一个或多个 <resourcetypeNode> 元素，或只包含一个 <allNodes> 元素。

  • <resourcetypeNode>

  • <allNodes>

属性：

无

<resourcetypeRTRFile>

描述特定资源类型的资源类型注册 (resource type registration, RTR) 文件的名称。

父项：

<resourcetype>

子项：

无

属性：

必需：

  • name

    RTR 文件的名称。

<snmphost>

在群集节点上配置的 SNMP 主机和团体。

父项：

<snmphostList>

子项：

无

属性：

必需：

  • community

    SNMP 团体名称。

  • name

    实例名称。

  • nodeRef

    SNMP 主机和团体所在的节点。

<snmphostList>

在某个群集节点上配置的 SNMP 主机和团体的列表。

父项：

cluster>

子项：

可选：

  • <snmphost>

属性：

无

<snmpmib>

位于群集节点上的 SNMP MIB。

父项：

<snmpmibList>

子项：

可选：

  • state

属性：

必需：

  • name

    MIB 名称。

  • nodeRef

    SNMP MIB 所在的节点。

可选：

  • protocol

    MIB 将使用的 SNMP 协议。该属型默认为 SNMPv2。

  • value

    SNMPv3 或 SNMPv2

snmpmibList

位于某个群集节点上的 SNMP MIB 的列表。

父项：

<cluster>

子项：

可选：

  • <snmpmib>

属性：

无

<snmpuser>

在群集节点上配置的 SNMPv3 用户。

父项：

<snmpuserList>

子项：

无

属性：

必需：

  • name

    用户的名称。

  • nodeRef

    SNMPv3 用户所在的节点。

  • auth

    auth 属性可设置为 MD5 或 SHA。

可选：

  • defaultUser

    defaultUser 属性可以设置为 yes 或 no。如果未指定值，该属性默认为任何合适的值，具体取决于节点配置。

  • defaultSecurityLevel

    用户的安全性级别。security 属性可设置为以下值之一：

    • authPriv

    • authNoPriv

    • noAuthNoPriv

<snmpuserList>

在某个群集节点上配置的 SNMPv3 用户的列表。

父项：

<cluster>

子项：

<snmpuser>

属性：

无

<state>

群集配置中各种对象的状态。<state> 元素为通用元素。

父项：

<quorumDevicePath>, <resourceNode>, snmpmib>, telemetryAttribute, <transportAdapter>, <transportCable>, <transportSwitch>

子项：

无

属性：

必需：

  • value

    value 属性可以设置为 enabled 或 disabled。

<telemetrics>

群集监视阈值

父项：

<cluster>

子项：

可选：

  • <telemetryObjectType>

属性：

无

<telemetryAttribute>

您可以监视的系统资源的属性。

父项：

<telemetryObjectType>

子项：

必需：

  • <state>（1 个或多个）

属性：

必需：

  • name

    属性的名称。

<telemetryObjectType>

您可以监视的对象的类型。

父项：

<telemetrics>

子项：

必需：

  • <telemetryAttibute>

属性：

必需：

  • name

    属性的名称。

<transportAdapter>

用于专用群集传输的网络适配器。

父项：

<transportNode>

子项：

可选：

  • <state>

  • <transportType>

  • <propertyList>

属性：

必需：

  • name

    网络适配器的名称。

<transportCable>

用于专用群集传输的网络电缆。电缆不一定表示物理电缆，而可以表示两个 <endpoint> 元素之间的路径。

父项：

<transportCableList>

子项：

必需：

  • <endpoint>

    <transportCable> 元素必须有两个 <endpoint> 元素。每个 endpoint 元素必须描述电缆端点之一。

可选：

  • <state>

    <transportCable> 元素可以有一个 <state> 元素。

属性：

无

<transportCableList>

用于连接两个群集 <endpoint> 元素的网络电缆的列表。

父项：

<clusterTransport>

子项：

可选：

  • <transportCable>

属性：

无

<transportNode>

用于专用群集传输的群集节点之一。为群集的每个节点指定一个 <transportNode> 元素。

父项：

<transportNodeList>

子项：

可选：

  • <nodeRef>

属性：

必需：

  • transportAdapterList

    群集节点的名称。

<transportNodeList>

用于专用群集传输的节点的列表。此节点列表始终包含与群集成员相同的一组节点。

父项：

<clusterTransport>

子项：

可选：

  • <transportNode>

属性：

无

<transportSwitch>

群集传输交换机。

父项：

<transportSwitchList>

子项：

可选：

  • <state>

属性：

必需：

  • name

    传输交换机的名称。

可选：

  • port

    交换机的端口号。

<transportSwitchList>

专用群集传输系统使用的网络交换机的列表。

父项：

<clusterTransport>

子项：

可选：

  • <transportSwitch>

属性：

无

<transportType>

用于 <transportAdapter> 元素的网络传输的类型。

父项：

<transportAdapter>

子项：

可选：

  • <propertyList>

属性：

必需：

  • value

    value 属性可以设置为 dlpi 或 rsm。

文件

/usr/cluster/lib/xml/cluster.dtd

定义 Oracle Solaris Cluster 配置 XML 文件结构的文档类型定义 (document type definition, DTD) 文件。

另请参见

Intro(1CL)、cluster(1CL)

http://www.w3.org/XML/

版权所有 © 2000, 2014, Oracle 和/或其附属公司。 保留所有权利。 法律声明
上一页
下一页