1. Oracle E-Business Suiteの健全性とパフォーマンスをモニターおよび分析する
  2. 一般的な前提条件タスクの実行

一般的な前提条件タスクの実行

Oracle E-Business Suite環境を監視するようにOracle Management Cloudを設定するには、汎用タスクのセットを実行する必要があります。

Enterprise Editionライセンスを有効にする

Oracle Management Cloudオファリングは、Enterprise Editionを含む様々なライセンス・エディションに分類されて使用できます。

Oracle Management Cloud – Enterprise Editionには次の機能があります。

  • Oracle Application Performance Monitoring:アプリケーションを監視および管理するためのプラットフォームを提供します。

  • Oracle Infrastructure Monitoring:単一のプラットフォームから情報テクノロジ・インフラストラクチャ全体のステータスおよび状態をモニターし、問題について管理者に警告します。

  • Oracle Orchestration: REST APIをコールするか、サードパーティの自動化フレームワークを使用して、クラウドとオンプレミス・インフラストラクチャを自動化し、タスクを実行します。

  • Oracle IT Analytics:アプリケーションとインフラストラクチャの投資のパフォーマンス、可用性、容量に関する360-degreeの洞察を提供します。

Oracle Management Cloudの有効化- Oracle Cloud InfrastructureシステムおよびOracle E-Business Suiteの両方についてEnterprise Edition。

  1. Oracle Management Cloud管理者としてOracle Management Cloudコンソールにログインします。
    「管理クラウド」ナビゲーション・ペインが表示されない場合は、左上隅にある「OMCナビゲーション」アイコンをクリックします。
  2. Oracle Management Cloudコンソールのナビゲーション・ペインから、「管理」、「エンティティ構成」の順にクリックします。
  3. 「ライセンス」をクリックし、「エンティティの選択」をクリックします。
  4. 必要なエンティティを検索して選択し、「選択」ボタンをクリックします。
  5. リストされているエンティティごとに「Enterprise Edition」を選択するか、「ライセンス・エディション」をクリックし、「すべてをEnterpriseに設定」を選択します。
  6. 「保存」をクリックします。

Oracle Management Cloud Agentのインストール

モニタリング・メトリックを取得するOracle Management Cloudエージェントをインストールします。

  • ゲートウェイ・エージェント: Oracle Management Cloudへのインターネット・アクセス権があるホストにゲートウェイ・エージェントをインストールし、クラウド・エージェントがデプロイされているすべてのホストからアクセスできます。すべてのOracle Management Cloudエージェントが共通ゲートウェイを使用する必要があります。

  • クラウド・エージェント: Oracle E-Business Suiteトポロジ内の各ホスト上にクラウド・エージェントをインストールして、そのホストに存在するエンティティからデータ(メトリック、構成情報、ログなど)を監視および収集します。

エージェントをインストールする前に

Oracle E-Business Suiteにエージェントをインストールする前に、必ず次の考慮事項に従ってください。

エージェントをインストールするエージェントのベース・ディレクトリの場合:

  • エージェントのインストール後でも、rootユーザーおよびagent installationユーザーにエージェントのベース・ディレクトリとその親ディレクトリに対する書込み権限が付与されていることを確認してください。これにより、更新や削除などのエージェントのライフ・サイクル操作がすべて正常に完了したことが確認されます。

  • インストール前にエージェントのベース・ディレクトリが作成されている場合は、そのディレクトリが空であることを確認します。エージェントのインストール・ユーザーには、ディレクトリへの書込みアクセス権が必要です。

  • インストール前にエージェントのベース・ディレクトリが作成されていない場合、エージェント・ソフトウェアのzipファイルが抽出されるディレクトリの下にデフォルトで作成されます。エージェントのインストール・ユーザーが、エージェントのベース・ディレクトリが作成される親ディレクトリに対する書込みアクセス権を持っていることを確認します。

登録キーの作成またはダウンロード

アイデンティティ・ドメインに対して登録キーが発行され、クラウド・エージェントのデプロイ時に使用されます。登録キーを使用してエージェントをインストールすると、Oracle Management Cloudから鍵を削除できます。

登録キーを作成する際には、キーの使用回数を指定します。キーの有効期限は、キーの作成時に指定された最大使用数以上である場合に切れます。

  1. Oracle Management Cloud管理者としてOracle Management Cloudコンソールにログインします。
    「管理クラウド」ナビゲーション・ペインが表示されない場合は、左上隅にある「OMCナビゲーション」アイコンをクリックします。
  2. Oracle Management Cloudコンソールのナビゲーション・ペインで、「管理」をクリックし、次に「エージェント」をクリックします。
  3. 右側のメニューをクリックし、「登録キーの管理」を選択します。
  4. 「登録キー」ページに必要な詳細を入力して、「新規キーの作成」をクリックし、新規登録キーを作成します。
  5. 既存の登録キーをダウンロードするには、次の手順を実行します。
    1. 登録キーのリストから、ダウンロードするキーを探します。
    2. ページの右側にあるアクション・メニューをクリックし、「ダウンロード」を選択します。
      登録キーの値を含むテキスト・ファイルregistrationKey.txtがローカル・ドライブにダウンロードされます。キー値を表示するには、registrationKey.txtファイルを開きます。
