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

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

重要说明: 指向 vCenter ServerAppliance 安装程序的路径、指向 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 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 ServerPlatform 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部分中的配置参数

表 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。
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 迁移命令的语法

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

如果数据中心上没有任何文件夹路径,则仅使用数据中心名称。例如,

["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) 文件夹的名称。
表 4. 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 文件夹中。

表 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

表 7. 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 ServerAppliance 传输数据

表 8. new_vcsa部分的 sso 子部分中的配置参数
名称 类型 描述
first_instance string

如果这是您在 vCenter ServerSSO 域中的第一次聚合迁移操作,或者您不希望为此节点设置复制合作伙伴,请将 first_instance 设置为 true

如果要为此节点设置复制合作伙伴,请将 first_instance设置为 false,并将 replication_partner_hostname 的值提供为之前已聚合但当前处于嵌入式 vCenter Server 拓扑中的节点的 FQDN。

有关指定 first_instancereplication_partner_hostname 参数的详细信息,请参见关于使用 CLI 迁移具有外部 Platform Services Controller部署且适用于 Windows 的 vCenter Server

replication_partner_hostname string 复制合作伙伴的主机名。如果是 first_instance则移除

自动调用 Migration Assistant 的要求

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

os_usernamevum_os_username 参数中指定的用户帐户需要将特权提升到管理员级别。例如:
  • 内置 Windows 管理员帐户。
  • 用户名不是管理员(本地 Windows 管理员组成员)的用户帐户。
  • 用户名为管理员(本地 Windows 管理员组成员)的域管理员帐户。
  • 用户名 ID 的格式必须为 your_domain_name\\user_IDuser_ID@your_domain_name
限制: Migration Assistant 自动调用不适用于需要将特权提升为管理员的 Windows 帐户。相反,请在源 Windows 计算机上手动运行 Migration Assistant。从源计算机上的 Migration Assistant 控制台输出中复制指纹值并将其粘贴到 vc_win子部分中的 migration_ssl_thumbprint 键,然后移除 run_migration_assistant 部分。

source_vc部分中的配置参数

表 9. source_vc部分的 vc_win 子部分中的配置参数
名称 类型 描述
hostname string 要迁移的 vCenter ServerPlatform Services Controller 的源 Windows 安装的主机名或 IP 地址。
username string 对您要迁移的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 实例具有管理特权的 vCenter Single Sign-On 用户名。
password string 要迁移的 vCenter ServerPlatform 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 指纹。
表 10. 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 帐户下运行时才需要该选项。如果省略,则在模板验证期间,系统会提示您在命令控制台上输入该密码。
表 11. 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部分中的配置参数

表 12. ceip部分的 settings 子部分中的配置参数
名称 类型 描述
ceip_enabled Boolean 设置为 true可加入此设备的 CEIP。