管理ゲートウェイのインストール

管理ゲートウェイをインストールするには、次の手順に従います。

管理ゲートウェイ・ソフトウェアのダウンロード

ゲートウェイ・ソフトウェアをダウンロードするには、次の手順を実行します:

管理エージェントのホーム・ページで、左側のメニューの「ダウンロードとキー」をクリックして、「ソフトウェア・ダウンロード」ペインを表示します。

「ソフトウェアのダウンロード」ペインがページの上部に表示されます。
「ソフトウェアのダウンロード」ペインには、管理エージェントと管理ゲートウェイについてダウンロードできるすべてのソフトウェアがリスト表示されます。

管理ゲートウェイをインストールするオペレーティング・システムを「ダウンロード」列から選択します。
オペレーティング・システムに対応するリンクをクリックして、管理ゲートウェイ・ソフトウェア・ファイルをダウンロードします。

たとえば、LINUXの場合は「LINUXのゲートウェイ」、WINDOWSの場合は「WINDOWSのゲートウェイ」をクリックします。

「ソフトウェアのダウンロード」とソフトウェア・ファイルをダウンロードするためのリンクが上部に表示されているダウンロードとキーのページ。

これで、管理ゲートウェイ・ソフトウェア・ファイルがホストに保存されました。

ファイルの整合性を検証するには、SHA-256 Checksum列の値が次のコマンドの出力と一致するかどうかを確認します: sha256sum <download_file.rpm>

ノート

ゲートウェイ・ソフトウェア・イメージのダウンロードURLは、agent-image list CLIコマンドまたは有効なOCI認証を使用したListManagamentAgents APIを介してのみ使用できます。詳細は、CLIを使用したゲートウェイ・ソフトウェアのダウンロードを参照してください。

CLIを使用したGatewayソフトウェアのダウンロード

CLIを使用して管理ゲートウェイ・ソフトウェアをダウンロードするには、次を実行します:

agent- image list CLIコマンドと --install-type GATEWAYオプションを使用して、object-url値を取得します。
```
oci management-agent agent-image list --compartment-id <tenancyId> --install-type GATEWAY
```
戻り値のobject-urlは次のようになります。
https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_gateway.rpm
前述の<namespace>および<bucketName>値をノートにとります。
ステップ1の<namespace>および<bucketName>値を使用して、OCI認証済プリンシパルを持つ管理ゲートウェイ・ソフトウェアをダウンロードします:
```
oci os object get --namespace <namespace> --bucket-name  <bucketName> --name Linux-x86_64/latest/oracle.mgmt_gateway.rpm  --file oracle.mgmt_gateway.rpm
```
ファイルの整合性を確認するには、SHA-256 Checksum列の値が次のコマンドの出力と一致するかどうかを確認します: sha256sum <download_file>

Oracle Cloud Infrastructure (OCI)コマンドライン・インタフェース(CLI)は、コマンドライン・インタフェース・ツールです。詳細については、Command Line Interface (CLI)を参照してください。

ノート

object-url値を取得するには、管理エージェントAPI ListManagementAgentImagesをinstallType=GATEWAYオプションとともに使用することもできます。

インストール・キーの作成

管理ゲートウェイのインストールを実行する前に、インストール・キーを作成する必要があります。

インストール・キーはアイデンティティ・ドメインに対して発行され、インストールの信頼性を検証します。管理ゲートウェイのインストール・プロセスを開始する前にこれを作成したことを確認してください。

インストール・キーの作成方法の詳細は、インストール・キーの作成を参照してください。

ノート

このステップは1回のみ実行できます。管理ゲートウェイと管理エージェントのインストールでは同じインストール・キーを使用できます。

管理ゲートウェイのレスポンス・ファイルの構成

管理ゲートウェイのインストール・スクリプトは、レスポンス・ファイルを使用して、環境固有のパラメータを読み取ります。

管理ゲートウェイ・パラメータの確認

ゲートウェイ設定スクリプトを実行する際には、ゲートウェイ・パラメータを含むレスポンス・ファイルが必要です。

次の項では、レスポンス・ファイルでサポートされるパラメータについて説明します:

