使用 CLI 安裝程式將 vCenter Server 安裝移轉至應用裝置時,您必須針對移轉規格提供參數與值。
下表列出用於為來源 vCenter Server 提供輸入資料的組態參數。
若要設定包含反斜線 (\) 或引號 (") 字元的值,您必須在字元前面加上反斜線 (\) 字元。例如 "password":"my\"password"
可設定密碼 my"password;"image":"C:\\vmware\\vcsa"
可設定路徑 C:\vmware\vcsa。
布林值必須僅包含小寫字元。可以是 true
或 false
。例如,"ssh_enable":false
。
JSON 移轉範本中的組態參數區段及子區段
JSON 移轉範本中的組態參數會以區段及子區段的形式進行組織整理。
區段 | 子區段 | 說明 |
---|---|---|
new_vcsa - 描述要移轉至的目標應用裝置 |
esxi |
僅當您要在 ESXi 主機上直接部署應用裝置時才使用。
包含描述目標
ESXi 主機的組態參數。
備註: 必須填寫
esxi 或
vc 子區段。
|
vc |
僅當您要在 vCenter Server 執行個體的詳細目錄上部署應用裝置時才使用。 包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。
備註: 必須填寫
vc 或
esxi 子區段。
|
|
appliance |
包含描述應用裝置的組態參數。 | |
os |
包含描述適用於應用裝置的作業系統設定的組態參數。 | |
ovftool_arguments |
選用子區段,用於將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。
重要:
vCenter Server Appliance 安裝程式未驗證
ovftool_arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。
|
|
temporary_network |
包含描述用於將資料從來源移轉至新目標應用裝置的臨時網路的組態參數。 | |
user-options |
僅在來源為 vCenter Server 執行個體時使用。包含可讓您控制特定元件移轉程序各方面的組態參數。 | |
source_vc - 說明來源 Platform Services Controller |
vc_win |
包含描述 vCenter Server 或 Platform Services Controller 的來源 Windows 安裝的組態參數 |
run_migration_assistant |
僅在來源 Windows 安裝做為虛擬機器執行,並且您想要自動執行 Migration Assistant 引動時使用。對於在實體機器上執行的來源 Windows 安裝,或者您在來源 Windows 機器上手動執行 Migration Assistant 時,請複製來源機器上 Migration Assistant 主控台輸出的指紋值並貼至 vc_win 子區段中的 migration_ssl_thumbprint 索引鍵,然後移除 run_migration_assistant 區段。 |
|
ceip - 描述加入 VMware 客戶經驗改進計劃 (CEIP) |
settings |
僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 ceip_enabled 組態參數。 僅當您部署含內嵌式 Platform Services Controller 的 vCenter Server Appliance 或部署 Platform Services Controller 應用裝置時需要。
備註: 如果設定為
true ,則必須執行帶有
--acknowledge-ceip 引數的 CLI 部署命令。
如需有關 CEIP 的資訊,請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。 |
new_vcsa
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 您要在其上部署應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。 |
username |
string | 在目標 ESXi 主機上具有管理權限的使用者名稱,例如 root。 |
password |
string | 在目標 ESXi 主機上具有管理權限的使用者的密碼。 |
deployment_network |
string | 要連線應用裝置的網路名稱。
備註: 該網路必須可從目標
ESXi 主機進行存取。
如果目標 ESXi 主機只有一個網路,則忽略。 |
datastore |
string | 您要儲存所有虛擬機器組態檔和應用裝置的虛擬磁碟之資料存放區的名稱。
備註: 該資料存放區必須可從
ESXi 主機進行存取。
該資料存放區必須有足夠的可用空間。 |
port |
整數 | ESXi 主機的連接埠號碼。預設連接埠為 443。 |
ssl_certificate_verification |
string | CLI 會驗證伺服器的安全性憑證是否由憑證授權機構 (CA) 簽署,並建立安全連線。如果為自我簽署的憑證,CLI 會停止升級,除非您指定下列其中一個 SSL 憑證組態選項。 指定安全雜湊演算法 1 (SHA-1) 憑證指紋。憑證指紋是唯一識別憑證的十六進位字串。指紋是使用指紋演算法從憑證內容進行計算的。 "thumbprint": "certificate SHA-1 thumbprint" 將 "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 主機或 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 的連接埠號碼。預設連接埠為 443。 |
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 | 應用裝置的大小。
|
image |
string | 選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 URL。 依預設,安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。 |
name |
string | 應用裝置的虛擬機器名稱。 除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外,必須只包含 ASCII 字元,並且長度不得超過 80 個字元。 |
ovftool_path |
string | 選擇性。OVF 工具可執行檔的本機檔案路徑。 依預設,安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。 |
名稱 | 類型 | 說明 |
---|---|---|
password |
string | 應用裝置作業系統的根使用者密碼。 密碼必須包含 8 至 20 個字元,至少一個大寫字元、一個小寫字元、一個數字,以及一個特殊字元,例如,貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元必須僅包含不含空格的下部 ASCII 字元。 |
ssh_enable |
Boolean | 設定為 true ,以便 SSH 管理員登入應用裝置。 |
名稱 | 類型 | 說明 |
---|---|---|
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" 僅當您使用靜態指派,也就是將 |
prefix |
string | 網路首碼長度。 僅當您使用指派,也就是將 對於 IPv4 版本,值必須在 對於 IPv6 版本,值必須在 |
gateway |
string | 預設閘道的 IP 位址。 對於 IPv6 版本,值可以為 |
名稱 | 類型 | 說明 |
---|---|---|
vcdb_migrateSet |
string | 選取要從舊應用裝置移轉至新應用裝置的資料類型。資料會從來源 vCenter Server 複製到目標伺服器。資料的原始來源將保持不變。
備註: 為了盡量減少移轉時間以及新 vCenter Server Appliance 所需的儲存區數量,請使用
core 值。
如需有關可從現有 vCenter Server 傳輸至新升級的 vCenter Server 的資料類型的詳細資訊,請參閱從現有 vCenter Server Appliance 傳輸資料。 |
Migration Assistant 自動引動需求
您可以使用 run_migration_assistant
子區段自動執行 Migration Assistant 引動。僅當來源 Windows 安裝做為虛擬機器執行時,自動引動才會運作。
os_username
或
vum_os_username
參數中指定的使用者帳戶需要將權限提升至管理員。例如:
- 內建 Windows 管理員帳戶
- 使用者名稱不是 Administrator (本機 Windows 管理員群組成員) 的使用者帳戶
- 使用者名稱為 Administrator (本機 Windows 管理員群組成員) 的網域管理員帳戶
- 使用者名稱識別碼必須採用格式 your_domain_name\\user_ID 或 user_ID@your_domain_name。
vc_win
子區段中的
migration_ssl_thumbprint
金鑰,然後移除
run_migration_assistant
區段。
source_vc
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 要移轉的 vCenter Server 或 Platform Services Controller 的來源 Windows 安裝的主機名稱或 IP 位址。 |
username |
string | 具有要移轉的 vCenter Server Platform Services Controller 執行個體之管理權限的 vCenter Single Sign-On 使用者名稱。 |
password |
string | 要移轉的 vCenter Server 或 Platform Services Controller 執行個體的密碼。 |
migration_port |
string | Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。 |
active_directory_domain |
string | 來源 vCenter Server 執行個體加入的 Active Directory 網域的名稱。 |
active_directory_username |
string | 來源 vCenter Server 執行個體加入的 Active Directory 網域的管理員使用者名稱。 |
active_directory_password |
string | 來源 vCenter Server 執行個體加入的 Active Directory 網域的管理員密碼。
備註: 安裝程式會驗證輸入的認證,但不會檢查將目標機器新增至 Active Directory 網域所需的權限。確認使用者認證具有將機器新增至 Active Directory 網域所需的所有權限。
|
migration_ssl_thumbprint |
string | Migration Assistant 的 SSL 指紋。 |
名稱 | 類型 | 說明 |
---|---|---|
esxi_hostname |
string | 來源 vCenter Server Platform Services Controller 執行個體所在 ESXi 的 FQDN 或 IP 位址。 |
esxi_username |
string | ESXi 主機上具有管理權限之使用者的使用者名稱。 |
esxi_password |
string | ESXi 主機使用者的密碼。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。 |
esxi_port |
string | ESXi 主機的連接埠號碼。預設連接埠為 443。 |
os_username |
string | 來源 Windows 機器的管理員使用者名稱。 |
os_password |
string | 來源 Windows 機器的管理員使用者密碼。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。 |
migration_ip |
string | 要移轉的網路介面卡的 IP 位址。 |
migration_port |
string | Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。 |
export_dir |
string | 用於匯出來源組態和資料的目錄。 |
sa_password |
string | 網路 vCenter Server 服務帳戶使用者密碼的 IP 位址。僅當 vCenter Server 服務使用非 LocalSystem 帳戶執行時,才需要此選項。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。 |
名稱 | 類型 | 說明 |
---|---|---|
esxi_hostname |
string | 來源 vCenter Server Platform Services Controller 執行個體所在 ESXi 的 FQDN 或 IP 位址。 |
esxi_username |
string | ESXi 主機上具有管理權限之使用者的使用者名稱。 |
esxi_password |
string | ESXi 主機使用者的密碼。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。 |
esxi_port |
string | ESXi 主機的連接埠號碼。預設連接埠為 443。 |
vum_hostname |
string | 來源 Update Manager 執行個體所在 ESXi 的 FQDN 或 IP 位址。 |
vum_os_username |
string | 來源 Windows 機器的管理員使用者名稱。 |
vum_os_password |
string | 來源 Update Manager Windows 機器的管理員使用者密碼。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。 |
migration_port |
string | Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。 |
export_dir |
string | 用於匯出來源組態和資料的目錄。 |
ceip
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
ceip_enabled |
Boolean | 設定為 true 以加入此應用裝置的 CEIP。 |