使用 CLI 安装程序将 vCenter Server 安装迁移到设备时,必须提供迁移规范参数的值。
下表列出了用于为源 vCenter Server 提供输入数据的配置参数。
要设置包含反斜杠 (\) 或引号 (") 字符的值,必须在该字符之前附加反斜杠 (\) 字符。例如,"password":"my\"password"
可设置密码 my"password,"image":"C:\\vmware\\vcsa"
可设置路径 C:\vmware\vcsa。
布尔值必须仅包含小写字符。可以是 true
或 false
。例如,"ssh_enable":false
。
JSON 迁移模板中的配置参数的部分和子部分
JSON 迁移模板中的配置参数按部分和子部分进行组织。
部分 | 子部分 | 描述 |
---|---|---|
new_vcsa - 描述要迁移到的目标设备 |
esxi |
仅当要直接在 ESXi 主机上部署设备时才应使用。
包含描述目标
ESXi 主机的配置参数。
注: 您必须填充
esxi 或
vc 子部分。
|
vc |
仅当要在 vCenter Server 实例清单上部署设备时才应使用。 包含描述目标 ESXi 主机或 vCenter Server 清单的 DRS 集群的配置参数。
注: 您必须填充
vc 或
esxi 子部分。
|
|
appliance |
包含描述设备的配置参数。 | |
os |
包含描述设备操作系统设置的配置参数。 | |
ovftool_arguments |
用于将任意参数及其值添加到安装程序所生成的 OVF Tool 命令的可选子部分。
重要事项:
vCenter Server Appliance 安装程序不会验证
ovftool_arguments 子部分中的配置参数。如果设置了 OVF Tool 无法识别的参数,部署可能会失败。
|
|
temporary_network |
包含描述将数据从源迁移到新目标设备的临时网络的配置参数。 | |
user-options |
仅当源是 vCenter Server 实例时使用。包含用于控制特定组件的迁移过程各个方面的配置参数。 | |
source_vc - 描述源 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)。 仅当要部署具有嵌入式 Platform Services Controller 部署的 vCenter Server Appliance 或 Platform Services Controller 设备时才需要。
注: 如果设置为
true ,则必须使用
--acknowledge-ceip 参数运行 CLI 部署命令。
有关 CEIP 的信息,请参见《vCenter Server 和主机管理》中的“配置客户体验提升计划”一节。 |
new_vcsa
部分中的配置参数
名称 | 类型 | 描述 |
---|---|---|
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" 如果您使用自签名证书连接到服务器,并且未指定 SHA-1 证书指纹或者未将验证模式设置为 您还可以使用 vcsa-deploy upgrade 命令参数 |
名称 | 类型 | 描述 |
---|---|---|
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 主机或资源池。这是您使用
重要事项: 必须提供
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 | 可选。要将设备添加到的虚拟机文件夹的名称。 |
名称 | 类型 | 描述 |
---|---|---|
thin_disk_mode |
Boolean | 设置为 true 可部署具有精简虚拟磁盘的设备。 |
deployment_option |
string | 设备的大小。
|
image |
string | 可选。指向 vCenter Server Appliance 安装包的本地文件路径或 URL。 默认情况下,安装程序使用包含于 ISO 文件中的安装包,该文件位于 vcsa 文件夹中。 |
name |
string | 设备的虚拟机名称。 必须仅包含除百分号 (%)、反斜杠 (\) 或正斜杠 (/) 以外的 ASCII 字符,并且长度不能超过 80 个字符。 |
ovftool_path |
string | 可选。指向 OVF Tool 可执行文件的本地文件路径。 默认情况下,安装程序使用包含于 ISO 文件中的 OVF Tool 实例,该文件位于 vcsa/ovftool 文件夹中。 |
名称 | 类型 | 描述 |
---|---|---|
password |
string | 设备操作系统的 root 用户的密码。 该密码必须包含 8 到 20 个字符,至少一个大写字母、一个小写字母、一个数字和一个特殊字符,例如美元符号 ($)、井号 (#)、@ 符号 (@)、句点 (.) 或感叹号 (!)。所有字符必须是没有空格的小写 ASCII 字符。 |
ssh_enable |
Boolean | 设置为 true 可在设备上启用 SSH 管理员登录。 |
名称 | 类型 | 描述 |
---|---|---|
ip_family |
string | 设备的网络 IP 版本。 请设置为 |
mode |
string | 设备的网络 IP 分配。 请设置为 |
ip |
string | 设备的 IP 地址。 仅当使用静态分配(也就是将 必须设置与网络 IP 版本对应的 IPv4 或 IPv6 地址,也就是设置为 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" 仅当使用静态分配(也就是将 |
prefix |
string | 网络前缀长度。 仅当使用分配(也就是将 对于 IPv4 版本,值必须介于 对于 IPv6 版本,值必须介于 |
gateway |
string | 默认网关的 IP 地址。 对于 IPv6 版本,值可以是 |
名称 | 类型 | 描述 |
---|---|---|
vcdb_migrateSet |
string | 选择要从旧设备迁移到新设备的数据类型。数据会从源 vCenter Server 复制到目标服务器。原始数据源将保持不变。
注: 要最大限度缩短迁移时间并将新 vCenter Server Appliance 所需的存储量减至最少,请使用值
core 。
有关可从现有 vCenter Server 迁移到升级后的新 vCenter Server 的数据类型的详细信息,请参见从现有 vCenter Server Appliance 传输数据。 |
自动调用 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。
vc_win
子部分中的
migration_ssl_thumbprint
键,并移除
run_migration_assistant
部分。
source_vc
部分中的配置参数
名称 | 类型 | 描述 |
---|---|---|
hostname |
string | 要迁移的 vCenter Server 或 Platform Services Controller 的源 Windows 安装的主机名或 IP 地址。 |
username |
string | 对要迁移的 vCenter Server 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 指纹。 |
名称 | 类型 | 描述 |
---|---|---|
esxi_hostname |
string | 源 vCenter Server 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 帐户下运行时才需要该选项。如果保留空白或省略它,系统将在模板验证期间提示您在命令控制台中输入它。 |
名称 | 类型 | 描述 |
---|---|---|
esxi_hostname |
string | 源 vCenter Server 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
部分中的配置参数
名称 | 类型 | 描述 |
---|---|---|
ceip_enabled |
Boolean | 设置为 true 可加入此设备的 CEIP。 |