機械翻訳について

クラウド・エージェントをインストールするためのパラメータ

このセクションでは、クラウド・エージェントのインストールに必要なパラメータについて説明します。

クラウド・エージェントをインストールする場合は、レスポンス・ファイル(agent.rsp)を編集して、クラウド・エージェントのインストールに必要なパラメータの値を指定する必要があります。

次に、レスポンス・ファイルで指定されているパラメータのリストを示します:

レスポンス・ファイルのサンプルについては、「サンプル・レスポンス・ファイル」を参照してください。

登録パラメータ

このセクションでは、クラウド・エージェントをインストールするために必要な登録パラメータを示します。 すべての登録パラメータは必須です。 レスポンス・ファイルが次のパラメータの正しい値を持っていることを確認してください。

パラメータ パラメータ・タイプ 説明 ノート

TENANT_NAME

または

TENANT_ID (旧バージョンでサポートされており、下位互換性を維持しています)

必須

Oracle Management Cloudが実行されているテナントの名前。 エージェントのTENANT_NAME値は、「管理」> 「エージェント」> 「ダウンロード」にナビゲートし、「エージェント・タイプ」ドロップダウン・リストからエージェントのタイプを選択することで取得できます。 TENANT_NAMEの値がページの下部に表示されます。

例: inst1-dummytenantid

AGENT_REGISTRATION_KEY

必須

テナントのアイデンティティとインストールの信頼性を検証するためのキー。 Oracle Management Cloudダッシュボードから「管理」> 「エージェント」> 「登録キー」に移動して、登録キーを取得できます。

例: R5bokWss0EC9R1pJlf2SqiAJ9p

AGENT_BASE_DIRECTORY

オプショナル

エージェントがホスト・マシンにインストールされる必要がある空のディレクトリ。

パラメータ値が指定され、指定された値(ディレクトリ)が存在しない場合、インストーラによってディレクトリが作成されます。

パラメータAGENT_BASE_DIRECTORYが指定されていない場合、インストーラは、インストーラの実行元のディレクトリに新規ディレクトリomcagentを作成します。

注意: Windowsの場合、ドライブ文字を含むディレクトリ・パスの長さは23文字未満である必要があります。

例:

Linux: /omc_agent/dc

Windows: D:\omc_agent\dc

通信パラメータ

このセクションでは、クラウド・エージェントをインストールするために必要な通信パラメータを示します。

パラメータ パラメータ・タイプ 説明 ノート

OMC_URL

または

UPLOAD_ROOT (旧バージョンでサポートされており、下位互換性を維持しています)

必須

特定のTENANT_NAMEのデータをアップロードするためにOracle Management Cloudに接続するために必要なプロトコルを含む絶対URL。 この値を取得するには、「管理」> 「エージェント」> 「ダウンロード」に移動し、「エージェント・タイプ」ドロップダウン・リストからエージェント・タイプを選択します。 OMC_URLの値がページの下部に表示されます。

例: https:/dummytenantid.itom.<datacenter>.oraclecloud.com

GATEWAY_HOST

クラウド・エージェントがゲートウェイを介して通信する場合は必須です

クラウド・エージェントまたはデータ・コレクタがゲートウェイを使用してOMCと通信している場合は、ゲートウェイの完全修飾ドメイン名(FQDN)を指定します。 クラウド・エージェントをインストールするときは、ゲートウェイのインストールに使用したのと同じゲートウェイ・ホスト名を指定してください。

たとえば、ゲートウェイをデプロイするときにORACLE_HOSTANME=abc.xyz.comを指定し、クラウド・エージェントをインストールするときにGATEWAY_HOST=abcを指定すると、クラウド・エージェントの登録に失敗します。 ゲートウェイ・エージェントは、ホスト上にインストールされていて、稼動している必要があります。

例: GATEWAY_HOST=testgateway.test.oracle.com

GATEWAY_PORT

クラウド・エージェントがゲートウェイを介して通信する場合は必須です

クラウド・エージェントまたはデータ・コレクタがゲートウェイを使用してOMCと通信する場合は、ゲートウェイ・ポートを指定する必要があります。

次のコマンドを実行すると、ポート番号を取得できます:

$Gateway_Agent_Home/agent_inst/bin/omcli status agent

例: GATEWAY_PORT=4472

ADDITIONAL_GATEWAYS

クラウド・エージェントがゲートウェイを介して通信する場合は必須です

ゲートウェイの高可用性のために、追加のゲートウェイ・ホスト(カンマで区切られたゲートウェイURLのリスト)を指定できます。 各ゲートウェイ・ホストで次のコマンドを実行すると、URLを取得できます:

$Gateway_Agent_Home/agent_inst/bin/omcli status agent

