當您為 CLI 升級準備 JSON 組態檔時,必須設定參數和值,來為 vCenter Server AppliancePlatform Services Controller 應用裝置的升級提供輸入資料。

JSON 升級檔案中組態參數的區段和子區段

用於 CLI 升級的 JSON 組態檔中的組態參數在區段和子區段中進行組織整理。

表 1. JSON 升級檔案中組態參數的區段和子區段
區段 子區段 說明
new.vcsa - 描述您要部署的新應用裝置 esxi

僅當您要在 ESXi 主機上直接部署新的應用裝置時才使用。

包含描述目標 ESXi 主機的組態參數。請參閱 new.vcsa 區段 esxi 子區段中的組態參數
備註: 必須填寫此子區段或 vc 子區段。
vc

僅當您要在 vCenter Server 執行個體的詳細目錄上部署新的應用裝置時才使用。

包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。請參閱 new.vcsa 區段 vc 子區段中的組態參數

備註: 必須填寫此子區段或 esxi 子區段。

目標 vCenter Server 執行個體不能是您要升級的 vCenter Server Appliance。這種情況下,請使用 esxi 子區段。

appliance 包含描述新應用裝置的組態參數。請參閱 new.vcsa 區段 appliance 子區段中的組態參數
os 僅包含用來將 SSH 管理員登入設定至新應用裝置的 ssh.enable 組態參數。請參閱 new.vcsa 區段 os 子區段中的組態參數
ovftool.arguments 選擇性。使用此子區段來將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。
重要: vCenter Server Appliance 安裝程式未驗證 ovftool.arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。
sso

僅包含用來為新應用裝置設定 vCenter Single Sign-On 站台的 site-name 組態參數。請參閱 new.vcsa 區段 sso 子區段中的組態參數

僅當您升級含內嵌式Platform Services ControllervCenter Server Appliance 5.5 時需要。

temporary.network 包含描述適用於新應用裝置的臨時網路設定的組態參數。請參閱 new.vcsa 區段 temporary.network 子區段中的組態參數
user-options 僅包含用來設定您要將其從舊應用裝置傳輸至新應用裝置的資料類型的 vcdb.migrateSet 組態參數。請參閱 new.vcsa 區段 user-options 子區段中的組態參數
source.vc - 描述您要升級的現有應用裝置 esxi 包含描述您要升級之應用裝置所在的來源 ESXi 主機的組態參數。請參閱 source.vc 區段 esxi 子區段中的組態參數
vc.vcsa 包含描述您要升級的來源應用裝置的組態參數。請參閱 source.vc 區段 vc.vcsa 子區段中的組態參數
source.vum - 描述來源 VMware Update Manager 執行個體

想要在 VMware Update Manager 執行個體上自動執行 Migration Assistant 時使用。

run.migration.assistant

如果您要升級的來源 vCenter Server Appliance 已連線到執行於 Windows 虛擬機器的 VMware Update Manager 執行個體,則為選擇性。如果您要在來源 VMware Update Manager 執行個體上自動執行 Migration Assistant,則使用此子區段。

包含描述來源 VMware Update Manager 執行個體的組態參數,該參數將移轉至新的已升級的 vCenter Server Appliance。請參閱 source.vum 區段 run.migration.assistant 子區段中的組態參數

備註: 依預設, Migration Assistant 使用連接埠 9123。如果連接埠 9123 已被 Update Manager 機器上的其他服務使用, Migration Assistant 會自動尋找其他可用的連接埠。您無法設定 Migration Assistant 的自訂連接埠。
ceip - 描述加入 VMware 客戶經驗改進計劃 (CEIP) settings

僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 ceip.enabled 組態參數。請參閱 ceip 區段 settings 子區段中的組態參數

僅在升級含內嵌式 Platform Services ControllervCenter Server Appliance、含內嵌式 vCenter Single Sign-On 的 vCenter Server Appliance 5.5 或 Platform Services Controller 應用裝置時需要。

備註: 如果 ceip.enabled 組態參數設定為 true,則必須執行帶有 --acknowledge-ceip 引數的 CLI 部署命令。

如需有關 CEIP 的資訊,請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。

重要: 字串值 (包括密碼) 必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

