升級 vCenter Server Appliance 的 CLI 升級組態參數

當您為 CLI 升級準備 JSON 組態檔時，必須設定參數和值，來為 vCenter Server Appliance 的升級提供輸入資料。

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 組態參數。
	ovftool_arguments	選擇性。使用此子區段來將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。 重要： vCenter Server Appliance 安裝程式未驗證 ovftool_arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數，則部署可能會失敗。
	temporary_network	包含描述適用於新應用裝置的臨時網路設定的組態參數。請參閱new_vcsa 區段 temporary_network 子區段中的組態參數
	user_options	僅包含用來設定您要將其從舊應用裝置傳輸至新應用裝置的資料類型的 vcdb_migrateSet 組態參數。請參閱new_vcsa 區段 user_options 子區段中的組態參數
source_vc- 描述您要升級的現有應用裝置。	managing_esxi_or_vc	包含描述您要升級之應用裝置所在的來源 ESXi 主機或 vCenter Server Appliance 執行個體的組態參數。請參閱 source_vc 區段 managing_esxi_or_vc 子區段中的組態參數。
	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 Controller 的 vCenter Server Appliance 或升級 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-7.0.0.XXXX-YYYYYYY_OVF10.ova" 可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-7.0.0.XXXX-YYYYYYY_OVF10.ova。

