使用 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 - 描述源 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 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。 |
名称 | 类型 | 描述 |
---|---|---|
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 数据中心。
如果数据中心位于文件夹或文件夹结构中,则值必须是逗号分隔的字符串列表或作为单个字符串的逗号分隔列表。例如,
或
注: 值区分大小写。
|
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 群集位于文件夹或文件夹结构中,则值必须是逗号分隔的字符串列表或作为单个字符串的逗号分隔列表。例如,
或
如果目标
ESXi 主机属于群集的一部分,请使用逗号分隔的字符串列表或作为单个字符串的逗号分隔列表来提供路径。例如,
或
注: 值区分大小写。
|
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 服务器,请使用逗号分隔的字符串列表或作为单个字符串的逗号分隔列表来提供路径。例如,
或
仅当使用静态分配(也就是将 |
prefix |
string | 网络前缀长度。 仅当使用分配(也就是将 对于 IPv4 版本,值必须介于 对于 IPv6 版本,值必须介于 |
gateway |
string | 默认网关的 IP 地址。 对于 IPv6 版本,值可以是 |
system.name |
string | 主网络标识。 可以是 IP 地址或 FQDN,首选是 FQDN。 部署后将无法更改此参数的值。 FQDN 和用点分隔的十进制数字必须符合 RFC 1123 准则。 |
名称 | 类型 | 描述 |
---|---|---|
vcdb.migrateSet |
string | 设置数据迁移选项。可用选项包括 core 、all 和 core_events_tasks 。设置为 core 可迁移核心清单和配置数据。设置为 all 可迁移所有 vCenter Server 性能和历史数据,如统计信息、事件、警报和任务。不迁移所有数据可减少整体停机时间量。 |
自动调用 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、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 指纹。 |
名称 | 类型 | 描述 |
---|---|---|
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 帐户下运行时才需要该选项。如果保留空白或省略它,系统将在模板验证期间提示您在命令控制台中输入它。 |
名称 | 类型 | 描述 |
---|---|---|
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
部分中的配置参数
名称 | 类型 | 描述 |
---|---|---|
ceip.enabled |
Boolean | 设置为 true 可加入此设备的 CEIP。 |