CLI アップグレード用の JSON 構成ファイルを準備する場合、vCenter Server Appliance または Platform Services Controller アプライアンスのアップグレード用の入力データを提供するため、パラメータや値を設定する必要があります。
JSON アップグレード ファイルの構成パラメータのセクションとサブセクション
CLI アップグレード用の JSON 構成ファイルの構成パラメータは、セクションとサブセクションで構成されます。
セクション | サブセクション | 説明 |
---|---|---|
new_vcsa - デプロイする新しいアプライアンスについて記述します。 |
esxi |
ESXi ホストに新しいアプライアンスを直接デプロイする場合のみ使用します。
ターゲット
ESXi ホストに関する構成パラメータが含まれます。
new_vcsa セクション、esxi サブセクションの構成パラメータを参照してください。
注: このサブセクションまたは
vc サブセクションのいずれかに記述する必要があります。
|
vc |
vCenter Server インスタンスのインベントリに新しいアプライアンスをデプロイする場合のみ使用します。 ターゲット ESXi ホストまたは vCenter Server インベントリの 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 インスタンスで移行アシスタントを自動的に実行する場合に使用します。 |
run_migration_assistant |
アップグレードするソース vCenter Server Appliance が Windows 仮想マシン上で実行される VMware Update Manager インスタンスに接続している場合のオプションです。ソースの vSphere Update Manager インスタンスで移行アシスタントを自動的に実行する場合は、このサブセクションを使用します。 ソースの vSphere Update Manager インスタンスに関する構成パラメータが含まれます。これらは、新しくアップグレードされた vCenter Server Appliance に移行されます。
注:
Migration Assistant はデフォルトでポート 9123 を使用します。
Update Manager マシン上の別のサービスによってポート 9123 が使用されている場合、
Migration Assistant によって自動的に他の空きポートが検出されます。
Migration Assistant 用のカスタム ポートを設定することはできません。
|
ceip - VMware カスタマ エクスペリエンス改善プログラム (CEIP) への参加について記述します。 |
settings |
VMware カスタマ エクスペリエンス改善プログラム (CEIP) に参加するかどうかを設定する Platform Services Controller が組み込まれた vCenter Server Appliance または Platform Services Controller アプライアンスをアップグレードする場合にのみ必要です。
注:
ceip_enabled 構成パラメータが
true に設定されている場合は、CLI のデプロイ コマンドに
--acknowledge-ceip の引数をつけて実行する必要があります。
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 |
文字列 | 新しいアプライアンスをデプロイするターゲット ESXi ホストの IP アドレスまたは完全修飾ドメイン名 (FQDN)。 |
username |
文字列 | root など、ターゲット ESXi ホストの 管理権限を持つユーザー名。 |
password |
文字列 | ターゲット ESXi ホストの管理権限を持つユーザーのパスワード。 |
deployment_network |
文字列 | 新しいアプライアンスを接続するネットワーク名。 ネットワークは、ターゲット ESXi ホスト、または(
注: ネットワークには、アップグレードするアプライアンスが配置されているソース
ESXi ホストまたは(
managing_esxi_or_vc 構成パラメータで識別される)
vCenter Server Appliance インスタンスからアクセスできる必要があります。アップグレードを実行するクライアント マシンからネットワークにアクセスできる必要があります。
ターゲット ESXi ホストが 1 つしかネットワークを持たない場合、無視されます。 |
datastore |
文字列 | 新しいアプライアンスの仮想マシンの構成ファイルおよび仮想ディスクを格納するデータストアの名前。 データストアは、ターゲット ESXi ホストから使用可能である必要があります。
注: データストアには、25 GB 以上の空き容量が必要です。
|
port |
整数型 | ターゲットの ESXi ホストの HTTPS リバース プロキシ ポート。 デフォルトのポートは 443 です。ターゲットの ESXi ホストがカスタムの HTTPS リバース プロキシ ポートを使用する場合のみ使用します。 |
ssl_certificate_verification |
文字列 | CLI は、サーバのセキュリティ証明書に認証局 (CA) の署名が付いていることを検証して、セキュアな接続を確立します。証明書が自己署名証明書の場合、CLI は次の SSL 証明書構成オプションのいずれかが指定されている場合を除いて、アップグレードを停止します。 Secure Hash Algorithm 1 (SHA-1) の証明書サムプリントを指定します。証明書サムプリントは、証明書を一意に識別する 16 進数の文字列です。サムプリントは、サムプリント アルゴリズムを使用して証明書の内容から計算されます。 "thumbprint": "certificate SHA-1 thumbprint"
"verification_mode": "NONE" 自己署名証明書を持つサーバに接続しているときに、SHA-1 証明書サムプリントの指定に失敗するか、または検証モードを vcsa-deploy upgrade コマンド パラメータ |
名前 | タイプ | 説明 |
---|---|---|
hostname |
文字列 | 新しいアプライアンスをデプロイするターゲット vCenter Server インスタンスの IP アドレスまたは FQDN。 |
username |
文字列 | ターゲット vCenter Server インスタンスの vCenter Single Sign-On 管理者ユーザー名。例: [email protected]。 |
password |
文字列 | ターゲットの vCenter Server インスタンスの vCenter Single Sign-On 管理者ユーザーのパスワード。 |
deployment_network |
文字列 | 新しいアプライアンスを接続するネットワーク名。 ネットワークは、ターゲット ESXi ホストまたは DRS クラスタ ネットワーク構成に含まれている必要があります。
注: ネットワークには、アップグレードするアプライアンスが配置されているソース
ESXi ホストからアクセスできる必要があります。アップグレードを実行するクライアント マシンからネットワークにアクセスできる必要があります。
ターゲットの ESXi ホストまたは DRS クラスタが 1 つしかネットワークを持たない場合は、無視されます。 |
datacenter |
文字列または配列 | 新しいアプライアンスをデプロイするターゲットの ESXi ホストまたは DRS クラスタを含む vCenter Server データセンター。
データセンターがフォルダまたはフォルダ構造の中に配置されている場合、値は複数の文字列をカンマ区切りで入力するか、カンマ区切りの複数の文字列を単一の文字列として入力します。次に例を示します。
["parent_folder", "child_folder", "datacenter_name"]または "parent_folder, child_folder, datacenter_name" データセンターのフォルダ パスがない場合は、データセンターの名前のみを使用します。次に例を示します。 ["datacenter_name"]または "datacenter_name"
注: 値は大文字と小文字を区別します。
|
datastore |
文字列 | 新しいアプライアンスのすべての仮想マシンの構成ファイルおよび仮想ディスクを格納するデータストアの名前。
注: データストアは、ターゲット
ESXi ホストまたは DRS クラスタから使用可能である必要があります。
データストアには、25 GB 以上の空き容量が必要です。 |
port |
整数 | ターゲット vCenter Server インスタンスの HTTPS リバース プロキシ ポート。 デフォルトのポートは 443 です。ターゲット vCenter Server インスタンスがカスタム HTTPS リバース プロキシ ポートを使用する場合のみ使用します。 |
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 |
文字列 | オプション。新しいアプライアンスの追加先の仮想マシン フォルダ名。 |
名前 | タイプ | 説明 |
---|---|---|
thin_disk_mode |
Boolean | シン仮想ディスクを搭載する新しいアプライアンスをデプロイするには、true に設定します。 |
deployment_option |
文字列 | 新しいアプライアンスのサイズ。
注: アップグレードするアプライアンスのデータベース サイズを検討する必要があります。外部データベースの場合は、
新しいアプライアンスの Oracle データベース サイズとストレージ サイズの特定を参照してください。
|
image |
文字列 | オプション。vCenter Server Appliance インストール パッケージへのローカル ファイル パスまたは URL デフォルトでは、インストーラは、vcsa フォルダの ISO ファイルに含まれるインストール パッケージを使用します。 |
name |
文字列 | 新しいアプライアンスの仮想マシン名。 パーセント記号 (%)、バックスラッシュ (\)、スラッシュ (/) 以外の ASCII 文字しか含めることはできません。また、80 文字未満である必要があります。 |
ovftool_path |
文字列 | オプション。OVF ツール実行ファイルへのローカル ファイル パス デフォルトでは、インストーラは、vcsa/ovftool フォルダの ISO ファイルに含まれる OVF ツール インスタンスを使用します。 |
名前 | タイプ | 説明 |
---|---|---|
ip_family |
文字列 | 新しいアプライアンスの一時ネットワークの IP アドレス バージョン。
|
mode |
文字列 | 新しいアプライアンスの一時ネットワークの IP アドレス割り当て。
|
ip |
文字列 | 新しいアプライアンスの一時 IP アドレス。 固定割り当てを使用する場合、つまり、 一時ネットワークの IP バージョン、つまり、 IPv4 アドレスは、RFC 790 ガイドラインに準拠する必要があります。 IPv6 アドレスは、RFC 2373 ガイドラインに準拠する必要があります。 |
dns_servers |
文字列値または配列値 | 新しいアプライアンスの一時ネットワークの 1 つ以上の DNS サーバの IP アドレス。
複数の DNS サーバを設定するには、文字列のカンマ区切りのリストか単一の文字列としてのカンマ区切りのリストを使用します。次に例を示します。
["x.y.z.a", "x.y.z.b"]または "x.y.z.a, x.y.z.b" 一時 IP アドレス割り当てに固定ネットワーク モードを使用する場合、つまり、 |
prefix |
文字列 | 新しいアプライアンスの一時ネットワークのネットワーク プリフィックス長。
ネットワーク プリフィックス長は、サブネット マスクに設定されているビット数です。たとえば、サブネット マスクが 255.255.255.0 である場合は、バイナリ バージョンのプリフィックス長は 24 ビットとなるため、ネットワーク プリフィックス長は 24 になります。 IPv4 バージョンの場合、値は、 IPv6 バージョンの場合、値は、 |
gateway |
文字列 | 新しいアプライアンスの一時ネットワークのデフォルト ゲートウェイの IP アドレス。 IPv6 バージョンの場合、値を |
名前 | タイプ | 説明 |
---|---|---|
vcdb_migrateSet |
文字列 | 古いアプライアンスから新しいアプライアンスに移行するデータのタイプを選択します。データは、ソース vCenter Server からターゲット サーバにコピーされます。データの移行元は変更されません。
注: 新しい vCenter Server アプライアンスで必要となるアップグレード時間およびストレージ量を最小限に抑えるには、
core 値を使用します。
既存の vCenter Server から新しい vCenter Server に転送できるデータ タイプの詳細については、既存の vCenter Server Appliance からのデータ転送を参照してください。 |
source_vc
セクションの構成パラメータ
名前 | タイプ | 説明 |
---|---|---|
hostname |
文字列 | アップグレードするアプライアンスが配置されているソース ESXi または vCenter Server ホストの IP アドレスまたは FQDN。 |
username |
文字列 | ソース ESXi ホストの root などの管理権限を持つユーザー名。 |
password |
文字列 | ソース ESXi ホストの管理権限を持つユーザーのパスワード。 |
port |
整数 | ソース ESXi ホストの HTTPS リバース プロキシ ポート。 デフォルトのポートは 443 です。ソースの ESXi ホストがカスタム HTTPS リバース プロキシ ポートを使用する場合のみ使用します。 |
名前 | タイプ | 説明 |
---|---|---|
hostname |
文字列 | アップグレードするソース アプライアンスの IP アドレスまたは完全修飾ドメイン名 (FQDN)。 |
username |
文字列 | [email protected] などのソース アプライアンスの vCenter Single Sign-On 管理者ユーザー。
重要: ユーザーは、administrator@
your_domain_name である必要があります。
|
password |
文字列 | ソース アプライアンスの vCenter Single Sign-On 管理者ユーザーのパスワード。 |
root_password |
文字列 | ソース アプライアンスのオペレーティング システムの root ユーザーのパスワード。 |
export_dir |
文字列 | ソースの構成とデータをエクスポートするディレクトリ。 |
source.vum
セクションの構成パラメータ
名前 | タイプ | 説明 |
---|---|---|
esxi_hostname |
文字列 | ソースの vSphere Update Manager インスタンスが存在する ESXi ホストの IP アドレスまたは完全修飾ドメイン名 (FQDN)。 FQDN を指定する場合、アップグレードを実行するクライアント マシンから解決できる必要があります。 |
esxi_username |
文字列 | root など、ESXi ホストの管理権限を持つユーザー名。 |
esxi_password |
文字列 | ESXi ホストの管理権限を持つユーザーのパスワード。 |
esxi_port |
文字列 | ESXi ホストの HTTPS リバース プロキシ ポート。 デフォルトのポートは 443 です。ESXi ホストがカスタム HTTPS リバース プロキシ ポートを使用する場合のみ使用します。 |
vum_hostname |
文字列 | ソース VMware Update Manager インスタンスが動作する Windows 仮想マシンの IP アドレスまたは完全修飾ドメイン名 (FQDN)。 FQDN を指定する場合、アップグレードを実行するクライアント マシンから解決できる必要があります。 |
vum_os_username |
文字列 | ソース VMware Update Manager インスタンスが動作する Windows 仮想マシンの管理者ユーザー名。 |
vum_os_password |
文字列 | ソース VMware Update Manager インスタンスが動作する Windows 仮想マシンの管理者パスワード。 指定されていない場合は、テンプレートの検証時に、コマンド コンソールでパスワードを入力するよう求められます。 |
export_dir |
文字列 | ソースの構成とデータをエクスポートするディレクトリ。 |
ceip
セクションの構成パラメータ
名前 | タイプ | 説明 |
---|---|---|
ceip_enabled |
Boolean | 新しくアップグレードされるアプライアンスの CEIP に参加するには、true に設定します。 |