當您為 CLI 部署準備 JSON 組態檔時,必須設定參數和值,來為 vCenter Server Appliance 的部署提供輸入資料。
JSON 部署檔案中組態參數的區段和子區段
用於 CLI 升級的 JSON 組態檔中的組態參數在區段和子區段中進行組織整理。
區段 | 子區段 | 說明 |
---|---|---|
new_vcsa - 描述您要部署的應用裝置 |
esxi |
僅當您要在 ESXi 主機上直接部署應用裝置時才使用。 包含描述目標 ESXi 主機的組態參數。
根據您是否要在部署期間設定 vSAN 或 vLCM 管理叢集,來參閱相關章節,以取得有關組態參數的詳細資訊。
備註: 必須填寫
esxi 或
vc 子區段。
|
vc |
僅當您要在 vCenter Server 執行個體的詳細目錄上部署應用裝置時才使用。 包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。請參閱
備註: 必須填寫
vc 或
esxi 子區段。
|
|
appliance |
包含描述應用裝置的組態參數。請參閱new_vcsa 區段 appliance 子區段中的組態參數。 |
|
network |
包含描述適用於應用裝置的網路設定的組態參數。請參閱new_vcsa 區段 network 子區段中的組態參數。 |
|
os |
包含描述適用於應用裝置的作業系統設定的組態參數。請參閱new_vcsa 區段 os 子區段中的組態參數。 |
|
sso |
包含描述適用於應用裝置的 vCenter Single Sign-On 設定的組態參數。請參閱new_vcsa 區段 sso 子區段中的組態參數。 |
|
ovftool_arguments |
選用子區段,用於將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。
重要:
vCenter Server 安裝程式未驗證
ovftool_arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。
|
|
ceip - 描述加入 VMware 客戶經驗改進計劃 (CEIP) |
settings |
僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的
備註: 如果設定為
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
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 您要在其上部署應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。 |
username |
string | 在目標 ESXi 主機上具有管理權限的使用者名稱,例如 root。 |
password |
string | 在目標 ESXi 主機上具有管理權限的使用者的密碼。 |
deployment_network |
string | 要連線應用裝置的網路名稱。
備註: 該網路必須可從目標
ESXi 主機進行存取。
如果目標 ESXi 主機只有一個網路,則忽略。 |
datacenter |
string | 您想要建立的特定資料中心。 |
cluster |
string | vSAN 或 vLCM 管理叢集的名稱。 |
compression_only |
布林值 | 將此值設定為 true ,以對 vSAN 叢集啟用壓縮。如果此參數設定為 true ,則 deduplication_and_compression 參數必須設定為 false 。 |
deduplication_and_compression |
布林值 | 將此值設定為 true ,以對 vSAN 叢集啟用壓縮和重複資料刪除。如果此參數設定為 true ,則 compression_only 參數必須設定為 false 。 |
cache_disk |
要用於快取之磁碟的 UUID 或正式名稱的清單。僅指定 SSD。 | |
capacity_disk |
要用於儲存之磁碟的 UUID 或正式名稱的清單。指定 SSD 或 HDD。 | |
enable_vlcm |
布林值 | 設定為 true ,以建立 vLCM 管理叢集。 |
datastore |
string | 您要在其中儲存應用裝置之組態檔和虛擬磁碟的資料存放區的名稱。
備註:
該資料存放區必須可從 ESXi 主機進行存取。 如果您使用精簡型磁碟模式,則資料存放區大小應至少有 25 GB 空間。 |
port |
整數 | 目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 您要在其上部署應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。 |
username |
string | 在目標 ESXi 主機上具有管理權限的使用者名稱,例如 root。 |
password |
string | 在目標 ESXi 主機上具有管理權限的使用者的密碼。 |
deployment_network |
string | 要連線應用裝置的網路名稱。
備註: 該網路必須可從目標
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 主機或 DRS 叢集只有一個網路,則忽略。 |
datacenter |
陣列 | 包含您要在其上部署應用裝置的目標 ESXi 主機或 DRS 叢集的 vCenter Server 資料中心。
如果資料中心位於資料夾或資料夾結構中,請將值指定為以逗點分隔的多個字串的清單。例如,
["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"]
如果目標
ESXi 主機是叢集的一部分,請將路徑指定為以逗號分隔的多個字串的清單。例如,
["cluster_name", "esxi-host.domain.com"]
備註: 值不區分大小寫。
|
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 工具執行個體。 |
名稱 | 類型 | 說明 |
---|---|---|
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 | 網路首碼長度。 僅當 網路首碼長度是子網路遮罩中設定的位元數。例如,如果子網路遮罩是 255.255.255.0,則二進位版本的首碼長度中包含 24 個位元,因此網路首碼長度為 24。 對於 IPv4 版本,值必須在 對於 IPv6 版本,值必須在 |
gateway |
string | 預設閘道的 IP 位址。 對於 IPv6 版本,值可以為 |
ports |
string | 選擇性。vCenter Server Appliance 用於直接 HTTP 連線的連接埠號碼。依預設,連接埠 80 會將要求重新導向至 HTTPS 連接埠 443。您可以自訂 vCenter Server HTTP 和 HTTPS 連接埠。若要指定自訂 HTTP 和 HTTPS 連接埠號碼,請確保不會使用已由 vCenter Server 使用的連接埠或預設 HTTP 和 HTTPS 連接埠 80 和 443。 用於指定自訂連接埠的選項為: 下列範例將連接埠 81 和 444 分別指定為 HTTP 和 HTTPS 連接埠: ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"} 如需有關 vCenter Server 使用的連接埠的詳細資訊,請參閱 vCenter Server 所需的連接埠。 |
system_name |
string | 主要網路身分識別。 可以是 IP 位址或 FQDN,最好是 FQDN。 您無法在部署後變更此參數的值。 FQDN 和以點分隔的十進位數必須符合 RFC 1123 準則。 |
名稱 | 類型 | 說明 |
---|---|---|
password |
string | 應用裝置作業系統的根使用者密碼。 密碼必須包含 8 至 20 個字元,至少一個大寫字元、一個小寫字元、一個數字,以及一個特殊字元,例如,貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元必須僅包含不含空格的下部 ASCII 字元。 |
ntp_servers |
字串或陣列 | 選擇性。用於時間同步化之一或多部 NTP 伺服器的主機名稱或 IP 位址。
若要設定多個 NTP 伺服器,請使用以逗點分隔的多個字串的清單或是以逗點分隔的做為單個字串的清單來提供路徑。例如,
["x.y.z.a", "x.y.z.b"]或 "x.y.z.a, x.y.z.b" |
ssh_enable |
Boolean | 設定為 true ,以便 SSH 管理員登入應用裝置。
備註:
vCenter Server Appliance 高可用性需要對應用裝置的遠端 SSH 存取權。
|
time_tools_sync |
Boolean | 選擇性。設定為 如果已設定 NTP 伺服器進行時間同步化,也就是說如果已設定 |
名稱 | 類型 | 說明 |
---|---|---|
password |
string | vCenter Single Sign-On 管理員使用者的密碼 administrator@your_domain_name。 如果要將 vCenter Server Appliance 部署為新 vCenter Single Sign-On 網域的第一個執行個體,則必須為 vCenter Single Sign-On 管理員使用者設定密碼。 密碼必須包含 8 至 20 個字元,至少一個大寫字元、一個小寫字元、一個數字,以及一個特殊字元,例如,貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元都必須為 ASCII 字元。 |
domain_name |
string | vCenter Single Sign-On 網域名稱,例如 vsphere.local。 如果要將 vCenter Server Appliance 部署為新 vCenter Single Sign-On 網域的第一個執行個體,則必須為新的 vCenter Single Sign-On 網域設定密碼。 |
replication_partner_hostname |
string | 合作夥伴 vCenter Server 的系統名稱。 僅當您部署現有 vCenter Single Sign-On 網域中的複寫合作夥伴時需要。 |
sso_port |
整數 | 合作夥伴 vCenter Server 的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當合作夥伴使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
ceip
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
ceip_enabled |
Boolean | 設定為 true 以加入此應用裝置的 CEIP。 |