附录 2:创建节点 XML 文件

节点 XML 文件包含要添加到群集的节点列表。 此列表包括:

  • 从裸机添加节点时,每个节点的硬件标识参数,例如系统管理 BIOS (SMBIOS) GUID 或媒体访问控制 (MAC) 地址。

  • 添加已运行其中一个受支持版本的 Windows 操作系统且已安装 Microsoft HPC Pack 的预配置节点时,计算机名称用于标识。

  • 其他属性,例如每个节点的物理位置和应用于激活操作系统的 Windows 产品密钥。

本部分包括以下主题:

使用节点 XML 文件进行部署的好处

以下列表概述了将节点添加到群集时使用节点 XML 文件的一些优势:

  • 可以通过导入节点 XML 文件以及要添加到群集的所有计算机的列表来预暂存 HPC 群集节点的 PXE 部署。 可以从裸机或预配置节点部署节点。

  • 使用节点 XML 文件添加到 HPC 群集的预配置节点无需手动批准到群集中。 这使得部署过程更高效和简化。

  • 导入节点 XML 文件是一种简单且高效的方法,可用于将属性与节点相关联。 可与节点关联的属性示例包括:位置、Windows 产品密钥、节点模板或用于自动创建节点组的标记。

  • 可以将特定计算机名称(NetBIOS 名称)提供给从裸机部署的节点,而无需担心按特定顺序为其供电。 通过使用节点 XML 文件,计算机名称已与特定的 SMBIOS GUID 或 MAC 地址(或两者)相关联。

重要

作为 HPC 群集中安全性的最佳做法,如果将有关 HPC 群集的信息保存到 XML 文件中,建议跟踪这些文件的位置并防止未经授权的使用。

节点 XML 文件架构

节点 XML 文件基于 XML 架构定义 (XSD) 语言文件:NodeConfigurationFile.xsd。 此 XSD 文件位于 HPC Pack 安装路径的 Bin 文件夹中的头节点上。 例如,如果使用 HPC Pack 2008 R2 的默认安装路径,则此处提供了 XSD 文件:

C:\Program Files\Microsoft HPC Pack 2008 R2\Bin\NodeConfigurationFile.xsd

下表列出了节点 XML 文件架构中定义的属性和元素。

Attribute、Element、或 Element:Attribute 必须 说明
位置 - 可选元素。
- 包含有关节点位置的信息的属性。
Location:Primary - Location 元素的可选属性。
- 指定节点所在的主位置(如数据中心)的名称。
- 取代节点 XML 文件架构中的 Location:DataCenter 属性,该架构已弃用。
Location:Secondary - Location 元素的可选属性。
- 指定节点所在的辅助位置(例如服务器机架的名称或编号)。
- 取代节点 XML 文件架构中 Location:Rack 属性,该架构已弃用。
位置:第三 - Location 元素的可选属性。
- 指定节点所在的第三个位置(如机箱的名称或编号)。
- 取代节点 XML 文件架构中的 Location:Chassis 属性,该架构已弃用。
模板 - 可选元素。
- 从裸机部署节点时,需要此元素。
- 包含包含有关将用于部署节点的节点模板的信息的属性。
Template:Name - 模板 元素的必需属性。
- 仅当包含 模板 元素时,才需要此属性。
- 指定将用于部署节点的节点模板的名称。
- 如果头节点上不存在指定的节点模板名称,则部署将失败。
- 如果要从裸机部署节点,此属性必须指定包含部署操作系统映像的步骤的节点模板的名称,否则部署将失败。
Template:Provisioned - Template 元素的可选属性。
- 指定节点是预配置的节点(Provisioned=“true”,或 Provisioned=“1”),或者指定(Provisioned=“false”,或 Provisioned=“0”)。
- 如果未指定此属性,则节点不被视为预配置的节点,并且节点模板将在节点添加到群集时应用于节点。
- 如果 Provisioned=“true”,或指定 Provisioned=“1”,则节点模板在将节点添加到群集时不会应用于节点,但节点将与该节点模板关联的节点模板导入。
- 如果 Provisioned=“false”,或指定 Provisioned=“0”,则节点模板将在节点添加到群集时应用于节点。
- 如果要从裸机部署节点,则必须 Provisioned=“false”Provisioned=“0”,或不能指定此属性。 此外,节点模板必须包含部署操作系统映像的步骤。
MacAddress - 可选元素。
- 指定节点将使用的网络适配器的 MAC 地址。
- 如果要从裸机部署节点,则必须指定此元素或 MachineGuid 参数,否则部署将失败。 如果系统中的群集节点具有不唯一的 SMBIOS GUID(即节点 XML 文件中的两个或更多个节点具有与 MachineGuid 参数相同的值),则还必须指定此元素。
- 如果节点使用多个适配器,则此元素可以有多个实例。
- 确保仅指定节点中存在的这些 MAC 地址。 指定节点中不存在的 MAC 地址可能会导致该节点的导入失败。 注意:
  • 在节点 XML 文件中指定 MAC 地址时,不包括任何空格、冒号(:)、连字符(-)或点(.)。 仅包含 MAC 地址的十二进制数字。 例如,正确指定了以下 MAC 地址:00301B445F02
  • 默认情况下,HPC Pack 需要 6 字节(12 个十六进制数字)MAC 地址。 从 HPC Pack 2008 R2 SP2 开始,还可以为某些网络适配器(如 InfiniBand 网络中使用的适配器)指定 8 字节客户端标识符。 为此,请在头节点上配置 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HPC下的注册表设置。 配置名为 TrimLongMACAddresses的 DWORD,并将数据设置为 1(1)。 警告: 错误编辑注册表可能会严重损坏系统。 在对注册表进行更改之前,应备份计算机上的任何值数据。
