使用 CLI 将 vCenter Server 安装从 Windows 迁移到设备

可以使用 CLI 安装程序自动将 vCenter Server 或 Platform Services Controller 从 Windows 迁移到设备。

安装程序 ISO 文件包含 JSON 文件的示例模板，其中包含将 vCenter Server 或 Platform Services Controller 实例从 Windows 迁移到设备所需的最少配置参数。示例模板位于 vcsa-cli-installer/templates/migrate 目录中。

注： 迁移具有外部 Platform Services Controller 的 vCenter Server 部署之前，必须先将外部 Platform Services Controller 融合为嵌入式 Platform Services Controller，然后再执行迁移。请参见知识库文章 68137。

将 vCenter Server 安装从 Windows 迁移到设备的 CLI 任务：

1. 下载并挂载 vCenter Server 安装程序。
2. 下载 VMware Migration Assistant 并在源 Windows 计算机上运行。
3. 为 CLI 迁移准备 JSON 配置文件。
4. 在执行迁移前运行预检查。
5. 使用 CLI 将 vCenter Server 从 Windows 迁移到设备。

可以使用不同的 JSON 文件多次运行 CLI 安装程序，以便执行多次 CLI 迁移，或者可以在批量模式下并行运行这些 CLI 迁移。

重要说明： 用来登录到要从中运行 CLI 安装程序的计算机的用户名、 vCenter Server Appliance 安装程序的路径、JSON 配置文件的路径和 JSON 配置文件中的字符串值（包括密码）必须仅包含 ASCII 字符。扩展 ASCII 字符和非 ASCII 字符不受支持。

为 CLI 迁移准备 JSON 配置文件

使用 CLI 将源 vCenter Server 安装迁移到目标 vCenter Server Appliance 时，必须为新设备准备具有配置值的 JSON 模板。

通过将值设置为在安装程序 ISO 文件中提供的模板中的配置参数，可以将 vCenter Server 或 Platform Services Controller 实例从 Windows 迁移到 vCenter Server Appliance。未包括在模板中的配置参数将设置为其默认值。可以在模板中添加配置参数以设置适合迁移规范的值。

vcsa-cli-installer/templates/migrate 目录包含示例迁移模板，这些模板可用于通过 CLI 将 vCenter Server 6.7 迁移到设备。

有关配置参数及其描述的完整列表，请导航到操作系统的安装程序子目录并运行 vcsa-deploy migrate --template-help 命令。

重要说明： 用来登录到要从中运行 CLI 安装程序的计算机的用户名、 vCenter Server Appliance 安装程序的路径、JSON 配置文件的路径和 JSON 配置文件中的字符串值（包括密码）必须仅包含 ASCII 字符。扩展 ASCII 字符和非 ASCII 字符不受支持。

要执行批量迁移，请将定义部署的 JSON 模板放在单个目录中。调用 CLI 安装程序时，它会使用 JSON 模板中定义的拓扑将现有部署迁移到新的 vCenter Server 版本。

前提条件

验证您的环境是否满足迁移要求。请参见 将 vCenter Server 部署迁移到 vCenter Server Appliance 部署的系统要求。

为迁移准备环境。请参见准备迁移。

过程

1. 打开 vcsa-cli-installer/templates 目录中的 migrate 子文件夹。
2. 将 migrate 子文件夹中的迁移模板复制到工作区。对于 vCenter Server 6.7，使用 migrate/winvc6.7/ 文件夹。
3. 在文本编辑器中打开适用于您的用例的模板文件。
   为确保 JSON 配置文件的语法正确无误，请使用 JSON 编辑器。
