API Guide
Identifier GUID-95CA07A2-2BCB-4EA2-84EF-EF9D11A4FA0E
Version 5
Status Translation approved
零接触部署
通过零接触部署 (ZTD)，OS10 用户可以自动执行交换机部署：
• 升级现有的 OS10 映像。
• 执行 CLI 批处理文件以配置交换机。
• 执行 ZTD 后脚本以执行其他功能。
当您第一次使用出厂安装的 OS10 或从 ONIE 引导菜单执行 ONIE: OS Install 时，ZTD 默认已启用。当 OS10 在 ZTD 模式下启动
交换机时，将在所有接口上启动 DHCP 客户端 — 管理和前面板端口。ZTD 将为未标记的 VLAN 流量配置所有接口。交换机从网络上
运行的 DHCP 服务器获取 IP 地址和 ZTD 调配脚本 URL，以及下载并执行 ZTD 脚本。
注: 零接触部署是指 OS10 功能，而不是 ONIE 自动调配。
• ZTD 仅在 IPv4 网络中受支持。DHCPv6 不支持 ZTD。
• 如果 PowerEdge MX 以太网交换机在 SmartFabric 模式下运行，则不支持 ZTD。
• 如果交换机使用前面板端口访问 DHCP 服务器，则端口接口必须处于非分解模式。
• 连接到运行 DHCP 服务器的网络的前面板端口中至少有一个必须处于非分解模式。
• 在 ZTD 模式中引导后，如果交换机不会在五分钟内收到带有选项 240 的 DHCP 服务器响应，它会自动退出 ZTD 模式。在这段时
间内，您可以通过输入 ztd cancel 命令来中止 ZTD。命令可解锁交换机配置，以便您可以输入 OS10 CLI 命令。
• 启用 ZTD 后，系统将锁定命令行接口，因此您无法输入 OS10 配置命令。只有 show 命令可用。
根据调配脚本的内容，ZTD 将按以下顺序执行这些任务。虽然步骤 2、3 和 4 是可选的，但您必须为至少一个 IMG_FILE、
CLI_CONFIG_FILE 和 POST_SCRIPT_FILE 变量中的至少一个输入有效的 URL 路径。例如，如果您只想配置交换机，请仅输入
CLI_CONFIG_FILE URL 值。在这种情况下，ZTD 不会升级 OS10 映像，并且不会执行 ZTD 后脚本。
1. ZTD 将下载 ZTD 调配脚本中指定的文件 — OS10 映像、CLI 配置批处理文件和 ZTD 后脚本。
• 在调配脚本中，输入 IMG_FILE、 CLI_CONFIG_FILE 和 POST_SCRIPT_FILE 变量的文件名，如 ZTD 调配脚本中所示。
• 如果未指定文件名，OS10 会立即退出 ZTD 并返回 CLI 配置模式。
• 如果任何指定文件的下载失败，ZTD 将停止。OS10 将退出 ZTD 并解锁 CLI 配置模式。
2. 如果为 IMG_FILE 指定了 OS10 映像，ZTD 会将软件映像安装到待机分区中。如果未针对 CLI_CONFIG_FILE 指定配置文件，
则 ZTD 将使用新的 OS10 映像重新加载交换机。
3. 如果您使用 CLI_CONFIG_FILE 的配置命令指定 OS10 CLI 批处理文件，则 ZTD 将执行 PRE-CONFIG 和 POST-CONFIG 部分中
的命令。执行 PRE-CONFIG 命令后，交换机将重新加载新的 OS10 映像，然后执行 POST-CONFIG 命令。有关详细信息，请参
阅 ZTD CLI 批处理文件。
4. 如果为 POST_SCRIPT_FILE 指定 ZTD 后脚本文件，则 ZTD 将执行脚本。有关详情，请参阅 ZTD 后脚本。
注: ZTD 进程将执行单个交换机重新引导。只有在安装了新的 OS10 映像或执行了 CLI 批处理文件的 PRE-CONFIG 部分的配置
命令时，交换机才会重新引导。
ZTD 前提条件
• 将 ZTD 调配脚本存储在支持 HTTP 连接的服务器上。
• 将 OS10 映像、CLI 批处理文件和 ZTD 后脚本存储在支持 HTTP、FTP、SFTP 或 TFTP 连接的文件服务器上。
• 配置 DHCP 服务器提供选项 240，以返回 ZTD 调配脚本的 URL。
• 在 ZTD 调配脚本中，输入 OS10 映像、CLI 批处理文件和/或 ZTD 后脚本的 URL 位置。至少输入一个 URL，否则 ZTD 会失败并退
出 CLI 配置模式。
ZTD 准则
• 您可以在同一台服务器上存储 ZTD 调配脚本、OS10 映像、CLI 批处理文件和 ZTD 后脚本，包括 DHCP 服务器。
• 在 bash 中写入 ZTD 调配脚本。
• 在 bash 或 Python 中写入 ZTD 后脚本。在脚本第一行输入 #!/bin/bash 或 #!/usr/bin/python。OS10 中的默认 python 解
释器为 2.7。
5
零接触部署
99