表7-2 レスポンス・ファイルのパラメータ

パラメータ名	パラメータ・タイプ	説明
`ManagementAgentInstallKey`	必須	ドメインのアイデンティティとインストールの信頼性を検証するために必要なインストール・キー。
`AgentDisplayName`	オプション	インストールするゲートウェイの表示名。これは一意の値です。指定しない場合は、デフォルト値が割り当てられます。
`BatchingEnabled`	オプション	管理ゲートウェイのインストール時にバッチ処理機能を有効にします。 `BatchingEnabled=true`を使用して有効にし、ログ・アナリティクス・サービスへのロギング・アップロードをより適切かつ迅速に管理します。
`CredentialWalletPassword`	オプション	ゲートウェイ・ウォレットのパスワード(ユーザーが機密情報を格納するウォレットのカスタム・パスワードとして指定する場合)。パスワードの長さは8文字以上で仕様は次のとおりです: 少なくとも1つの小文字(a-z) 少なくとも1つの大文字(A-Z) 少なくとも1つの数字(0-9) 次の特殊文字を少なくとも1つ: !、@、#、%、^、&、*' パスワードの文字はすべて、前述の文字を使用する必要があります。たとえば、パスワードの一部に`$`文字が含まれる場合、そのパスワードは有効性チェックに合格しません。`$`は前述の特殊文字の中にないためです。
`GatewayPort`	オプション	エージェント(管理エージェントを含む)によって管理ゲートウェイへの接続時に使用されるポート番号。このポート番号を指定しない場合、値はデフォルトで4480に設定されます。
`GatewayUsername`	オプション	ゲートウェイ・サーバーでの認証に使用されるユーザー名。指定した場合、すべてのクライアントが認証にこのユーザー名を指定する必要があります。指定しない場合、ゲートウェイで認証は必要ありません。
`GatewayPassword`	オプション	ゲートウェイ・サーバーでの認証に使用されるパスワード。指定した場合、すべてのクライアントが認証にこのパスワードを指定する必要があります。指定しない場合、ゲートウェイで認証は必要ありません。
`GatewayCertOcid`	オプション	ゲートウェイHTTPSサポートに使用されるOCI証明書のOCID。証明書は、ゲートウェイのインストール先と同じコンパートメントにある必要があります。
`GatewayCertCommonName`	オプション	ユーザーが管理ゲートウェイ・ホストの完全修飾ドメイン名(FQDN)を指定しました。これは、インストールの一部として自動証明書作成プロセス中に「共通名」として使用されます(自動証明書作成プロセスを参照)。デフォルトでは、管理ゲートウェイはこのプロパティの値として`hostname -f`にデフォルト設定されます。
`ProxyHost`	オプション	外部向けのプロキシまたはファイアウォールのホスト名またはアドレス。管理ゲートウェイは、このプロキシ・ホスト(サーバー)を使用してOCIに接続します。指定した場合は、`ProxyPort`も指定する必要があります。
`ProxyPort`	オプション	外部向けのプロキシまたはファイアウォールのプロキシ・サーバー・ポート番号。指定した場合は、`ProxyHost`も指定する必要があります。
`ProxyUser`	オプション	外部向けのプロキシまたはファイアウォールで認証するためのユーザー名。指定した場合は、`ProxyPassword`も指定する必要があります。
`ProxyPassword`	オプション	外部向けのプロキシまたはファイアウォールで認証するためのユーザー・パスワード。指定した場合は、`ProxyUser`も指定する必要があります。
`ProxyRealm`	オプション	外部向けのプロキシまたはファイアウォールの認証レルム。
`DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}]`	オプション	OCIでタグを使用する場合のタグ・メタデータの関連付け。タグ管理者がすべてのタグを作成および管理し、ユーザーがそれらをリソースに適用します。ユーザーはタグ・ポリシーを定義しておく必要があります。タグ・ネームスペースは、タグ・キーのコンテナです。タグ・キーはネームスペース内のキーです。ネームスペース内の定義済タグに対してタグ・キーを作成する必要があります。定義済タグでは、タグ値のタイプが文字列または文字列リストのいずれかになります。タグ値タイプを定義する際に、定義されたタイプが文字列である場合は、任意の値を入力できます。一方、文字列リストである場合、この値はそのリストのいずれかの文字列である必要があります。
`FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}]`	オプション	OCIでタグを使用する場合のタグ・メタデータの関連付け。これはキーと値で構成されます。キーは、タグを参照するために使用する任意の名前です。値は、タグを適用するユーザーがタグ・キーに追加する値です。「高可用性」では、このパラメータを構成することをお薦めします。詳細は、管理ゲートウェイの高可用性のためのレスポンス・ファイルの構成を参照してください。「関連付けられたエージェント」で、この管理ゲートウェイを介して接続する管理エージェントがある場合は、`"GatewayGroup"`という名前のタグを追加します。たとえば: `"GatewayGroup":"<User_Defined_ClusterName>`