注意:このパラメータは、クラウド・エージェントまたはデータ・コレクタのデプロイ時にのみ使用する必要があります。

例 : ADDITIONAL_GATEWAYS=https://abc.us.com:1872,https://xyz.us.com:4475

プロキシ・パラメータ(オプション)

プロキシ・サーバー上にクラウド・エージェントをインストールする場合は、「登録パラメータ」「通信パラメータ」を指定する以外に、レスポンス・ファイルに次のパラメータの正しい値を指定してください。

パラメータ 説明 ノート

OMC_PROXYHOST

接続に使用するプロキシ・サーバーのアドレス。 プロキシ・ホストの詳細にhttps://値を渡さないようにしてください。

プロキシ・サーバー経由でエージェントをデプロイする場合にのみ必要です。

例: www-proxy.company.com

OMC_PROXYPORT

プロキシ・サーバーのポート。

プロキシ・サーバー経由でエージェントをデプロイする場合にのみ必要です。

例: 80

OMC_PROXYUSER

プロキシ・サーバーへのアクセスに必要なユーザー名。

Oracle Management Cloudと通信するためにプロキシ・サーバーを使用している場合のみ必要です。 ユーザー名とパスワードが必要です。

例: johndoe

OMC_PROXYPWD

プロキシ・サーバーへのアクセスに必要なパスワード。

プロキシ・サーバー経由でエージェントをデプロイする場合にのみ必要です。

OMC_PROXYREALM

プロキシ・サーバーへのアクセスに使用する認証レルム(ある場合)。

プロキシ・サーバー経由でエージェントをデプロイする場合にのみ必要です。

例: MyServer

その他のオプション・パラメータ

このセクションでは、クラウド・エージェントをインストールするためにレスポンス・ファイルでオプションで指定できるパラメータをリストします。 ただし、レスポンス・ファイルに「登録パラメータ」および「通信パラメータ」の値が含まれていることを確認する必要があります。

パラメータ 説明 ノート

AGENT_PORT

エージェント・プロセスがバインドされるポート番号。 AgentInstallスクリプトは、このポートがインストール時に使用されていた場合、インストール処理を停止します。

値を指定しない場合、デフォルトのポート(4459)または4460の範囲内の使用可能なポート-4479が使用されます。

これは新しいインストールにのみ適用されます。 古いエージェントが他のポート番号ですでに実行されている場合は、そのまま実行することができます。

例: 4461

ORACLE_HOSTNAME

エージェントがインストールされるホスト名。 指定されている場合、値はエージェント・ホスト名に似ているかどうか、またIPアドレスでも迷惑メールでもないことを確認するために検証されます(foobartestなど)。 これは、/etc/hosts (UNIXの場合)およびC:\Windows\System32\drivers\etc\hosts (Windowsの場合)ファイルで指定された完全修飾ドメイン名(FQDN)と一致する必要があり、ホストの正しいFQDNおよびIPアドレスにマップする必要があります。

注意:インストーラで計算されたホスト名の代わりにネットワークで解決可能なホスト名を指定する場合は、このパラメータを使用します。

注意: Oracle Management CloudのほとんどのサービスはホストがFQDNである必要があるため、パラメータが完全修飾ドメイン名であることを確認してください。 有効なIPアドレスに解決する必要があります。

例: example.tst.acme.com

値を指定しない場合、AgentInstallスクリプトはINetAddress Javaクラス・メソッドを使用してホスト名を評価します。

REINSTALL

エージェントによる再インストール・オプションを有効化するフラグ。

詳細は、「再インストール・オプションを使用したクラウド・エージェントのインストール」を参照してください。

  • 有効な値: trueまたはfalse

  • デフォルト値: false

    エージェント再インストール・オプションを有効にするには、値をtrueREINSTALL=trueに変更します。

IGNORE_VALIDATIONS

すべての検証と前提条件検査を無効にするフラグ。

  • 有効な値: trueまたはfalse

  • デフォルト値: false

    検証を無視するには、値をtrueIGNORE_VALIDATIONS=trueに変更します。

IGNORE_ULIMIT_CHECK

ulimitチェックを無効にするフラグです(Windows以外のプラットフォームの場合のみ)。

  • 有効な値: trueまたはfalse

  • デフォルト値: false

    ulimitチェックを無視するには、値をtrueIGNORE_ULIMIT_CHECK=trueに変更します。

DISPLAY_NAME

ユーザーが指定したテナント管理エージェントの表示名。

デフォルト値は<agent host>です: <agent port>。 たとえば、myhost:4459。

AGENT_HOST_DISPLAY_NAME

ユーザーが指定したテナント管理エージェント・ホストの表示名。

デフォルト値は<agent host>です: <agent port>。 たとえば、myhost:4459。