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

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

重要:

指向 vCenter Server Appliance 安装程序的路径、指向 JSON 配置文件的路径以及 JSON 配置文件中的字符串值(包括密码)只能包含 ASCII 字符。扩展 ASCII 字符和非 ASCII 字符不受支持。

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

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

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

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

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

部分

子部分

描述

new.vcsa - 描述要迁移到的目标设备

esxi

仅当要直接在 ESXi 主机上部署设备时才应使用。

包含描述目标 ESXi 主机的配置参数。

注:

您必须填充 esxivc 子部分。

vc

仅当要在 vCenter Server 实例清单上部署设备时才应使用。

包含描述目标 ESXi 主机或 vCenter Server 清单的 DRS 群集的配置参数。

注:

您必须填充 vcesxi 子部分。

appliance

包含描述设备的配置参数。

os

包含描述设备操作系统设置的配置参数。

ovftool.arguments

用于将任意参数及其值添加到安装程序所生成的 OVF Tool 命令的可选子部分。

重要:

vCenter Server Appliance 安装程序不会验证 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、vCenter Single Sign-On 或 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 Single Sign-On 的 vCenter Server AppliancePlatform Services Controller 设备时才需要。

注:

如果设置为 true,则必须使用 --acknowledge-ceip 参数运行 CLI 部署命令。

有关 CEIP 的信息,请参见vCenter Server 和主机管理中的“配置客户体验改善计划”一节。

new.vcsa 部分中的配置参数

表 2. 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。

表 3. new.vcsa 部分的 vc 子部分中的配置参数

名称

类型

描述

hostname

string

要在上面部署设备的目标 vCenter Server 实例的 IP 地址或 FQDN。

username

string

目标 vCenter Server 实例上的 vCenter Single Sign-On 管理员用户名,例如 administrator@vsphere.local。

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"

注:

值区分大小写。

datastore

string

要将设备的所有虚拟机配置文件和虚拟磁盘存储到的数据存储的名称。

注:

该数据存储必须可从目标 ESXi 主机或 DRS 群集进行访问。

该数据存储必须具有至少 15 GB 的可用空间。

port

integer

vCenter Server 的端口号。默认端口为 443。

target

string 或 array

要在其中部署设备的目标 ESXi 主机或 DRS 群集。

重要:

必须提供 vCenter Server 清单中显示的名称。例如,如果目标 ESXi 主机的名称是 vCenter Server 清单中的一个 IP 地址,则不能提供 FQDN。

如果目标 ESXi 主机或 DRS 群集位于文件夹或文件夹结构中,则值必须是逗号分隔的字符串列表或作为单个字符串的逗号分隔列表。例如,

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

注:

值区分大小写。

vm.folder

string

可选。要将设备添加到的虚拟机文件夹的名称。

表 4. new.vcsa 部分的 appliance 子部分中的配置参数

名称

类型

描述

thin.disk.mode

Boolean

设置为 true 可部署具有精简虚拟磁盘的设备。

deployment.option

string