标记 - 可选元素。
- 指定在部署期间应向其添加节点的节点组的名称。
- 如果节点应添加到多个节点组,则此元素可以有多个实例。
名称 - 必需属性。
- 指定节点的计算机名称(NetBIOS 名称)。
- 如果要从裸机部署节点,此属性指定将在部署期间分配给节点的计算机名称。
- 如果要部署预配置节点,此属性指定节点的当前计算机名称。
- 如果指定的名称是已添加到群集的预配置节点(即,它不在 未知 状态),则节点 XML 文件将无法导入。
Domain - 可选属性。
- 指定应向其添加节点的 Active Directory 域。
- 如果未指定此属性,则使用头节点的 Active Directory 域。
ManagementIpAddress - 可选属性。
- 指定集成脚本化电源控制工具(如智能平台管理接口(IPMI)脚本所需的信息。
- 仅当使用脚本化电源控制工具管理群集上的电源时,才需要指定此属性。
MachineGuid - 可选属性。
- 指定部署节点的计算机的 SMBIOS GUID。
- 如果要从裸机部署节点,则必须指定此参数或 MacAddress 元素,否则节点 XML 文件将无法导入。
ProductKey - 可选属性。
- 指定将用于在节点上激活操作系统的 Windows 产品密钥。
- 产品密钥在节点模板的激活任务期间使用,其中包括部署操作系统映像的步骤。
- 指定的产品密钥必须与节点模板使用的映像中的操作系统版本匹配。 重要提示: 如果使用零售版本或受支持的 Windows Server 操作系统评估版创建的操作系统映像,则必须指定 Windows 产品密钥。
InitiatorIqn - 可选属性。
- 如果未使用 DHPC 或使用 IQN 模板字符串为 iSCSI 限定名称(IQN)分配 iSCSI 启动节点,则指定节点的 IQN。
ClientIqnDhcpOption - 可选属性。
- 如果使用 DHCP 将动态分配 iSCSI 限定名称(IQN)到 iSCSI 启动节点,请指定用于预留的 DHCP 选项的 ID。 DHCP 选项 ID 是一个整数。

创建用于从裸机部署的节点 XML 文件

节点 XML 文件可以在任何 XML 编辑器或文本编辑器中创建,但它必须遵循节点 XML 文件架构。 此外,可以通过从 HPC 群集管理器导出节点 XML 文件,从已配置的 HPC 群集创建节点 XML 文件。

注意

有关详细信息,请参阅 创建节点 XML 文件的内容。

从裸机为部署创建节点 XML 文件时,需要为每个节点提供硬件标识参数。 此参数可以是计算机的 SMBIOS GUID 或 MAC 地址。

创建节点 XML 文件以便从裸机进行部署时:

  • 在该节点的 MacAddress 属性中指定节点的 MAC 地址。

  • 在该节点的 MachineGuid 属性中指定节点的 SMBIOS GUID。

  • 如果同时指定了节点的 SMBIOS GUID 和 MAC 地址,则使用 SMBIOS GUID。

  • 如果出于某种原因,你无权访问节点的 SMBIOS GUID,则只能使用 MAC 地址。

  • 确保仅指定每个节点中存在的这些 MAC 地址。 指定计算节点中不存在的 MAC 地址可能会导致该节点的导入失败。

  • 必须为列出的每个节点指定节点模板,并且该节点模板必须包含部署操作系统映像的步骤。 如果未指定节点模板,或者指定不包含部署操作系统映像的步骤的节点模板,则部署将失败。

  • 确保节点 XML 文件中指定的节点模板名称与头节点上列出的节点模板的名称匹配。

  • 指定要附加到节点的任何位置信息。

  • 如果希望在部署过程中自动将节点添加到特定节点组,请使用每个计算节点的节点组的名称指定 标记 属性。

  • 如果使用使用零售版本创建的操作系统映像或受支持的 Windows Server 操作系统的评估版本,则必须包含 Windows 产品密钥。

  • 如果脚本化电源控制工具的集成需要每个节点的 BMC IP 地址,则可以将其添加到节点 XML 文件中。

示例节点 XML 文件

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>  
<Nodes xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns="https://schemas.microsoft.com/HpcNodeConfigurationFile/2007/12">  
  <Node  
    Name="ComputeNodeName1"  
    Domain="CONTOSO"  
    MachineGuid="{4c4c4544-0038-5710-804b-c6c04f464331}">  
    <Location  
      Primary="Data Center 1"  
      Secondary="2"  
      Tertiary="1" />  
    <Template  
      Name="Default ComputeNode Template" Provisioned="true" />  
    <MacAddress>00301B445F02</MacAddress>  
    <MacAddress>001B2104EDF5</MacAddress>  
    <Tag>ComputeNodes</Tag>  
    <Tag>Rack2</Tag>  
  </Node>    
  </Nodes>