キー値は、レスポンス・ファイルの「AGENT_REGISTRATION_KEY」パラメータに追加します。

ゲートウェイ・エージェントのダウンロード

Oracle Management Cloudコンソールを使用して、ゲートウェイ・エージェント・ソフトウェア・インストール・バンドルのZIPファイルをホストにダウンロードします。

ゲートウェイZIPファイルを抽出すると、サンプル・レスポンス・ファイルgateway.rspがテンプレートとして提供されます。

  1. Oracle Management Cloud管理者としてOracle Management Cloudコンソールにログインします。
    「管理クラウド」ナビゲーション・ペインが表示されない場合は、左上隅にある「OMCナビゲーション」アイコンをクリックします。
  2. Oracle Management Cloudコンソールのナビゲーション・ペインで、「管理」をクリックし、次に「エージェント」をクリックします。
  3. 右側のメニューをクリックし、「エージェントのダウンロード」を選択します。
  4. 「エージェント・タイプ」をクリックして、「ゲートウェイ」を選択します。
  5. 「オペレーティング・システム」をクリックし、エージェントをインストールするオペレーティング・システムを選択します。
  6. エージェント・リンクの下に表示されているTENANT_NAMEおよびOMC_URLパラメータの値をメモします。ゲートウェイ・エージェントをインストールする際は、レスポンス・ファイルをこれらの値で更新する必要があります。
  7. オペレーティング・システムのエージェント・ソフトウェア・リンクをクリックして、ゲートウェイ・ソフトウェアZIPファイルをダウンロードします。
  8. ダウンロードしたファイルのSHA1 checksum値を、エージェントのダウンロード・ページでエージェントのリストに表示された値と比較して、ダウンロードしたZIPファイルが完了していることを確認します。
    sha1sum <agent_binary_filename>.zip
    ユーザー・インタフェースの「SHA1」チェックサム列の値は、出力と一致する必要があります。
  9. ソフトウェア・バンドルをダウンロードしたディレクトリにナビゲートし、ソフトウェアを解凍します。
    unzip <agent_binary_filename>.zip

クラウド・エージェントのダウンロード

Oracle Management Cloudコンソールを使用して、クラウド・エージェント・ソフトウェア・インストール・バンドルのZIPファイルをホストにダウンロードします。

エージェントZIPファイルを抽出すると、サンプル・レスポンス・ファイルagent.rspがテンプレートとして提供されます。

  1. Oracle Management Cloud管理者としてOracle Management Cloudコンソールにログインします。
    「管理クラウド」ナビゲーション・ペインが表示されない場合は、左上隅にある「OMCナビゲーション」アイコンをクリックします。
  2. Oracle Management Cloudコンソールのナビゲーション・ペインで、「管理」をクリックし、次に「エージェント」をクリックします。
  3. 右側のメニューをクリックし、「エージェントのダウンロード」を選択します。
  4. 「エージェント・タイプ」をクリックし、「クラウド・エージェント」を選択します。
  5. 「オペレーティング・システム」をクリックし、エージェントをインストールするオペレーティング・システムを選択します。
  6. エージェント・リンクの下に表示されているTENANT_NAMEおよびOMC_URLパラメータの値をメモします。ゲートウェイ・エージェントをインストールする際は、レスポンス・ファイルをこれらの値で更新する必要があります。
  7. オペレーティング・システムのエージェント・ソフトウェア・リンクをクリックして、ゲートウェイ・ソフトウェアZIPファイルをダウンロードします。
  8. ダウンロードしたファイルのSHA1 checksum値を、エージェントのダウンロード・ページでエージェントのリストに表示された値と比較して、ダウンロードしたZIPファイルが完了していることを確認します。
    sha1sum <agent_binary_filename>.zip
    ユーザー・インタフェースの「SHA1」チェックサム列の値は、出力と一致する必要があります。
  9. ソフトウェア・バンドルをダウンロードしたディレクトリにナビゲートし、ソフトウェアを解凍します。
    unzip <agent_binary_filename>.zip

ゲートウェイ・エージェントのインストール

ゲートウェイ・エージェントは、Oracle Management Cloudとその他のすべてのOracle Management Cloudエージェント間で保護チャネルとして動作します。

