在執行 CLI 命令以升級 vCenter ServerAppliance 之前,您必須先針對升級規格準備含有組態參數及其值的 JSON 檔案。

vCenter Server安裝程式包含所有升級類型的 JSON 範本。如需範本的相關資訊,請參閱 vCenter ServerAppliance 之 CLI 升級的 JSON 範本

您可以針對自己的規格,透過將值設定為 JSON 範本中的組態參數,以最低組態升級應用裝置。對於自訂組態,您可以編輯預設值、移除組態參數及新增組態參數。

如需組態參數及其說明的完整清單,請導覽至作業系統的安裝程式子目錄並執行 vcsa-deploy upgrade --template-help命令,或參閱升級 vCenter Server Appliance 的 CLI 升級組態參數

必要條件

程序

  1. vCenter Server Appliance安裝程式中,導覽至 vcsa-cli-installer 目錄並開啟 templates 子資料夾。
  2. 將升級範本從 upgrade 子資料夾複製到您的工作區。
    重要: JSON 組態檔的路徑必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。
  3. 在文字編輯器中開啟您使用案例的範本檔案。
    為確保 JSON 組態檔的語法正確,請使用 JSON 編輯器。
  4. 填寫必要組態參數的值,並選擇性地輸入其他參數及其值。
    例如,如果想要針對新應用裝置的臨時網路使用 IPv4 DHCP 指派,請在範本的 temporary_network子區段中,將 mode 參數的值變更為 dhcp 並移除適用於靜態指派的預設組態參數。
            "temporary_network": {
                "ip_family": "ipv4",
                "mode": "dhcp"
            },
    重要: 字串值 (包括密碼) 必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

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

    布林值必須僅包含小寫字元,即值可以是 truefalse。例如,"ssh_enable":false

  5. (選擇性) 使用所選擇的 JSON 編輯器驗證 JSON 檔案。
  6. 以 UTF-8 格式儲存並關閉檔案。

下一步

如果需要,您可以針對升級規格建立和儲存其他範本。

vCenter ServerAppliance 之 CLI 升級的 JSON 範本

vCenter ServerAppliance 安裝程式包含 JSON 範本,這些範本位於 vcsa-cli-installer/templates 目錄中。在 upgrade 子資料夾中,您可以找到包含所有升級類型之最低組態參數的 JSON 範本。

對於每種升級類型,有一個範本用於在 ESXi主機上部署新應用裝置,另一個範本用於在 vCenter Server 執行個體上部署新應用裝置。

表 1. 升級 vCenter Server Appliance安裝程式中包含的 JSON 範本
位置 範本 說明
vcsa-cli-installer\templates\upgrade\vcsa\6.7 embedded_vCSA_on_ESXi.json 包含在 ESXi主機上將含內嵌式 Platform Services ControllervCenter Server Appliance 6.7 升級為 vCenter Server Appliance 8.0 所需的最低組態參數。
embedded_vCSA_on_VC.json 包含在 vCenter Server執行個體上將含內嵌式 Platform Services Controller vCenter Server Appliance 8.0vCenter Server Appliance 6.7 升級所需的最低組態參數。
vCSA_on_ESXi.json 包含在 ESXi主機上將含外部 Platform Services ControllervCenter Server Appliance 6.7 升級為 vCenter Server Appliance 8.0 所需的最低組態參數。
vCSA_on_VC.json 包含在 vCenter Server執行個體上將含外部 Platform Services ControllervCenter Server Appliance 6.7 升級為 vCenter Server Appliance 8.0 所需的最低組態參數。
vcsa-cli-installer\templates\upgrade\vcsa\7.0 embedded_vCSA_on_ESXi.json 包含在 ESXi主機上將含內嵌式 Platform Services ControllervCenter Server Appliance 7.0 升級為 vCenter Server Appliance 8.0 所需的最低組態參數。
embedded_vCSA_on_VC.json 包含在 vCenter Server執行個體上將含內嵌式 Platform Services ControllervCenter Server Appliance 7.0 升級為 vCenter Server Appliance 8.0 所需的最低組態參數。

關於使用 CLI 升級含外部 Platform Services ControllervCenter Server

升級使用外部 Platform Services ControllervCenter Server Appliance 時,會將其轉換為vCenter Server 執行個體,並將這些服務內嵌於應用裝置中。基於此原因,您必須在 JSON 升級範本中指定複寫合作夥伴參數。

升級使用外部 Platform Services ControllervCenter Server Appliance 時,您必須在 JSON 升級範本中指定複寫合作夥伴參數。這些參數會指出升級是否適用於下列其中一個 vCenter ServerPlatform Services Controller 升級案例。
  • SSO 網域內的單一 vCenter Server和單一 Platform Services Controller 執行個體。
  • SSO 網域內的第一個 vCenter ServerPlatform Services Controller 執行個體包含多個 vCenter Server
  • 複寫 SSO 網域內的 vCenter ServerPlatform Services Controller 執行個體,您必須將這些執行個體指向做為複寫合作夥伴的現有 vCenter Server 7.0 執行個體。
重要: 無法升級外部 Platform Services Controller。升級程序會將 Platform Services Controller服務聚合到 vCenter Server Appliance 中。如需詳細資訊,請參閱 移除 Platform Services Controller

使用外部 Platform Services Controller的部署通常稱為 MxN 部署,其中 M 代表 vCenter Server,而 N 代表外部Platform Services Controller。代表網域中 vCenter ServerPlatform Services Controller 的多個執行個體時,這會以 MnxNn 表示,其中 n 為執行個體數目。例如,M2xN2指出相同網域中有兩個 vCenter Server 執行個體和兩個Platform Services Controller 執行個體。升級此類部署時,請先將一個執行個體升級至 8.0版,然後將第二個執行個體升級至 8.0,並指定兩個執行個體中的第一個執行個體做為複寫合作夥伴。