4. 为必需的配置参数填充值，也可以输入其他参数及其值。
   重要说明： 要设置包含反斜杠 (\) 或引号 (") 字符的值，必须在该字符之前附加反斜杠 (\) 字符。例如， "password":"my\"password" 可设置密码 my"password， "image":"C:\\vmware\\vcsa" 可设置路径 C:\vmware\vcsa。

   布尔值必须仅包含小写字符。可以是 true 或 false。例如，"ssh_enable":false

5. 以 UTF-8 格式保存并关闭文件。

结果

您的文件可以用于迁移了。

下一步做什么

您可以创建并保存特定环境所需数量的模板。模板就绪后，先运行预检查，再使用它运行迁移。请参见在对 vCenter Server Appliance执行 CLI 迁移之前运行预检查。

用于对适用于 Windows 的 vCenter Server 执行 CLI 迁移的 JSON 模板

vCenter Server 安装程序包含一些 JSON 模板，这些模板位于 vcsa-cli-installer/templates 目录中。在 migrate 子文件夹中，您可以找到 JSON 模板，这些模板包含所有迁移类型的最少配置参数。

表 1. vCenter Server 安装程序中包含的迁移 JSON 模板

位置	模板	描述
vcsa-cli-installer\templates\migrate\vcsa\winvc6.7	embedded_win_vc_to_embedded_vCSA_on_ESXi.json	包含将 Windows 上具有嵌入式 Platform Services Controller 的 vCenter Server 6.7 迁移到 ESXi 主机上的 8.0 vCenter Server Appliance 所需的最少配置参数。
	embedded_win_vc_to_embedded_vCSA_on_VC.json	包含将 Windows 上具有嵌入式 Platform Services Controller 的 vCenter Server 6.7 迁移到 vCenter Server 实例上的 8.0 vCenter Server Appliance 所需的最少配置参数。
	win_vc_to_vCSA_on_ESXi.json	包含将 Windows 上具有外部 Platform Services Controller 的 vCenter Server 6.7 迁移到 ESXi 主机上的 8.0 vCenter Server Appliance 所需的最少配置参数。
	win_vc_to_vCSA_on_VC.json.json	包含将 Windows 上具有外部 Platform Services Controller 的 vCenter Server 6.7 迁移到 vCenter Server 实例上的 8.0 vCenter Server Appliance 所需的最少配置参数。

关于使用 CLI 迁移具有外部 Platform Services Controller 部署且适用于 Windows 的 vCenter Server

迁移使用外部 Platform Services Controller 且适用于 Windows 的 vCenter Server 时，会将其转换为具有嵌入在设备中的这些服务部署的 vCenter Server 实例。因此，必须在 JSON 迁移模板中指定复制合作伙伴参数。

迁移使用外部 Platform Services Controller 且适用于 Windows 的 vCenter Server 时，必须在 JSON 迁移模板中指定复制合作伙伴参数。这些参数指示迁移是否适用于以下 vCenter Server 和 Platform Services Controller 迁移方案之一。

• SSO 域中的单个 vCenter Server 和单个 Platform Services Controller 实例。
• 包含多个 vCenter Server 的 SSO 域中的第一个 vCenter Server 和 Platform Services Controller 实例。
• 复制 SSO 域中的 vCenter Server 和 Platform Services Controller 实例，并且必须将这些实例指向作为复制合作伙伴的现有 vCenter Server 7.0 实例。

重要说明： 迁移使用外部 Platform Services Controller 的 vCenter Server 部署之前，必须先将外部 Platform Services Controller 融合为嵌入式 Platform Services Controller，然后再执行迁移。有关详细信息，请参见 移除 Platform Services Controller。

使用外部 Platform Services Controller 的部署通常称为 MxN 部署，其中 M 表示 vCenter Server，N 表示外部 Platform Services Controller。在表示域中的多个 vCenter Server 和 Platform Services Controller 实例时，此部署表示为 MnxNn，其中 n 是实例的数量。例如，M2xN2 表示同一域中的两个 vCenter Server 实例和两个 Platform Services Controller 实例。迁移此类部署时，首先要将一个实例迁移到版本 8.0，然后将第二个实例迁移到 8.0，并将两个实例中的第一个实例指定为复制合作伙伴。

JSON 迁移模板中的复制参数为 first_instance 和 replication_partner_hostname，位于模板的 sso 部分中。

参数名	描述
first_instance	first_instance 参数将 vCenter Server 标识为 vCenter Server SSO 域中的第一个实例，或者将其标识为复制合作伙伴。 如果它是第一个 vCenter Server 实例，请将 first_instance 设置为 true。对于同一 SSO 域中 vCenter Server 的其他实例，将 first_instance 设置为 false。
replication_partner_hostname*	如果将 first_instance 设置为 false，则必须指定已迁移到版本 8.0 并且外部 PSC 已融合到 vCenter Server Appliance 中的 vCenter Server 的 FQDN 或 IP 地址。

对使用外部 Platform Services Controller 且适用于 Windows 的单个 vCenter Server 实例执行 CLI 迁移时，该过程如下所示：

1. 在 ESXi 上迁移时使用 win_vc_to_vCSA_on_ESXi.json 模板，或者在 vCenter Server 部署上迁移时使用 win_vc_to_vCSA_on_VC.json 模板，迁移拓扑中的 vCenter Server。

2. 对于包含单个 vCenter Server 和 Platform Services Controller（ M1xN1 部署）的部署拓扑，请编辑模板的 sso 部分，以便将 first_instance 参数设置为 true，并移除 replication_partner_hostname 参数。

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. 在 JSON 模板中指定其余配置参数，并使用 CLI 将 vCenter Server 迁移到版本 8.0。请参见使用 CLI 将 vCenter Server 从 Windows 迁移到设备。
4. 成功迁移 vCenter Server 后，取消配置 Platform Services Controller。请参见取消配置 Platform Services Controller。
   重要说明： 仅在迁移和融合拓扑中的所有 vCenter Server 实例后，才取消配置 Platform Services Controller 实例。

对于包含两个或更多 vCenter Server 和 Platform Services Controller 实例的部署（ M2xN2 部署），首先将 M1 vCenter Server 实例迁移到版本 8.0，然后迁移第二个实例，以复制 vCenter Server 实例。

1. 在 ESXi 上迁移时使用 win_vc_to_vCSA_on_ESXi.json 模板，或者在 vCenter Server 部署上迁移时使用 win_vc_to_vCSA_on_VC.json 模板，迁移拓扑中的 vCenter Server。

2. 对于第一个 vCenter Server 实例 ( M1)，编辑模板的 sso 部分，以便将 first_instance 参数设置为 true，并移除 replication_partner_hostname 参数。

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. 对于其余 vCenter Server 实例 ( M2)，编辑模板的 sso 部分，以便将 first_instance 参数设置为 false，并提供要将第二个节点复制到的 vCenter Server 实例的 FQDN 或 IP 地址。复制合作伙伴是您迁移到版本 8.0 的第一个 vCenter Server 实例 ( M1)，该实例已与其 Platform Services Controller 实例融合。

   "sso": {
   "__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
   "first_instance": false,
   "replication_partner_hostname": "FQDN_or_IP_address"

4. 在 JSON 模板中指定其余配置参数，并使用 CLI 将 vCenter Server 迁移到版本 8.0。请参见使用 CLI 将 vCenter Server 从 Windows 迁移到设备。
5. 成功迁移拓扑中的所有 vCenter Server 实例后，取消配置 Platform Services Controller 实例。请参见取消配置 Platform Services Controller。
   重要说明： 仅在迁移和融合拓扑中的所有 vCenter Server 实例后，才取消配置 Platform Services Controller 实例。

迁移配置参数

使用 CLI 安装程序将 vCenter Server安装迁移到设备时，必须提供迁移规范参数的值。

下表列出了用于为源 vCenter Server提供输入数据的配置参数。

重要说明： 指向 vCenter ServerAppliance 安装程序的路径、指向 JSON 配置文件的路径以及 JSON 配置文件中的字符串值（包括密码）必须仅包含 ASCII 字符。扩展 ASCII 字符和非 ASCII 字符不受支持。

要设置包含反斜杠 (\) 或引号 (") 字符的值，必须在该字符之前附加反斜杠 (\) 字符。例如，"password":"my\"password"可设置密码 my"password，"image":"C:\\vmware\\vcsa" 可设置路径 C:\vmware\vcsa。

布尔值必须仅包含小写字符。可以是 true或false。例如，"ssh_enable":false。

JSON 迁移模板中的配置参数的部分和子部分

JSON 迁移模板中的配置参数按部分和子部分进行组织。

表 2. JSON 迁移模板中的配置参数的部分和子部分

部分	子部分	描述
new_vcsa- 描述要迁移到的目标设备	esxi	仅当要直接在 ESXi主机上部署设备时才应使用。 包含描述目标 ESXi主机的配置参数。 注： 您必须填充 esxi或 vc 子部分。
	vc	仅当要在 vCenter Server实例清单上部署设备时才应使用。 包含描述目标 ESXi主机或 vCenter Server 清单的 DRS 集群的配置参数。 注： 您必须填充 vc或 esxi 子部分。
	appliance	包含描述设备的配置参数。
	os	包含描述设备操作系统设置的配置参数。
	ovftool_arguments	用于将任意参数及其值添加到安装程序所生成的 OVF Tool 命令的可选子部分。 重要说明： vCenter ServerAppliance 安装程序不验证 ovftool_arguments 子部分中的配置参数。如果设置了 OVF Tool 无法识别的参数，部署可能会失败。
	temporary_network	包含描述将数据从源迁移到新目标设备的临时网络的配置参数。
	user-options	仅当源是 vCenter Server 实例时使用。包含用于控制特定组件的迁移过程各个方面的配置参数。
source_vc- 描述源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller	vc_win	包含描述 vCenter Server或 Platform Services Controller 的源 Windows 安装的配置参数
	run_migration_assistant	仅当源 Windows 安装作为虚拟机运行并且您要自动调用 Migration Assistant 时使用。对于在物理机上运行的源 Windows 安装，或者如果要在源 Windows 计算机上手动运行 Migration Assistant，可从源计算机上的 Migration Assistant 控制台输出中复制指纹值并将其粘贴到 vc_win子部分中的 migration_ssl_thumbprint 键，并移除 run_migration_assistant 部分。
ceip- 描述是否加入 VMware 客户体验提升计划 (Customer Experience Improvement Program, CEIP)	settings	仅包含 ceip_enabled配置参数，用来设置是否加入 VMware 客户体验提升计划 (CEIP)。 仅当部署 vCenter Server设备时才需要。 注： 如果设置为 true，则必须使用 --acknowledge-ceip 参数运行 CLI 部署命令。 有关 CEIP 的信息，请参见《vCenter Server 和主机管理》中的“配置客户体验提升计划”一节。

new_vcsa部分中的配置参数

表 3. new_vcsa部分的 esxi 子部分中的配置参数

名称	类型	描述
hostname	string	要在上面部署设备的目标 ESXi主机的 IP 地址或 FQDN。
username	string	对目标 ESXi主机具有管理特权的用户名，例如 root。
password	string	对目标 ESXi主机具有管理特权的用户的密码。
deployment_network	string	要将设备连接到的网络的名称。 注： 该网络必须可从目标 ESXi主机进行访问。 如果目标 ESXi主机仅具有一个网络，则忽略此参数。
datastore	string	要将设备的所有虚拟机配置文件和虚拟磁盘存储到的数据存储的名称。 注： 该数据存储必须可从 ESXi主机进行访问。 而且，必须具有足够的可用空间。
port	integer	ESXi主机的端口号。默认端口为 443。
ssl_certificate_verification	string	CLI 将验证服务器的安全证书是否由证书颁发机构 (Certificate Authority, CA) 签名，并建立安全连接。如果证书是自签名证书，则 CLI 会停止升级，除非您指定以下 SSL 证书配置选项之一。 指定安全哈希算法 1 (Secure Hash Algorithm 1, SHA-1) 证书指纹。证书指纹是一个十六进制字符串，用于唯一地标识证书。指纹使用指纹算法根据证书的内容计算而得。 "thumbprint": "certificate SHA-1 thumbprint" 将 verification_mode设置为 NONE。 "verification_mode": "NONE" 如果您使用自签名证书连接到服务器，并且未指定 SHA-1 证书指纹或者未将验证模式设置为 NONE，则 CLI 会显示服务器的自签名证书指纹并提示您接受或拒绝该证书指纹。 您还可以使用 vcsa-deploy upgrade命令参数--no-ssl-certificate-validation 指定让 CLI 忽略自签名证书。请参见CLI 迁移命令的语法。

表 4. new_vcsa部分的 vc 子部分中的配置参数

名称	类型	描述
hostname	string	要在上面部署设备的目标 vCenter Server实例的 IP 地址或 FQDN。
username	string	目标 vCenter Server实例上的 vCenter Single Sign-On 管理员用户名，例如 [email protected]。
password	string	目标 vCenter Server实例上的 vCenter Single Sign-On 管理员用户的密码。
deployment_network	string	要将设备连接到的网络的名称。 注： 必须可从要在其中部署设备的目标 ESXi主机或 DRS 集群访问该网络。 如果目标 ESXi主机或 DRS 集群只有一个网络，则忽略此参数。
datacenter	string 或 array	包含要在其中部署设备的目标 ESXi主机或 DRS 集群的 vCenter Server 数据中心。 如果数据中心位于文件夹或文件夹结构中，则值必须是逗号分隔的字符串列表或作为单个字符串的逗号分隔列表。例如， ["parent_folder", "child_folder", "datacenter_name"] 或 "parent_folder, child_folder, datacenter_name" 如果数据中心上没有任何文件夹路径，则仅使用数据中心名称。例如， ["datacenter_name"] 或 "datacenter_name" 注： 值区分大小写。
datastore	string	要将设备的所有虚拟机配置文件和虚拟磁盘存储到的数据存储的名称。 注： 该数据存储必须可从目标 ESXi主机或 DRS 集群进行访问。 该数据存储必须具有至少 25 GB 的可用空间。
port	integer	vCenter Server的端口号。默认端口为 443。
target	string 或 array	要在其中部署新设备的目标集群、ESXi主机或资源池。这是您使用datacenter参数指定的目标。该路径必须以集群名称、ESXi 主机名或资源池名称结尾。 重要说明： 必须提供 vCenter Server清单中显示的名称。例如，如果目标 ESXi主机的名称是 vCenter Server 清单中的一个 IP 地址，则不能提供 FQDN。 注： 所有值均区分大小写。 如果要在数据中心层次结构中的不同位置列出已部署的设备，请使用本部分稍后描述的 vm_folder参数。 如果目标集群、 ESXi主机或资源池位于文件夹或文件夹结构中，则值必须是逗号分隔的字符串列表或作为单个字符串的逗号分隔列表。例如， ["parent_folder", "child_folder", "esxi-host.domain.com"] 或 "parent_folder, child_folder, esxi-host.domain.com" 如果目标 ESXi主机属于集群的一部分，请使用逗号分隔的字符串列表或作为单个字符串的逗号分隔列表来提供路径。例如， ["cluster_name", "esxi-host.domain.com"] 或 "cluster_name, esxi-host.domain.com" 如果要部署到资源池，请在资源池名称前面添加Resources。例如： ["cluster_name", "Resources", "resource_pool_name"] 注： 预检查只会验证资源池的内存。
vm_folder	string	可选。要将设备添加到的虚拟机 (VM) 文件夹的名称。

表 5. new_vcsa部分的 appliance 子部分中的配置参数

名称	类型	描述
thin_disk_mode	Boolean	设置为 true可部署具有精简虚拟磁盘的设备。
deployment_option	string	设备的大小。 如果要为具有默认存储大小的最多 10 个主机和 100 个虚拟机部署 vCenter ServerAppliance，请设置为 tiny。 部署具有 2 个 CPU、10 GB 内存和 300 GB 存储的设备。 如果要为具有大型存储大小的最多 10 个主机和 100 个虚拟机部署 vCenter ServerAppliance，请设置为 tiny-lstorage。 部署具有 2 个 CPU、10 GB 内存和 825 GB 存储的设备。 如果要为具有超大型存储大小的最多 10 个主机和 100 个虚拟机部署 vCenter ServerAppliance，请设置为 tiny-xlstorage。 部署具有 2 个 CPU、10 GB 内存和 1700 GB 存储的设备。 如果要为具有默认存储大小的最多 100 个主机和 1,000 个虚拟机部署 vCenter ServerAppliance，请设置为 small。 部署具有 4 个 CPU、16 GB 内存和 340 GB 存储的设备。 如果要为具有大型存储大小的最多 100 个主机和 1,000 个虚拟机部署 vCenter ServerAppliance，请设置为 small-lstorage。 部署具有 4 个 CPU、16 GB 内存和 870 GB 存储的设备。 如果要为具有超大型存储大小的最多 100 个主机和 1,000 个虚拟机部署 vCenter ServerAppliance，请设置为 small-xlstorage。 部署具有 4 个 CPU、16 GB 内存和 1750 GB 存储的设备。 如果要为具有默认存储大小的最多 400 个主机和 4,000 个虚拟机部署 vCenter ServerAppliance，请设置为 medium。 部署具有 8 个 CPU、24 GB 内存和 525 GB 存储的设备。 如果要为具有大型存储大小的最多 400 个主机和 4,000 个虚拟机部署 vCenter ServerAppliance，请设置为 medium-lstorage。 部署具有 8 个 CPU、24 GB 内存和 1025 GB 存储的设备。 如果要为具有超大型存储大小的最多 400 个主机和 4,000 个虚拟机部署 vCenter ServerAppliance，请设置为 medium-xlstorage。 部署具有 8 个 CPU、24 GB 内存和 1905 GB 存储的设备。 如果要为具有默认存储大小的最多 1,000 个主机和 10,000 个虚拟机部署 vCenter ServerAppliance，请设置为 large。 部署具有 16 个 CPU、32 GB 内存和 740 GB 存储的设备。 如果要为具有大型存储大小的最多 1,000 个主机和 10,000 个虚拟机部署 vCenter ServerAppliance，请设置为 large-lstorage。 部署具有 16 个 CPU、32 GB 内存和 1090 GB 存储的设备。 如果要为具有超大型存储大小的最多 1,000 个主机和 10,000 个虚拟机部署 vCenter ServerAppliance，请设置为 large-xlstorage。 部署具有 16 个 CPU、32 GB 内存和 1970 GB 存储的设备。 如果要为具有默认存储大小的最多 2,000 个主机和 35,000 个虚拟机部署 vCenter ServerAppliance，请设置为 xlarge。 部署具有 24 个 CPU、48 GB 内存和 1180 GB 存储的设备。 如果要为具有大型存储大小的最多 2,000 个主机和 35,000 个虚拟机部署 vCenter ServerAppliance，请设置为 xlarge-lstorage。 部署具有 24 个 CPU、48 GB 内存和 1230 GB 存储的设备。 如果要为具有超大型存储大小的最多 2,000 个主机和 35,000 个虚拟机部署 vCenter ServerAppliance，请设置为 xlarge-xlstorage。 部署具有 24 个 CPU、48 GB 内存和 2110 GB 存储的设备。
image	string	可选。指向 vCenter ServerAppliance 安装包的本地文件路径或 URL。 默认情况下，安装程序使用包含于 ISO 文件中的安装包，该文件位于 vcsa 文件夹中。
name	string	设备的虚拟机名称。 必须仅包含除百分号 (%)、反斜杠 (\) 或正斜杠 (/) 以外的 ASCII 字符，并且长度不能超过 80 个字符。
ovftool_path	string	可选。指向 OVF Tool 可执行文件的本地文件路径。 默认情况下，安装程序使用包含于 ISO 文件中的 OVF Tool 实例，该文件位于 vcsa/ovftool 文件夹中。

表 6. new_vcsa部分的 os 子部分中的配置参数

名称	类型	描述
password	string	设备操作系统的 root 用户的密码。 该密码必须包含 8 到 20 个字符，至少一个大写字母、一个小写字母、一个数字和一个特殊字符，例如美元符号 ($)、井号 (#)、@ 符号 (@)、句点 (.) 或感叹号 (!)。所有字符必须是没有空格的小写 ASCII 字符。
ssh_enable	Boolean	设置为 true可在设备上启用 SSH 管理员登录。

表 7. new_vcsa部分的 temporary_network 子部分中的配置参数

名称	类型	描述
ip_family	string	设备的网络 IP 版本。 请设置为 ipv4或 ipv6。
mode	string	设备的网络 IP 分配。 请设置为 static或 dhcp。
ip	string	设备的 IP 地址。 仅当使用静态分配（也就是将 mode参数设置为 static）时才需要。 必须设置与网络 IP 版本对应的 IPv4 或 IPv6 地址，也就是设置为 ip_family参数的值。 IPv4 地址必须符合 RFC 790 准则。 IPv6 地址必须符合 RFC 2373 准则。
dns_servers	string 或 array	一个或多个 DNS 服务器的 IP 地址。 要设置多个 DNS 服务器，请使用逗号分隔的字符串列表或作为单个字符串的逗号分隔列表来提供路径。例如， ["x.y.z.a", "x.y.z.b"] 或 "x.y.z.a, x.y.z.b" 仅当使用静态分配（也就是将 mode参数设置为 static）时才需要。
prefix	string	网络前缀长度。 仅当使用分配（也就是将 mode参数设置为 static）时才需要。 对于 IPv4 版本，值必须介于 0到 32 之间。 对于 IPv6 版本，值必须介于 0到 128 之间。
gateway	string	默认网关的 IP 地址。 对于 IPv6 版本，值可以是 default。

表 8. new_vcsa部分的 user_options 子部分中的配置参数

名称	类型	描述
vcdb_migrateSet	string	选择要从旧设备迁移到新设备的数据类型。数据会从源vCenter Server复制到目标服务器。原始数据源保持不变。 如果只想传输配置数据，请设置为core。此选项可提供速度最快的数据迁移，从而最大限度缩短系统停机时间。 如果要立即传输配置数据和历史数据（事件和任务），请设置为core_events_tasks。从适用于 Windows 的源 vCenter Server迁移所有数据之前，vCenter Server 不会启动。 如果要立即传输配置数据、历史数据和性能衡量指标数据，请设置为all。从适用于 Windows 的源 vCenter Server迁移所有数据之前，vCenter Server 不会启动。此选项可传输的数据量最大，但所需的停机时间比其他数据迁移选项更长。 如果要在升级完成后在后台传输历史数据（事件和任务），请设置为transfer_events_tasks_after_upgrade。在此期间，vCenter Server性能可能不是最佳。 如果要在升级完成后在后台传输历史数据和性能衡量指标数据，请设置为transfer_stats_events_tasks_after_upgrade。在此期间，vCenter Server性能可能不是最佳。 注： 要最大限度缩短迁移时间并将新 vCenter ServerAppliance 所需的存储量减至最少，请使用 core 值。 有关可从现有 vCenter Server迁移到升级后的新 vCenter Server 的数据类型的详细信息，请参见从现有 vCenter Server Appliance 传输数据。

表 9. new_vcsa部分的 sso 子部分中的配置参数

名称	类型	描述
first_instance	string	如果这是您在 vCenter ServerSSO 域中的第一次聚合迁移操作，或者您不希望为此节点设置复制合作伙伴，请将 first_instance 设置为 true。 如果要为此节点设置复制合作伙伴，请将 first_instance设置为 false，并将 replication_partner_hostname 的值提供为之前已聚合但当前处于嵌入式 vCenter Server 拓扑中的节点的 FQDN。 有关指定 first_instance和 replication_partner_hostname 参数的详细信息，请参见关于使用 CLI 迁移具有外部 Platform Services Controller 部署且适用于 Windows 的 vCenter Server。
replication_partner_hostname	string	复制合作伙伴的主机名。如果是 first_instance则移除

自动调用 Migration Assistant 的要求

可使用run_migration_assistant子部分自动调用 Migration Assistant。仅当源 Windows 安装作为虚拟机运行时自动调用才起作用。

在 os_username或 vum_os_username 参数中指定的用户帐户需要将特权提升到管理员级别。例如：

• 内置 Windows 管理员帐户。
• 用户名不是管理员（本地 Windows 管理员组成员）的用户帐户。
• 用户名为管理员（本地 Windows 管理员组成员）的域管理员帐户。
• 用户名 ID 的格式必须为 your_domain_name\\user_ID 或 user_ID@your_domain_name。

限制： Migration Assistant 自动调用不适用于需要将特权提升为管理员的 Windows 帐户。相反，请在源 Windows 计算机上手动运行 Migration Assistant。从源计算机上的 Migration Assistant 控制台输出中复制指纹值并将其粘贴到 vc_win子部分中的 migration_ssl_thumbprint 键，然后移除 run_migration_assistant 部分。

source_vc部分中的配置参数

表 10. source_vc部分的 vc_win 子部分中的配置参数

名称	类型	描述
hostname	string	要迁移的 vCenter Server或 Platform Services Controller 的源 Windows 安装的主机名或 IP 地址。
username	string	对您要迁移的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 实例具有管理特权的 vCenter Single Sign-On 用户名。
password	string	要迁移的 vCenter Server或 Platform Services Controller 实例的密码。
migration_port	string	显示在 Migration Assistant 控制台中的 Migration Assistant 端口号。默认端口为 9123。
active_directory_domain	string	源 vCenter Server实例加入其中的 Active Directory 域的名称。
active_directory_username	string	源 vCenter Server实例加入其中的 Active Directory 域的管理员用户名。
active_directory_password	string	源 vCenter Server实例加入其中的 Active Directory 域的管理员密码。 注： 安装程序将验证所输入的凭据，但不会检查将目标计算机添加到 Active Directory 域的所需特权。确认用户凭据具有将计算机添加到 Active Directory 域的所有所需的权限。
migration_ssl_thumbprint	string	Migration Assistant 的 SSL 指纹。

表 11. source_vc部分的 run_migration_assistant 子部分中的配置参数

名称	类型	描述
esxi_hostname	string	源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 实例驻留在其中的 ESXi 的 FQDN 或 IP 地址。
esxi_username	string	在 ESXi主机上具有管理特权的用户的用户名。
esxi_password	string	ESXi主机用户的密码。如果省略，则在模板验证期间，系统会提示您在命令控制台上输入该密码。
esxi_port	string	ESXi主机的端口号。默认端口为 443。
os_username	string	源 Windows 计算机的 Administrator 用户名。
os_password	string	源 Windows 计算机的 Administrator 用户密码。如果省略，则在模板验证期间，系统会提示您在命令控制台上输入该密码。
migration_ip	string	要迁移的网络适配器的 IP 地址。
migration_port	string	显示在 Migration Assistant 控制台中的 Migration Assistant 端口号。默认端口为 9123。
export_dir	string	要将源配置和数据导出到的目录。
sa_password	string	网络vCenter Server服务帐户用户密码的 IP 地址。仅当vCenter Server服务在非 LocalSystem 帐户下运行时才需要该选项。如果省略，则在模板验证期间，系统会提示您在命令控制台上输入该密码。

表 12. source_vum部分的 run_migration_assistant 子部分中的配置参数

名称	类型	描述
esxi_hostname	string	源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 实例驻留在其中的 ESXi 的 FQDN 或 IP 地址。
esxi_username	string	在 ESXi主机上具有管理特权的用户的用户名。
esxi_password	string	ESXi主机用户的密码。如果省略，则在模板验证期间，系统会提示您在命令控制台上输入该密码。
esxi_port	string	ESXi主机的端口号。默认端口为 443。
vum_hostname	string	源 Update Manager实例驻留在其中的 ESXi 的 FQDN 或 IP 地址。
vum_os_username	string	源 Windows 计算机的 Administrator 用户名。
vum_os_password	string	源Update ManagerWindows 计算机的 Administrator 用户密码。如果省略，则在模板验证期间，系统会提示您在命令控制台上输入该密码。
migration_port	string	显示在 Migration Assistant 控制台中的 Migration Assistant 端口号。默认端口为 9123。
export_dir	string	要将源配置和数据导出到的目录。

ceip部分中的配置参数

表 13. ceip部分的 settings 子部分中的配置参数

名称	类型	描述
ceip_enabled	Boolean	设置为 true可加入此设备的 CEIP。

在对 vCenter Server Appliance执行 CLI 迁移之前运行预检查

在迁移 vCenter Server部署之前，您可以运行预检查以确认满足迁移要求并解决任何存在的问题。

将 vCenter Server部署迁移到设备之前，可以运行预检查以了解磁盘空间要求、预计升级时间和向vCenter Server Appliance 注册的扩展。运行预升级是可选操作，但是强烈建议在计划升级时执行该步骤。

前提条件

为 CLI 迁移准备 JSON 配置文件使用示例模板和配置参数。

过程

1. 通过使用以下命令对模板进行验证，而无需部署设备：vcsa-deploy migrate --verify-template-only path_to_json_file。
2. 使用 --precheck-only选项运行 CLI Migrate。
   您可以根据磁盘空间要求和预计迁移时间调整您的迁移计划。如果收到错误，可以进行故障排除并解决问题，然后再执行实际迁移。
3. 解决任何错误后，再次使用 --verify-template-only选项运行 CLI Migrate 命令，直至解决所有错误。

结果

现在，您已准备就绪，可以执行无错误的 CLI 迁移过程。

下一步做什么

使用 CLI 将 vCenter Server 从 Windows 迁移到设备。

使用 CLI 将 vCenter Server 从 Windows 迁移到设备

您可以将 vCenter Server 从 vSphere 网络中的计算机迁移到设备。

前提条件

• 请参见迁移 vCenter Server 的必备条件
• 创建要迁移的部署的快照，以防止在迁移过程中发生故障。
• 从 VMware 网站将安装程序 ISO 文件下载到 vSphere 网络中的计算机。安装程序 ISO 文件名为 VMware-VCSA-all-8.0.0-yyyyyy.iso，其中 yyyyyy 是内部版本号。请参见下载并挂载 vCenter Server 安装程序。
• 为 CLI 迁移准备 JSON 配置文件。
• 参见在对 vCenter Server Appliance执行 CLI 迁移之前运行预检查，以确定问题并细化迁移计划。
• 检查用于运行迁移的可选参数。请参见CLI 迁移命令的语法。

过程

1. 导航到操作系统的软件 CLI 安装程序目录。
   • 如果要从运行 Windows 操作系统的计算机部署设备，请导航到 vcsa-cli-installer\win32 目录。
   • 如果要从运行 Linux 操作系统的计算机部署设备，请导航到 vcsa-cli-installer/lin64 目录。
   • 如果要从运行 Mac OS 的计算机部署设备，请导航到 vcsa-cli-installer/mac 目录。
2. 选择 CLI 安装程序：vcsa-deploy.exe。
3. 运行迁移命令。

   vcsa-deploy migrate --accept-eula optional_arguments path_to_the_json_file

   optional_arguments 变量是用于设置额外配置的可选参数列表，用空格分隔。
   例如，您可以设置安装程序所生成的日志文件和其他输出文件的位置。

   vcsa-deploy migrate --accept-eula --log-dir=path_to_the_location path_to_the_json_file

结果

迁移模板已部署。您可以验证 vCenter Server 升级或迁移是否成功。

CLI 迁移命令的语法

可以使用一个或多个命令实参来设置迁移命令的执行形参。

可以向 CLI 升级命令添加用空格分隔的参数列表。

vcsa-deploy migrate list_of_arguments path_to_the_json_file

所需的 template参数提供了描述vCenter Server Appliance 部署过程的 JSON 文件的路径。可将多个 JSON 文件放置在一个目录中，CLI 将以批处理模式迁移所有部署。有关执行并行迁移的更多信息，请参见为 CLI 迁移准备 JSON 配置文件。

重要说明： String 值（包括密码）必须仅包含 ASCII 字符。扩展 ASCII 字符和非 ASCII 字符不受支持。

要设置包含反斜杠 (\) 或引号 (") 字符的值，必须在该字符之前附加反斜杠 (\) 字符。例如，"password":"my\"password"可设置密码 my"password，"image":"C:\\vmware\\vcsa" 可设置路径 C:\vmware\vcsa。

布尔值必须仅包含小写字符。可以是 true或false。例如，"ssh.enable":false。

可选参数	描述
--accept-eula	接受最终用户许可协议。 此参数对执行部署命令是必需的。
-h, --help	显示命令的帮助消息。
--template-help	显示有关 JSON 部署文件中的配置参数的帮助消息。可以对子命令特定参数的列表使用 vcsa-deploy [subcommand] --help。
-v, --verbose	将调试信息添加到控制台输出。
-t, --terse	隐藏控制台输出。仅显示警告消息和错误消息。
--log-dir, LOG_DIR	指定安装程序生成的日志文件和其他输出文件的位置。
--skip-ovftool-verification	对配置参数执行基本验证并部署 vCenter Server Appliance，但不验证 JSON 模板的ovftool_arguments子部分中的 OVF Tool 参数。如果设置了 OVF Tool 无法识别的参数，部署可能会失败。
--no-ssl-certificate-verification	禁止对 ESXi 连接执行 SSL 验证。 CLI 将验证服务器的安全证书是否由证书颁发机构 (Certificate Authority, CA) 签名，并建立安全连接。如果证书是自签名的，则 CLI 会停止升级，除非您使用 --no-ssl-certificate-validation命令参数指定让 CLI 忽略自签名证书。 如果您使用自签名证书连接到服务器，并且未指定让 CLI 接受该证书，则 CLI 会显示服务器的自签名证书指纹并提示您接受或拒绝该证书指纹。 也可以在 JSON 模板中使用ssl_certificate_verification配置参数来指定让 CLI 忽略自签名证书。请参见vCenter Server Appliance 的 CLI 升级的升级配置参数。 重要说明： 请避免使用此选项，因为此选项可能会导致升级期间或升级后由于目标主机的标识未经过验证而出现问题。
--operation-id	可让您提供标识符，用于跟踪多个 vCenter Server 实例的并行安装、并行迁移或并行升级。如果未提供操作 ID，则 CLI 会生成通用唯一标识符 (Universally Unique Identifier, UUID)，您可以使用生成的标识符来标识不同的 vCenter Server 实例及其安装状态或升级状态。
--verify-template-only	执行基本模板验证，但不安装 Upgrade Runner，不运行预检查，也不升级或迁移 vCenter ServerAppliance。
--precheck-only	在源 vCenter Server 虚拟机上安装 Migration Assistant 并运行全套预检查，但不执行迁移。
--acknowledge-ceip	确认您要加入 VMware 客户体验提升计划 (CEIP)。如果在升级模板中将 ceip.enabled 设置为 true，则需要此参数。

退出代码	描述
0	命令已成功运行
1	运行时错误
2	验证错误
3	模板错误