设备的大小。

  • 如果要为最多 10 个主机和 100 个虚拟机(具有默认存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 tiny

    部署具有 2 个 CPU、8 GB 内存和 250 GB 存储的设备。

  • 如果要为最多 10 个主机和 100 个虚拟机(具有大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 tiny-lstorage

    部署具有 2 个 CPU、8 GB 内存和 775 GB 存储的设备。

  • 如果要为最多 10 个主机和 100 个虚拟机(具有超大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 tiny-xlstorage

    部署具有 2 个 CPU、8 GB 内存和 1650 GB 存储的设备。

  • 如果要为最多 100 个主机和 1,000 个虚拟机(具有默认存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 small

    部署具有 4 个 CPU、16 GB 内存和 290 GB 存储的设备。

  • 如果要为最多 100 个主机和 1,000 个虚拟机(具有大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 small-lstorage

    部署具有 4 个 CPU、16 GB 内存和 820 GB 存储的设备。

  • 如果要为最多 100 个主机和 1,000 个虚拟机(具有超大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 small-xlstorage

    部署具有 4 个 CPU、16 GB 内存和 1700 GB 存储的设备。

  • 如果要为最多 400 个主机和 4,000 个虚拟机(具有默认存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 medium

    部署具有 8 个 CPU、24 GB 内存和 425 GB 存储的设备。

  • 如果要为最多 400 个主机和 4,000 个虚拟机(具有大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 medium-lstorage

    部署具有 8 个 CPU、24 GB 内存和 925 GB 存储的设备。

  • 如果要为最多 400 个主机和 4,000 个虚拟机(具有超大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 medium-xlstorage

    部署具有 8 个 CPU、24 GB 内存和 1805 GB 存储的设备。

  • 如果要为最多 1,000 个主机和 10,000 个虚拟机(具有默认存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 large

    部署具有 16 个 CPU、32 GB 内存和 640 GB 存储的设备。

  • 如果要为最多 1,000 个主机和 10,000 个虚拟机(具有大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 large-lstorage

    部署具有 16 个 CPU、32 GB 内存和 990 GB 存储的设备。

  • 如果要为最多 1,000 个主机和 10,000 个虚拟机(具有超大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 large-xlstorage

    部署具有 16 个 CPU、32 GB 内存和 1870 GB 存储的设备。

  • 如果要为最多 2,000 个主机和 35,000 个虚拟机(具有默认存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 xlarge

    部署具有 48 个 CPU、24 GB 内存和 980 GB 存储的设备。

  • 如果要为最多 2,000 个主机和 35,000 个虚拟机(具有大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 xlarge-lstorage

    部署具有 48 个 CPU、24 GB 内存和 1030 GB 存储的设备。

  • 如果要为最多 2,000 个主机和 35,000 个虚拟机(具有超大型存储大小)部署具有嵌入式 Platform Services ControllervCenter Server Appliance,请设置为 xlarge-xlstorage

    部署具有 48 个 CPU、24 GB 内存和 1910 GB 存储的设备。

  • 如果要为最多 10 个主机和 100 个虚拟机(具有默认存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-tiny

    部署具有 2 个 CPU、8 GB 内存和 250 GB 存储的设备。

  • 如果要为最多 10 个主机和 100 个虚拟机(具有大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-tiny-lstorage

    部署具有 2 个 CPU、8 GB 内存和 775 GB 存储的设备。

  • 如果要为最多 10 个主机和 100 个虚拟机(具有超大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-tiny-xlstorage

    部署具有 2 个 CPU、8 GB 内存和 1650 GB 存储的设备。

  • 如果要为最多 100 个主机和 1,000 个虚拟机(具有默认存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-small

    部署具有 4 个 CPU、16 GB 内存和 290 GB 存储的设备。

  • 如果要为最多 100 个主机和 1,000 个虚拟机(具有大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-small-lstorage

    部署具有 4 个 CPU、16 GB 内存和 820 GB 存储的设备。

  • 如果要为最多 100 个主机和 1,000 个虚拟机(具有超大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-small-xlstorage

    部署具有 4 个 CPU、16 GB 内存和 1700 GB 存储的设备。

  • 如果要为最多 400 个主机和 4,000 个虚拟机(具有默认存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-medium

    部署具有 8 个 CPU、24 GB 内存和 425 GB 存储的设备。

  • 如果要为最多 400 个主机和 4,000 个虚拟机(具有大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-medium-lstorage

    部署具有 8 个 CPU、24 GB 内存和 925 GB 存储的设备。

  • 如果要为最多 400 个主机和 4,000 个虚拟机(具有超大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-medium-xlstorage

    部署具有 8 个 CPU、24 GB 内存和 1805 GB 存储的设备。

  • 如果要为最多 1,000 个主机和 10,000 个虚拟机(具有默认存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-large

    部署具有 16 个 CPU、32 GB 内存和 640 GB 存储的设备。

  • 如果要为最多 1,000 个主机和 10,000 个虚拟机(具有大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-large-lstorage

    部署具有 16 个 CPU、32 GB 内存和 990 GB 存储的设备。

  • 如果要为最多 1,000 个主机和 10,000 个虚拟机(具有超大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-large-xlstorage

    部署具有 16 个 CPU、32 GB 内存和 1870 GB 存储的设备。

  • 如果要为最多 2,000 个主机和 35,000 个虚拟机(具有默认存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-xlarge

    部署具有 48 个 CPU、24 GB 内存和 980 GB 存储的设备。

  • 如果要为最多 2,000 个主机和 35,000 个虚拟机(具有大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-xlarge-lstorage

    部署具有 48 个 CPU、24 GB 内存和 1030 GB 存储的设备。

  • 如果要为最多 2,000 个主机和 35,000 个虚拟机(具有超大型存储大小)部署具有外部 Platform Services Controller 部署的 vCenter Server Appliance,请设置为 management-xlarge-xlstorage

    部署具有 48 个 CPU、24 GB 内存和 1910 GB 存储的设备。

  • 如果要部署 Platform Services Controller 设备,请设置为 infrastructure

    部署具有 2 个 CPU、4 GB 内存和 60 GB 存储的设备。

image

string

可选。指向 vCenter Server Appliance 安装包的本地文件路径或 URL。

默认情况下,安装程序使用包含于 ISO 文件中的安装包,该文件位于 vcsa 文件夹中。

name

string

设备的虚拟机名称。

必须仅包含除百分号 (%)、反斜杠 (\) 或正斜杠 (/) 以外的 ASCII 字符,并且长度不能超过 80 个字符。

ovftool.path

string

可选。指向 OVF Tool 可执行文件的本地文件路径。

默认情况下,安装程序使用包含于 ISO 文件中的 OVF Tool 实例,该文件位于 vcsa/ovftool 文件夹中。

表 5. new.vcsa 部分的 os 子部分中的配置参数

名称

类型

描述

password

string

设备操作系统的 root 用户的密码。

该密码必须包含 8 到 20 个字符,至少一个大写字母、一个小写字母、一个数字和一个特殊字符,例如美元符号 ($)、井号 (#)、@ 符号 (@)、句点 (.) 或感叹号 (!)。所有字符必须是没有空格的小写 ASCII 字符。

ssh.enable

Boolean

设置为 true 可在设备上启用 SSH 管理员登录。

表 6. new.vcsa 部分的 temporary.network 子部分中的配置参数

名称

类型

描述

ip.family

string

设备的网络 IP 版本。

请设置为 ipv4ipv6

mode

string

设备的网络 IP 分配。

请设置为 staticdhcp

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 版本,值必须介于 032 之间。

对于 IPv6 版本,值必须介于 0128 之间。

gateway

string

默认网关的 IP 地址。

对于 IPv6 版本,值可以是 default

system.name

string

主网络标识。

可以是 IP 地址或 FQDN,首选是 FQDN。

部署后将无法更改此参数的值。

FQDN 和用点分隔的十进制数字必须符合 RFC 1123 准则。

表 7. new.vcsa 部分的 user-options 子部分中的配置参数

名称

类型

描述

vcdb.migrateSet

string

设置数据迁移选项。可用选项包括 coreallcore_events_tasks。设置为 core 可迁移核心清单和配置数据。设置为 all 可迁移所有 vCenter Server 性能和历史数据,如统计信息、事件、警报和任务。不迁移所有数据可减少整体停机时间量。

自动调用 Migration Assistant 的要求

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

os.usernamevum.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 部分中的配置参数

表 8. source.vc 部分的 vc.win 子部分中的配置参数

名称

类型

描述

hostname

string

要迁移的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 的源 Windows 安装的主机名或 IP 地址。

username

string

对您要迁移的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 实例具有管理特权的 vCenter Single Sign-On 用户名。

password

string

您要迁移的 vCenter Server、vCenter Single Sign-On 或 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 指纹。

表 9. 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 帐户下运行时才需要该选项。如果保留空白或省略它,系统将在模板验证期间提示您在命令控制台中输入它。

表 10. 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 Manager Windows 计算机的 Administrator 用户密码。如果保留空白或省略它,系统将在模板验证期间提示您在命令控制台中输入它。

migration.port

string

显示在 Migration Assistant 控制台中的 Migration Assistant 端口号。默认端口为 9123。

export.dir

string

要将源配置和数据导出到的目录。

ceip 部分中的配置参数

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

名称

类型

描述

ceip.enabled

Boolean

设置为 true 可加入此设备的 CEIP。