當您為 CLI 升級準備 JSON 組態檔時,必須設定參數和值,來為 vCenter Server Appliance 或 Platform Services Controller 應用裝置的升級提供輸入資料。
JSON 升級檔案中組態參數的區段和子區段
用於 CLI 升級的 JSON 組態檔中的組態參數在區段和子區段中進行組織整理。
區段 | 子區段 | 說明 |
---|---|---|
new_vcsa - 描述您要部署的新應用裝置 |
esxi |
僅當您要在 ESXi 主機上直接部署新的應用裝置時才使用。 |
vc |
僅當您要在 vCenter Server 執行個體的詳細目錄上部署新的應用裝置時才使用。 包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。請參閱
備註: 必須填寫此子區段或
esxi 子區段。
目標 vCenter Server 執行個體不能是您要升級的 vCenter Server Appliance。這種情況下,請使用 |
|
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。請參閱
備註: 依預設,
Migration Assistant 使用連接埠 9123。如果連接埠 9123 已被
Update Manager 機器上的其他服務使用,
Migration Assistant 會自動尋找其他可用的連接埠。您無法設定
Migration Assistant 的自訂連接埠。
|
ceip - 描述加入 VMware 客戶經驗改進計劃 (CEIP) |
settings |
僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 僅當您升級含內嵌式 Platform Services Controller 的 vCenter Server Appliance 或升級 Platform Services Controller 應用裝置時需要。
備註: 如果
ceip_enabled 組態參數設定為
true ,則必須執行帶有
--acknowledge-ceip 引數的 CLI 部署命令。
如需有關 CEIP 的資訊,請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。 |
若要設定包含反斜線 (\) 或引號 (") 字元的值,您必須在字元前面加上反斜線 (\) 字元。例如,"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。
布林值必須只包含小寫字元。可以是 true
或 false
。例如,"ssh_enable":false
。
new_vcsa
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 您要在其上部署新應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。 |
username |
string | 在目標 ESXi 主機上具有管理權限的使用者名稱,例如 root。 |
password |
string | 在目標 ESXi 主機上具有管理權限的使用者的密碼。 |
deployment_network |
string | 將新應用裝置連線到的網路的名稱。 該網路必須屬於目標 ESXi 主機或 vCenter Server Appliance 執行個體 (由
備註: 該網路必須可從您要升級之應用裝置所在的來源
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) 簽署,並建立安全連線。如果是自我簽署憑證,CLI 會停止升級,除非您指定下列 SSL 憑證組態選項之一: 指定安全雜湊演算法 1 (SHA-1) 憑證指紋。憑證指紋是唯一識別憑證的十六進位字串。指紋是使用指紋演算法從憑證內容進行計算的。 "thumbprint": "憑證 SHA-1 指紋" 將 "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 主機進行存取。該網路還必須可從其中執行升級的用戶端機器存取。
如果目標 ESXi 主機或 DRS 叢集只有一個網路,則忽略。 |
datacenter |
字串或陣列 | 包含您要在其上部署新應用裝置的目標 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 |
整數 | 目標 vCenter Server 執行個體的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當目標 vCenter Server 執行個體使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
target |
字串或陣列 | 您要在其上部署新應用裝置的目標叢集、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 | 新應用裝置的大小。
備註: 必須考慮要升級之應用裝置的資料庫大小。對於外部資料庫,請參閱
決定新應用裝置的 Oracle 資料庫大小和儲存區大小。
|
image |
string | 選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 URL。 依預設,安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。 |
name |
string | 新應用裝置的虛擬機器名稱。 除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外,必須只包含 ASCII 字元,並且長度不得超過 80 個字元。 |
ovftool_path |
string | 選擇性。OVF 工具可執行檔的本機檔案路徑。 依預設,安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。 |
名稱 | 類型 | 說明 |
---|---|---|
ip_family |
string | 新應用裝置的臨時網路的 IP 版本。 設定為 |
mode |
string | 新應用裝置的臨時網路的 IP 指派。 設定為 |
ip |
string | 新應用裝置的臨時 IP 位址。 僅當您使用靜態指派,也就是將 您必須設定與臨時網路 IP 版本,也就是與 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 位址組態的靜態網路模式,也就是將 |
prefix |
string | 新應用裝置的臨時網路的網路首碼長度。 僅當 網路首碼長度是子網路遮罩中設定的位元數。例如,如果子網路遮罩是 255.255.255.0,則二進位版本的首碼長度中包含 24 個位元,因此網路首碼長度為 24。 對於 IPv4 版本,值必須在 對於 IPv6 版本,值必須在 |
gateway |
string | 新應用裝置的臨時網路的預設閘道的 IP 位址。 對於 IPv6 版本,值可以為 |
名稱 | 類型 | 說明 |
---|---|---|
vcdb_migrateSet |
string | 選取要從舊應用裝置移轉至新應用裝置的資料類型。資料會從來源 vCenter Server 複製到目標伺服器。資料的原始來源將保持不變。
備註: 為了盡可能減少新的 vCenter Server 應用裝置所需的升級時間和儲存區數量,請使用
core 值。
如需有關可從現有 vCenter Server 傳輸至新升級的 vCenter Server 的資料類型的詳細資訊,請參閱從現有 vCenter Server Appliance 傳輸資料。 |
source_vc
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 您要升級之應用裝置所在的來源 ESXi 或 vCenter Server 主機的 IP 位址或 FQDN。 |
username |
string | 在來源 ESXi 主機上具有管理權限的使用者名稱,例如 root。 |
password |
string | 在來源 ESXi 主機上具有管理權限的使用者的密碼。 |
port |
整數 | 來源 ESXi 主機的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當來源 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
名稱 | 類型 | 說明 |
---|---|---|
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
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
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
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
ceip_enabled |
Boolean | 設定為 true 以加入新升級應用裝置的 CEIP。 |