當您為 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 組態參數。請參閱 new.vcsa 區段 os 子區段中的組態參數 |
|
ovftool.arguments |
選擇性。使用此子區段來將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。
重要:
vCenter Server Appliance 安裝程式未驗證
ovftool.arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。
|
|
sso |
僅包含用來為新應用裝置設定 vCenter Single Sign-On 站台的 僅當您升級含內嵌式Platform Services Controller 的 vCenter 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。請參閱
備註: 依預設,
Migration Assistant 使用連接埠 9123。如果連接埠 9123 已被
Update Manager 機器上的其他服務使用,
Migration Assistant 會自動尋找其他可用的連接埠。您無法設定
Migration Assistant 的自訂連接埠。
|
ceip - 描述加入 VMware 客戶經驗改進計劃 (CEIP) |
settings |
僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 僅在升級含內嵌式 Platform Services Controller 的 vCenter Server Appliance、含內嵌式 vCenter Single Sign-On 的 vCenter Server Appliance 5.5 或 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.5.0.XXXX-YYYYYYY_OVF10.ova"
可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-6.5.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 主機網路組態的一部分。
備註: 該網路必須可從要升級的應用裝置所在的來源
ESXi 主機進行存取。該網路還必須可從其中執行升級的用戶端機器存取。
如果目標 ESXi 主機只有一個網路,則忽略。 |
datastore |
string | 您要儲存虛擬機器組態檔和新應用裝置的虛擬磁碟之資料存放區的名稱。 資料存放區必須可供目標 ESXi 主機使用。
備註: 資料存放區必須有至少 25 GB 的可用空間。
|
port |
整數 | 目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
名稱 | 類型 | 說明 |
---|---|---|
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 | 選擇性。用來向其中新增新應用裝置的虛擬機器資料夾的名稱。 |
名稱 | 類型 | 說明 |
---|---|---|
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 工具執行個體。 |
名稱 | 類型 | 說明 |
---|---|---|
ssh.enable |
Boolean | 設定為 true ,以便 SSH 管理員登入新應用裝置。 |
名稱 | 類型 | 說明 |
---|---|---|
site-name |
string | 新應用裝置的 vCenter Single Sign-On 站台名稱。 僅在升級含內嵌式 vCenter Single Sign-On 的 vCenter Server Appliance 5.5 時需要 |
名稱 | 類型 | 說明 |
---|---|---|
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 版本,值可以為 |
system.name |
string | 新應用裝置的臨時網路的主要網路身分識別。 可以是 IP 位址或 FQDN,最好是 FQDN。 FQDN 和以點分隔的十進位數必須符合 RFC 1123 準則。 |
名稱 | 類型 | 說明 |
---|---|---|
vcdb.migrateSet |
string | 要從舊應用裝置傳輸至新應用裝置的資料的類型。
備註: 為確保新應用裝置的最短升級時間和最低儲存區需求,請使用
core 值。
|
source.vc
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 要升級的應用裝置所在的來源 ESXi 主機的 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 | 來源應用裝置的作業系統的根使用者的密碼。 |
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。 |