管理ゲートウェイ・インストール用のレスポンス・ファイルの作成

進める前に、ゲートウェイ・パラメータの確認に記載されている内容を読んで理解したことを確認してください。

ゲートウェイをインストールおよび構成するには、レスポンス・ファイルを作成し、新たに作成したレスポンス・ファイルを使用してスクリプトを実行する必要があります。このレスポンス・ファイルが、ゲートウェイに正しいOCIリージョンを示し、ゲートウェイのためのリソースの作成を許可します。

レスポンス・ファイルを作成するには、次のいずれかのオプションを使用します:

オプション1: レスポンス・ファイル・テンプレートをダウンロードして、レスポンス・ファイルを作成します

ゲートウェイ・パラメータを含むテンプレート・ファイルをダウンロードできます。このテンプレート・ファイルを保存して、ゲートウェイのインストール時にレスポンス・ファイルとして使用することができます。

レスポンス・ファイル・テンプレートをダウンロードするには、「インストール・キー」リストの「キーをファイルにダウンロード」メニュー・オプションを使用します。

左側のメニューで「ダウンロードとキー」をクリックして、「インストール・キー」ペインを開きます。インストール・キーのリストから、ダウンロードするキーを選択します。
選択したキーの右側で、アクション・メニューをクリックし、「キーをファイルにダウンロード」を選択します。

ファイルがダウンロードされます。詳細は、インストール・キーのダウンロードを参照してください。

インストール・キーをファイルにダウンロードすると、ダウンロードされたファイルには、特定のインストール・キーなど様々なパラメータが含まれます。

ファイルをダウンロードした後で、環境に応じてカスタマイズする必要があります:

テキスト・エディタを使用してファイルを開き、確認してから、必須のゲートウェイ・パラメータを編集します。管理ゲートウェイ・パラメータの確認を参照してください。
Service.plugin.*パラメータを削除します。これはエージェント固有のパラメータです。エージェントのインストールにのみ使用されます。
特定のゲートウェイ構成で必要なゲートウェイ・パラメータは、コメント解除(行の先頭の#記号を削除)し、ゲートウェイ・パラメータ値を更新します。たとえば、GatewayPort、GatewayUsernameおよびGatewayPasswordパラメータをファイルに追加する必要があります。
特定のゲートウェイ構成で不要なパラメータは、コメント・アウト(行の先頭に#記号を追加)するか削除します。
更新したレスポンス・ファイルを保存します。たとえば、gateway.rspレスポンス・ファイルとして保存できます。

オプション2: テキスト・エディタを使用してレスポンス・ファイルを作成します

レスポンス・ファイルは、テキスト・エディタを使用して手動で作成できます。たとえば、任意のテキスト・エディタを使用してファイルを作成し、ゲートウェイ構成に必要なゲートウェイ・パラメータをそのレスポンス・ファイルに追加して保存します。たとえば、レスポンス・ファイルはgateway.rspとして保存できます。

gateway.rspレスポンス・ファイルのサンプル:

managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5

前述のオプションのいずれかを使用してレスポンス・ファイルを作成した後で、ファイルの権限を確認し、mgmt_agentユーザーの読取り権限があることを確認します。