JSON 升級範本中的複寫參數位於範本的 sso區段中,並且為 first_instancereplication_partner_hostname

參數名稱 說明
first_instance first_instance參數會將 vCenter Server 識別為 vCenter Server SSO 網域中的第一個執行個體,或識別為複寫合作夥伴。

如果它是第一個 vCenter Server執行個體,請將 first_instance 設定為 true。針對相同 SSO 網域中的其他 vCenter Server 執行個體,請將 first_instance 設定為 false

replication_partner_hostname *

如果將 first_instance設定為 false,則必須指定已升級至 8.0 版且其外部 PSC 已聚合至 vCenter Server Appliance 的 vCenter Server 的 FQDN 或 IP 位址。

當您使用 CLI 對使用外部 Platform Services Controller的單一 vCenter Server Appliance 執行升級時,程序如下所示:
  1. ESXi上升級時使用 vCSA_on_ESXi.json 範本,或在 vCenter Server 部署上升級時使用 vCSA_on_VC.json 範本,藉此升級拓撲中的 vCenter Server 執行個體。

  2. 針對包含單一 vCenter ServerPlatform Services Controller ( M1xN1 部署) 的部署拓撲,編輯範本的 sso 區段,以將 first_instance 參數設定為 true,然後移除 replication_partner_hostname 參數。
    "sso": {
    "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
    ],
    "first_instance": true
    }
  3. 在 JSON 範本中指定其餘的升級組態參數,然後使用 CLI 將 vCenter Server升級至8.0 版。請參閱使用 CLI 來升級 vCenter Server應用裝置
  4. 成功升級 vCenter Server後,解除委任Platform Services Controller。請參閱解除委任 Platform Services Controller
    重要: 僅在升級和聚合拓撲中的所有 vCenter Server執行個體之後,才解除委任 Platform Services Controller 執行個體。
針對包含兩個或更多 vCenter ServerPlatform Services Controller 執行個體 ( M2xN2 部署) 的部署,先將 M1 vCenter Server 執行個體升級至 8.0 版,然後再升級第二個,即複寫 vCenter Server 執行個體。
  1. ESXi上升級時使用 vCSA_on_ESXi.json 範本,或在 vCenter Server 部署上升級時使用 vCSA_on_VC.json 範本,藉此升級部署中的 vCenter Server 執行個體。

  2. 針對第一個 vCenter Server執行個體 ( M1),編輯範本的 sso 區段,以將 first_instance 參數設定為 true,然後移除 replication_partner_hostname 參數。
    "sso": {
    "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
    ],
    "first_instance": true
    }
  3. 針對其餘的 vCenter Server執行個體 ( M2),編輯範本的 sso 區段,以將 first_instance 參數設定為 false,然後提供要將第二個節點複寫到的 vCenter Server 執行個體的 FQDN 或 IP 位址。複寫合作夥伴是您升級至 8.0版的第一個 vCenter Server 執行個體 ( M1),它已與其 Platform Services Controller 執行個體聚合在一起。
    "sso": {
    "__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
    "first_instance": false,
    "replication_partner_hostname": "FQDN_or_IP_address"
  4. 在 JSON 範本中指定其餘的升級組態參數,然後使用 CLI 完成升級。請參閱使用 CLI 來升級 vCenter Server應用裝置
  5. 成功升級拓撲中的所有 vCenter Server執行個體後,解除委任Platform Services Controller 執行個體。請參閱解除委任 Platform Services Controller
    重要: 僅在升級和聚合拓撲中的所有 vCenter Server執行個體之後,才解除委任 Platform Services Controller 執行個體。

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

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

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

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

表 2. 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 ControllervCenter 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-8.0.0.XXXX-YYYYYYY_OVF10.ova" 可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova

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

new_vcsa 區段中的組態參數

表 3. 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 升級命令的語法

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

如果目標 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) 資料夾的名稱。
表 5. 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 ControllervCenter 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 工具執行個體。

表 6. 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

表 7. 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 傳輸資料

表 8. new_vcsa 區段 sso 子區段中的組態參數
名稱 類型 說明
first_instance string

如果這是您的 vCenter Server SSO 網域中的第一個聚合升級作業,或者您不想為此節點設定複寫合作夥伴,請將 first_instance 設定為 true

如果您想要為此節點設定複寫合作夥伴,請將 first_instance 設定為 false,並提供 replication_partner_hostname 的值做為先前聚合節點 (目前位於內嵌式 vCenter Server 拓撲中) 的 FQDN。

如需有關指定 first_instancereplication_partner_hostname 參數的詳細資訊,請參閱關於使用 CLI 升級含外部 Platform Services Controller的 vCenter Server

replication_partner_hostname string 複寫合作夥伴的主機名稱。如果是 first_instance 則移除。

source_vc 區段中的組態參數

表 9. 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 連接埠時使用。

表 10. source_vc 區段 vc_vcsa 子區段中的組態參數
名稱 類型 說明
hostname string 要升級的來源應用裝置的 IP 位址或 FQDN。
username string 來源應用裝置上的 vCenter Single Sign-On 管理員使用者,例如,administrator@vsphere.local。
重要: 使用者必須為 administrator@ your_domain_name
password string 來源應用裝置上 vCenter Single Sign-On 管理員使用者的密碼。
root_password string 來源應用裝置的作業系統的根使用者的密碼。
export_dir 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。