布林值必須只包含小寫字元。可以是 true 或 false。例如，"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 主機或 vCenter Server Appliance 執行個體 (由 managing_esxi_or_vc 組態參數識別) 網路組態。 備註： 該網路必須可從您要升級之應用裝置所在的來源 ESXi 主機或 vCenter Server Appliance 執行個體 (由 managing_esxi_or_vc 組態參數識別) 存取。該網路還必須可從其中執行升級的用戶端機器存取。 如果目標 ESXi 主機只有一個網路，則忽略。
datastore	string	您要儲存虛擬機器組態檔和新應用裝置的虛擬磁碟之資料存放區的名稱。 資料存放區必須可供目標 ESXi 主機使用。 備註： 資料存放區必須有至少 25 GB 的可用空間。
port	整數	目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。
ssl_certificate_verification	string	CLI 會驗證伺服器的安全性憑證是否由憑證授權機構 (CA) 簽署，並建立安全連線。如果是自我簽署憑證，除非您指定下列 SSL 憑證組態選項之一，否則 CLI 會停止升級： 指定安全雜湊演算法 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 管理員使用者名稱，例如，[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"] 如果資料中心中沒有資料夾路徑，則僅使用資料中心名稱。例如， ["datacenter_name"] 或 "datacenter_name" 備註： 值不區分大小寫。
datastore	string	您要儲存所有虛擬機器組態檔和新應用裝置的虛擬磁碟之資料存放區的名稱。 備註： 資料存放區必須可供目標 ESXi 主機或 DRS 叢集使用。 資料存放區必須有至少 25 GB 的可用空間。
port	整數	目標 vCenter Server 執行個體的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當目標 vCenter Server 執行個體使用自訂 HTTPS 反向 Proxy 連接埠時使用。
target	陣列	您要在其上部署新應用裝置的目標叢集、ESXi 主機或資源集區。這是使用 datacenter 參數指定的目標。此路徑必須以叢集名稱、ESXi 主機名稱或資源集區名稱結尾。 重要： 您必須提供在 vCenter Server 詳細目錄中顯示的名稱。例如，如果目標 ESXi 主機的名稱是 vCenter Server 詳細目錄中的 IP 位址，則您無法提供 FQDN。 備註： 所有值都區分大小寫。 如果要將已部署的應用裝置列在資料中心階層內的其他位置，請使用本節稍後所述的 vm_folder 參數。 如果目標叢集、 ESXi 主機或資源集區位於資料夾或資料夾結構中，則指定值為以逗點分隔的多個字串的清單。例如， ["parent_folder", "child_folder", "esxi-host.domain.com"] 如果目標 ESXi 主機是叢集的一部分，請將路徑指定為以逗號分隔的多個字串的清單。例如， ["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	新應用裝置的大小。 備註： 必須考慮要升級之應用裝置的資料庫大小。對於外部資料庫，請參閱 決定新應用裝置的 Oracle 資料庫大小和儲存區大小。 如果您要為具有預設儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter Server Appliance，則設定為 tiny。 部署具有 2 個 CPU、10 GB 記憶體和 300 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter Server Appliance，則設定為 tiny-lstorage。 部署具有 2 個 CPU、10 GB 記憶體和 825 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter Server Appliance，則設定為 tiny-xlstorage。 部署具有 2 個 CPU、10 GB 記憶體和 1700 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter Server Appliance，則設定為 small。 部署具有 4 個 CPU、16 GB 記憶體和 340 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter Server Appliance，則設定為 small-lstorage。 部署具有 4 個 CPU、16 GB 記憶體和 870 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter Server Appliance，則設定為 small-xlstorage。 部署具有 4 個 CPU、16 GB 記憶體和 1750 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter Server Appliance，則設定為 medium。 部署具有 8 個 CPU、24 GB 記憶體和 525 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter Server Appliance，則設定為 medium-lstorage。 部署具有 8 個 CPU、24 GB 記憶體和 1025 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter Server Appliance，則設定為 medium-xlstorage。 部署具有 8 個 CPU、24 GB 記憶體和 1905 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter Server Appliance，則設定為 large。 部署具有 16 個 CPU、32 GB 記憶體和 740 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter Server Appliance，則設定為 large-lstorage。 部署具有 16 個 CPU、32 GB 記憶體和 1090 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter Server Appliance，則設定為 large-xlstorage。 部署具有 16 個 CPU、32 GB 記憶體和 1970 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter Server Appliance，則設定為 xlarge。 部署具有 24 個 CPU、48 GB 記憶體和 1180 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter Server Appliance，則設定為 xlarge-lstorage。 部署具有 24 個 CPU、48 GB 記憶體和 1230 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter Server Appliance，則設定為 xlarge-xlstorage。 部署具有 24 個 CPU、48 GB 記憶體和 2110 GB 儲存區的應用裝置。 如果您要為具有預設儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services Controller 的 vCenter Server Appliance，則設定為 management-tiny。 部署具有 2 個 CPU、10 GB 記憶體和 300 GB 儲存區的應用裝置。
image	string	選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 URL。 依預設，安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。
name	string	新應用裝置的虛擬機器名稱。 除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外，必須只包含 ASCII 字元，並且長度不得超過 80 個字元。
ovftool_path	string	選擇性。OVF 工具可執行檔的本機檔案路徑。 依預設，安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。

表 5. new_vcsa 區段 temporary_network 子區段中的組態參數

名稱	類型	說明
ip_family	string	新應用裝置的臨時網路的 IP 版本。 設定為 ipv4 或 ipv6。
mode	string	新應用裝置的臨時網路的 IP 指派。 設定為 static 或 dhcp。
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 版本，值必須在 0 和 32 之間。 對於 IPv6 版本，值必須在 0 和 128 之間。
gateway	string	新應用裝置的臨時網路的預設閘道的 IP 位址。 對於 IPv6 版本，值可以為 default。

表 6. new_vcsa 區段 user_options 子區段中的組態參數

名稱	類型	說明
vcdb_migrateSet	string	選取要從舊應用裝置移轉至新應用裝置的資料類型。資料會從來源 vCenter Server 複製到目標伺服器。資料的原始來源保持不變。 如果您只要傳輸組態資料，則設定為 core。此選項可提供最快的資料移轉，使系統停機時間保持最短。 如果您要立即傳輸組態和歷史資料 (事件和工作)，則設定為 core_events_tasks。直到來源 vCenter Server Appliance 的所有資料均已移轉，vCenter Server 才會啟動。 如果您要立即傳輸組態、歷史和效能度量資料，則設定為 all。直到來源 vCenter Server for Windows 的所有資料均已移轉，vCenter Server 才會啟動。此選項可傳輸最大數量的資料，且所需停機時間比其他資料移轉選項更長。 如果您要在升級完成後在背景中傳輸歷史資料 (事件和工作)，則設定為 transfer_events_tasks_after_upgrade。在此期間，vCenter Server 效能可能不是最佳的。 如果您要在升級完成後在背景中傳輸歷史資料和效能度量資料，則設定為 transfer_stats_events_tasks_after_upgrade。在此期間，vCenter Server 效能可能不是最佳的。 備註： 為了盡量減少升級時間以及新 vCenter Server Appliance 所需的儲存區數量，請使用 core 值。 如需有關可從現有 vCenter Server 傳輸至新升級的 vCenter Server 的資料類型詳細資訊，請參閱從現有 vCenter ServerAppliance 傳輸資料。

表 7. new_vcsa 區段 sso 子區段中的組態參數

名稱	類型	說明
first_instance	string	如果這是您的 vCenter Server SSO 網域中的第一個聚合升級作業，或者您不想為此節點設定複寫合作夥伴，請將 first_instance 設定為 true。 如果您想要為此節點設定複寫合作夥伴，請將 first_instance 設定為 false，並提供 replication_partner_hostname 的值做為先前聚合節點 (目前位於內嵌式 vCenter Server 拓撲中) 的 FQDN。 如需有關指定 first_instance 和 replication_partner_hostname 參數的詳細資訊，請參閱關於使用 CLI 升級含外部 Platform Services Controller的 vCenter Server。
replication_partner_hostname	string	複寫合作夥伴的主機名稱。如果是 first_instance 則移除。

source_vc 區段中的組態參數

表 8. source_vc 區段 managing_esxi_or_vc 子區段中的組態參數

名稱	類型	說明
hostname	string	您要升級之應用裝置所在的來源 ESXi 或 vCenter Server 主機的 IP 位址或 FQDN。
username	string	在來源 ESXi 主機上具有管理權限的使用者名稱，例如 root。
password	string	在來源 ESXi 主機上具有管理權限的使用者的密碼。
port	整數	來源 ESXi 主機的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當來源 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

表 9. 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	來源應用裝置的作業系統的根使用者的密碼。
export_dir	string	用於匯出來源組態和資料的目錄。

source.vum 區段中的組態參數

表 10. 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 區段中的組態參數

表 11. ceip 區段 settings 子區段中的組態參數

名稱	類型	說明
ceip_enabled	Boolean	設定為 true 以加入新升級應用裝置的 CEIP。