若要設定包含反斜線 (\) 或引號 (") 字元的值,您必須在字元前面加上反斜線 (\) 字元。例如,"password":"my\"password" 可設定密碼 my”password;"image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.5.0.XXXX-YYYYYYY_OVF10.ova" 可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-6.5.0.XXXX-YYYYYYY_OVF10.ova

布林值必須只包含小寫字元。可以是 truefalse。例如,"ssh.enable":false

new.vcsa 區段中的組態參數

表 2. new.vcsa 區段 esxi 子區段中的組態參數
名稱 類型 說明
hostname string 您要在其上部署新應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。
username string 在目標 ESXi 主機上具有管理權限的使用者名稱,例如 root。
password string 在目標 ESXi 主機上具有管理權限的使用者的密碼。
deployment.network string

將新應用裝置連線到的網路的名稱。

網路必須屬於目標 ESXi 主機網路組態的一部分。

備註: 該網路必須可從要升級的應用裝置所在的來源 ESXi 主機進行存取。該網路還必須可從其中執行升級的用戶端機器存取。

如果目標 ESXi 主機只有一個網路,則忽略。

datastore string

您要儲存虛擬機器組態檔和新應用裝置的虛擬磁碟之資料存放區的名稱。

資料存放區必須可供目標 ESXi 主機使用。

備註: 資料存放區必須有至少 25 GB 的可用空間。
port 整數

目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

表 3. 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 主機進行存取。該網路還必須可從其中執行升級的用戶端機器存取。

如果目標 ESXi 主機或 DRS 叢集只有一個網路,則忽略。

datacenter 字串或陣列

包含您要在其上部署新應用裝置的目標 ESXi 主機或 DRS 叢集的 vCenter Server 資料中心。

如果資料中心位於資料夾或資料夾結構中,則值必須是以逗點分隔的多個字串的清單,或是以逗點分隔的作為單個字串的清單。例如,
["parent_folder", "child_folder", "datacenter_name"]
"parent_folder, child_folder, datacenter_name"
備註: 值不區分大小寫。
datastore string

您要儲存所有虛擬機器組態檔和新應用裝置的虛擬磁碟之資料存放區的名稱。

備註: 資料存放區必須可供目標 ESXi 主機或 DRS 叢集使用。

資料存放區必須有至少 25 GB 的可用空間。

port 整數

目標 vCenter Server 執行個體的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 vCenter Server 執行個體使用自訂 HTTPS 反向 Proxy 連接埠時使用。

target 字串或陣列

您要在其上部署新應用裝置的目標 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 新應用裝置的大小。
備註: 必須考慮要升級之應用裝置的資料庫大小。對於外部資料庫,請參閱 決定新應用裝置的 Oracle 資料庫大小和儲存區大小
  • 如果您要為具有預設儲存大小的最多 10 台主機和 100 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 tiny

    部署具有 2 個 CPU、10 GB 記憶體和 250 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 tiny-lstorage

    部署具有 2 個 CPU、10 GB 記憶體和 775 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 tiny-xlstorage

    部署具有 2 個 CPU、10 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

    部署具有 24 個 CPU、48 GB 記憶體和 980 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 xlarge-lstorage

    部署具有 24 個 CPU、48 GB 記憶體和 1030 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 xlarge-xlstorage

    部署具有 24 個 CPU、48 GB 記憶體和 1910 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-tiny

    部署具有 2 個 CPU、10 GB 記憶體和 250 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-tiny-lstorage

    部署具有 2 個 CPU、10 GB 記憶體和 775 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-tiny-xlstorage

    部署具有 2 個 CPU、10 GB 記憶體和 1650 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-small

    部署具有 4 個 CPU、16 GB 記憶體和 290 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-small-lstorage

    部署具有 4 個 CPU、16 GB 記憶體和 820 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-small-xlstorage

    部署具有 4 個 CPU、16 GB 記憶體和 1700 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-medium

    部署具有 8 個 CPU、24 GB 記憶體和 425 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-medium-lstorage

    部署具有 8 個 CPU、24 GB 記憶體和 925 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-medium-xlstorage

    部署具有 8 個 CPU、24 GB 記憶體和 1805 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-large

    部署具有 16 個 CPU、32 GB 記憶體和 640 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-large-lstorage

    部署具有 16 個 CPU、32 GB 記憶體和 990 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-large-xlstorage

    部署具有 16 個 CPU、32 GB 記憶體和 1870 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-xlarge

    部署具有 24 個 CPU、48 GB 記憶體和 980 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-xlarge-lstorage

    部署具有 24 個 CPU、48 GB 記憶體和 1030 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-xlarge-xlstorage

    部署具有 24 個 CPU、48 GB 記憶體和 1910 GB 儲存區的應用裝置。

  • 如果您想要部署 Platform Services Controller 應用裝置,則設定為 infrastructure

    部署具有 2 個 CPU、4 GB 記憶體和 60 GB 儲存區的應用裝置。

image string

選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 URL。

依預設,安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。

name string

新應用裝置的虛擬機器名稱。

除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外,必須只包含 ASCII 字元,並且長度不得超過 80 個字元。

ovftool.path string

選擇性。OVF 工具可執行檔的本機檔案路徑。

依預設,安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。

表 5. new.vcsa 區段 os 子區段中的組態參數
名稱 類型 說明
ssh.enable Boolean 設定為 true,以便 SSH 管理員登入新應用裝置。
表 6. new.vcsa 區段 sso 子區段中的組態參數
名稱 類型 說明
site-name string

新應用裝置的 vCenter Single Sign-On 站台名稱。

僅在升級含內嵌式 vCenter Single Sign-On 的 vCenter Server Appliance 5.5 時需要

表 7. new.vcsa 區段 temporary.network 子區段中的組態參數
名稱 類型 說明
ip.family string

新應用裝置的臨時網路的 IP 版本。

設定為 ipv4ipv6

mode string

新應用裝置的臨時網路的 IP 指派。

設定為 staticdhcp

ip string

新應用裝置的臨時 IP 位址。

僅當您使用靜態指派,也就是將 mode 參數設定為 static 時需要。

您必須設定與臨時網路 IP 版本,也就是與 ip.family 參數的值對應的 IPv4 或 IPv6 位址。

IPv4 位址必須符合 RFC 790 準則。

IPv6 位址必須符合 RFC 2373 準則。

dns.servers 字串或陣列

新應用裝置的臨時網路的一或多個 DNS 伺服器的 IP 位址。

若要設定多個 DNS 伺服器,請使用以逗點分隔的多個字串的清單或是以逗點分隔的作為單個字串的清單來提供路徑。例如,
["x.y.z.a", "x.y.z.b"]
"x.y.z.a, x.y.z.b"

僅當您使用臨時 IP 位址配置的靜態網路模式,也就是將 mode 參數設定為 static 時需要。

prefix string

新應用裝置的臨時網路的網路首碼長度。

僅當 mode 參數設定為 static 時使用。僅當 mode 參數設定為 dhcp 時移除。

網路首碼長度是子網路遮罩中設定的位元數。例如,如果子網路遮罩是 255.255.255.0,則二進位版本的首碼長度中包含 24 個位元,因此網路首碼長度為 24。

對於 IPv4 版本,值必須在 032 之間。

對於 IPv6 版本,值必須在 0128 之間。

gateway string

新應用裝置的臨時網路的預設閘道的 IP 位址。

對於 IPv6 版本,值可以為 default

system.name string

新應用裝置的臨時網路的主要網路身分識別。

可以是 IP 位址或 FQDN,最好是 FQDN。

FQDN 和以點分隔的十進位數必須符合 RFC 1123 準則。

表 8. new.vcsa 區段 user-options 子區段中的組態參數
名稱 類型 說明
vcdb.migrateSet string 要從舊應用裝置傳輸至新應用裝置的資料的類型。
  • 如果您只要傳輸組態資料,則設定為 core
  • 如果您要傳輸組態、事件、工作和效能度量資料,則設定為 all
  • 如果您要傳輸組態、事件和工作資料,則設定為 core_events_tasks
備註: 為確保新應用裝置的最短升級時間和最低儲存區需求,請使用 core 值。

source.vc 區段中的組態參數

表 9. source.vc 區段 esxi 子區段中的組態參數
名稱 類型 說明
hostname string 要升級的應用裝置所在的來源 ESXi 主機的 IP 位址或 FQDN。
username string 在來源 ESXi 主機上具有管理權限的使用者名稱,例如 root。
password string 在來源 ESXi 主機上具有管理權限的使用者的密碼。
port 整數

來源 ESXi 主機的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當來源ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

表 10. source.vc 區段 vc.vcsa 子區段中的組態參數
名稱 類型 說明
hostname string 要升級的來源應用裝置的 IP 位址或 FQDN。
username string 來源應用裝置上的 vCenter Single Sign-On 管理員使用者,例如,[email protected]
重要: 使用者必須為 administrator@ your_domain_name
password string 來源應用裝置上 vCenter Single Sign-On 管理員使用者的密碼。
root.password string 來源應用裝置的作業系統的根使用者的密碼。

source.vum 區段中的組態參數

表 11. source.vum 區段 run.migration.assistant 子區段中的組態參數
名稱 類型 說明
esxi.hostname string

來源 VMware Update Manager 執行個體所在的 ESXi 主機的 IP 位址或 FQDN。

如果已提供 FQDN,則它必須可以透過您用來執行升級的用戶端機器進行解析。

esxi.username string ESXi 主機上具有管理權限的使用者名稱,例如 root。
esxi.password string ESXi 主機上具有管理權限的使用者的密碼。
esxi.port string

ESXi 主機的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

vum.hostname string

來源 VMware Update Manager 執行個體執行所在的 Windows 虛擬機器的 IP 位址或 FQDN。

如果已提供 FQDN,則它必須可以透過您用來執行升級的用戶端機器進行解析。

vum.os.username string 來源 VMware Update Manager 執行個體執行所在的 Windows 虛擬機器的管理員使用者名稱。
vum.os.password string

來源 VMware Update Manager 執行個體執行所在的 Windows 虛擬機器的管理員密碼。

如果未提供,則系統會提示您在範本驗證期間於命令主控台輸入密碼。

export.dir string 用於匯出來源組態和資料的目錄。

ceip 區段中的組態參數

表 12. ceip 區段 settings 子區段中的組態參數
名稱 類型 說明
ceip.enabled Boolean 設定為 true 以加入新升級應用裝置的 CEIP。