ゲートウェイ・エージェントをインストールするには:

  1. ゲートウェイ・レスポンス・ファイルgateway.rsp(ゲートウェイZIPファイルをダウンロードして抽出したときに取得したもの)をテキスト・エディタで編集し、ゲートウェイのインストールに必要なパラメータの値を指定します。

    次の表に、ゲートウェイのインストールに必要なパラメータを示します。

    パラメータ 説明

    TENANT_NAME

    または

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

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

    OMC_URL

    または

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

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

    AGENT_REGISTRATION_KEY

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

    AGENT_BASE_DIRECTORY

    ホスト・マシンにエージェントをインストールする必要がある空のディレクトリ。指定したディレクトリが存在しない場合は、インストール時にディレクトリが作成されます。

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

  2. レスポンス・ファイルを保存します。
  3. 前提条件チェックを実行してパラメータを検証します。コマンドライン・インタフェースを使用して、パラメータEXECUTE_PREREQ=trueを渡すAgentInstall.shスクリプトを実行します。
    $ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed for [Gateway].

    スクリプトによって前提条件チェックが実行されます。前提条件のチェックが失敗すると、スクリプトは関連するエラー・メッセージとともに停止します。

    詳細は、<AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.logにあるログファイルを参照してください。ゲートウェイをインストールする前にエラーを修正します。

  4. レスポンス・ファイル名をパラメータとして指定したAgentInstall.shスクリプトを実行して、エージェントをインストールします。

    ./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the gateway.rsp file>

クラウド・エージェントのインストール

クラウド・エージェントは、クラウド・エージェントをデプロイするホストからエンティティ・データを収集します。

クラウド・エージェント・インストールでは、ホストに完全修飾ドメイン名(FQDN)が必要です。UNIX環境の場合は、/etc/hostsファイルでFQDNを追加し、ホストの正しいホスト名とIPアドレスにマップしていることを確認します。

注意:各アプリケーション層ホストおよびデータベース・ホストにクラウド・エージェントをインストールします。

クラウド・エージェントをインストールするには:

  1. テキスト・エディタでクラウド・エージェント・レスポンス・ファイルagent.rsp (クラウド・エージェントZIPファイルをダウンロードして抽出したときに取得したもの)を編集し、クラウド・エージェントのインストールに必要なパラメータの値を指定します。

    次の表に、プロキシ・サーバーを介したOracle Management Cloudとの通信にゲートウェイを使用する、クラウド・エージェントのインストール用に以前にリストしたゲートウェイのインストール・パラメータの上および上に必要なパラメータを示します。

    パラメータ 説明

    GATEWAY_HOST

    クラウド・エージェントがゲートウェイを使用してOracle Management Cloudと通信している場合は、ゲートウェイの完全修飾ドメイン名(FQDN)を指定します。クラウド・エージェントをインストールするときに、ゲートウェイのインストールに使用したのと同じゲートウェイ・ホスト名を指定していることを確認します。

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

    GATEWAY_PORT

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

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

    $Gateway_Agent_Home/agent_inst/bin/omcli status agent

    OMC_PROXYHOST

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

    OMC_PROXYPORT

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

    OMC_PROXYUSER

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

    OMC_PROXYPWD

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

    OMC_PROXYREALM

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

    AGENT_PORT

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

  2. レスポンス・ファイルを保存します。
  3. 前提条件チェックを実行してパラメータを検証します。コマンドライン・インタフェースを使用して、パラメータEXECUTE_PREREQ=trueを渡すAgentInstall.shスクリプトを実行します。
    $ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed.

    スクリプトによって前提条件チェックが実行されます。前提条件のチェックが失敗すると、スクリプトは関連するエラー・メッセージとともに停止します。

  4. レスポンス・ファイル名をパラメータとして指定したAgentInstall.shスクリプトを実行して、エージェントをインストールします。

    ./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the agent.rsp file>

エージェント・インストールの検証

ゲートウェイおよびクラウド・エージェントのインストール後、エージェントが正常にデプロイされたことを確認します。

  1. Oracle Management Cloud管理者としてOracle Management Cloudコンソールにログインします。
    「管理クラウド」ナビゲーション・ペインが表示されない場合は、左上隅にある「OMCナビゲーション」アイコンをクリックします。
  2. Oracle Management Cloudコンソールのナビゲーション・ペインで、「管理」をクリックし、次に「エージェント」をクリックします。
  3. ゲートウェイやクラウド・エージェントなどのエージェント・タイプのタブをクリックします。
  4. デプロイされたゲートウェイまたはクラウド・エージェントのホスト名が、使用可能なエージェントのリストに存在することを確認します。