Oracle® Enterprise Manager Cloud Controlアドバンスト・インストレーションおよび構成ガイド 12cリリース1 (12.1.0.1) B65085-03 |
|
![]() 前 |
![]() 次 |
この章では、Oracle Management Agent (管理エージェント)をサイレント・モードでインストールする方法について説明します。この項の具体的な内容は次のとおりです。
サイレント・モードの管理エージェントのインストールは、ホスト・ターゲットの追加ウィザードを使用してインストールする場合の代替方法です。ホスト・ターゲットの追加ウィザードでは、GUIが豊富な質問画面を使用して、すべてのインストール詳細を指定する必要がありますが、サイレント・モードでは、レスポンス・ファイルを使用してインストール詳細を指定し、そのレスポンス・ファイルに示された情報とデプロイメント・スクリプト(agentDeploy.sh
、Windowsの場合はagentDeploy.bat
)を使用して管理エージェントをホストにインストールする必要があります。
レスポンス・ファイルおよびデプロイメント・スクリプトは、管理エージェント・ソフトウェアの一部として使用できます。レスポンス・ファイルを作成するかわりに、デプロイメント・スクリプトの起動中に個別の引数として値を渡すこともできます。
サイレント・モードのインストールは、宛先ホストに追加の管理エージェントをインストールする場合に最も適していて、宛先ホスト自体からEnterprise Manager Cloud Controlコンソールでホスト・ターゲットの追加ウィザードを使用する必要がありません。
インストールが完了すると、エージェント・ベース・ディレクトリに次のデフォルトの内容が含まれています。
<agent_base_directory> |_____core |_____12.1.0.1.0 |_____plugins |_____plugins.txt |_____plugins.txt.status |_____agent_inst |_____sbin |_____agentimage.properties
注意: 管理エージェントを別のEnterprise Manager Cloud Controlに移動する場合、まず、管理エージェントとプラグインをアンインストールし、新しいOracle Management Serviceを使用して管理エージェントとプラグインを再デプロイします。これは通常、テスト環境のEnterprise Manager Cloud Controlから本番環境のEnterprise Manager Cloud Controlに移動する場合に行われます。 |
管理エージェントをインストールする前に、次の点に留意してください。
管理エージェントをインストールする前に、OMSホストから管理エージェント・ソフトウェアを入手して、インストール用に宛先ホストに転送する必要があります。入手する管理エージェント・ソフトウェアは、インストールに必要なコア・バイナリ、編集して渡すレスポンス・ファイルおよびagentDeploy.sh
(Windowsの場合はagentDeploy.bat
)スクリプトを含みます。
デフォルトでは、OMSホストは、OMSを実行しているプラットフォームの管理エージェント・ソフトウェアを含みます。たとえば、OMSホストがLinux x86である場合、デフォルトで使用できる管理エージェント・ソフトウェアは、Linux x86用のみです。
OMSが実行されているプラットフォームとは異なるプラットフォームに管理エージェントをインストールする場合は、自己更新コンソールを使用して必要なプラットフォームのソフトウェアをダウンロードしてください。
自己更新とそれを使用したソフトウェアのダウンロード方法の詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』の自己更新に関する章を参照してください。
宛先ホストからのみ、agentDeploy.sh
(Windowsの場合はagentDeploy.bat
)スクリプトを実行できます。
agentDeploy.sh
スクリプトを使用して一度に1つのホストにのみインストールできるので、少数のホストにのみインストールする場合はこの方式を使用してください。
レスポンス・ファイルまたはagentDeploy.sh
スクリプトの起動中に渡すことができる個別の引数の値を使用して、インストール詳細を指定できます。ただし、レスポンス・ファイルを作成して情報を取得することをお薦めします。
OMSを使用できない場合でも、インストールできます。この場合、agentDeploy.sh
(Windowsの場合はagentDeploy.bat
)スクリプトの起動中に特別なオプション-forceConfigure
を渡す必要があります。詳細は、表5-3を参照してください。
通常、OMSをインストールする前に管理エージェントをインストールしている場合のみ、このオプションを使用し、レスポンス・ファイルに示されているホストおよびポートに後でOMSを確実にインストールできます。
ただし、第9章の説明に従ってソフトウェアのみの方法を使用して管理エージェントをインストールする場合、-forceConfigure
オプションを渡さないでください。
インストール・プロセスの一部としてインストール前スクリプトまたはインストール後スクリプトを実行できません。インストールの終了後、手動で実行できます。
デフォルトでは、agentDeploy.sh
(Windowsの場合はagentDeploy.bat
)スクリプトは、次のタイプのプラグインのみ構成します。
管理エージェント・ソフトウェアがデプロイされているOMSで構成されたすべての検出プラグイン
Oracleホームの検出プラグイン
Oracleホームの監視プラグイン
2つの管理エージェントを同じホストにインストールしないでください。OMSとの通信が中断されます。
管理エージェントをインストールする前に、次の前提条件を満たしていることを確認してください。
表5-1 サイレント・モードでOracle Management Agentをインストールするための前提条件
要件 | 説明 |
---|---|
ハードウェアの要件 |
ハード・ディスク領域および物理メモリー要件を満たしていることを確認します。詳細は、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』のハードウェア要件に関する章を参照してください。 |
ソフトウェアの要件 |
(Microsoft Windowsの場合)Cygwinが宛先ホストにインストールされていることを確認します。詳細は、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』のCygwinのインストールに関する章を参照してください。 |
My Oracle Supportで使用できるEnterprise Manager Certification Matrixに示されている動作保証済オペレーティング・システムにのみ管理エージェントをインストールしていることを確認します。 このマトリックスにアクセスするには、次の手順に従います。
|
|
すべてのオペレーティング・システム固有のパッケージをインストールしていることを確認します。詳細は、Oracle Enterprise Manager Cloud Control基本インストレーション・ガイドのパッケージ要件に関する章を参照してください。 |
|
管理エージェントのインストール先のホストに適切なユーザーおよびオペレーティング・システム・グループが作成されていることを確認します。 詳細は、Oracle Enterprise Manager Cloud Control基本インストレーション・ガイドのオペレーティング・システム・グループおよびユーザーの作成に関する章を参照してください。 |
|
ホストの
|
|
タイムゾーン要件 |
ホストのタイムゾーンが正しく設定されていることを確認します。ホストのタイムゾーンを確認するには、次のコマンドを実行します。
表示されたタイムゾーンが正しくない場合は、
たとえば、Bashシェルで、タイムゾーンをAmerica/New_Yorkに設定するには、次のコマンドを実行します。
使用できるタイムゾーンは 注意: 管理エージェントのインストール中に間違ったタイムゾーンの設定に関する前提条件チェックの警告を無視した場合、管理エージェントのインストール後、ホストで正しいタイムゾーンを設定する必要があります。インストール後のタイムゾーンの設定の詳細は、インストール後の作業に関する項を参照してください。 |
(UNIXのみ)rootとして |
|
PATH環境変数要件 |
(Microsoft Windowsの場合)宛先ホストのPATH環境変数内でcygwinソフトウェアの場所が他のソフトウェアの場所よりも前に指定されていることを確認します。最初のエントリであることを確認した後、SSHデーモン(sshd)を両方のホストで再起動します。 |
パス検証の要件 |
すべてのコマンドの場所へのパスを検証します。詳細は、Oracle Enterprise Manager Cloud Control基本インストレーション・ガイドのコマンド場所の検証に関する付録を参照してください。 |
|
|
ポート要件 |
「使用されるデフォルト・ポート」で説明されているデフォルトのポートを使用できることを確認します。 |
実行可能ファイルがコピーされる一時ディレクトリに、400MBの領域が割り当てられていることを確認します。 デフォルトでは、環境変数 |
|
エージェント・ベース・ディレクトリの要件 |
エージェント・ベース・ディレクトリが空であることを確認します。 ディレクトリ名に空白が含まれていないことを確認します。 インストールしているユーザーがインストール・ベース・ディレクトリを所有していることを確認します。インストールしているユーザーまたはルート・ユーザーがすべての親ディレクトリを所有していることを確認します。ルート・ユーザーがルート・ディレクトリを所有していることを確認します。 たとえば、インストール・ベース・ディレクトリが エージェントのベース・ディレクトリがマウントされている場合、 |
エージェント・インスタンス・ホームの要件 |
|
インストール・ユーザーの要件 |
中央インベントリ所有者と管理エージェントをインストールするユーザーが異なる場合、両者が同じグループに属していることを確認します。 また、インベントリ所有者と所有者が属するグループに中央インベントリに対する読取りおよび書込み権限があることも確認します。 たとえば、インベントリ所有者がabcで、管理エージェントをインストールするユーザーがxyzの場合、abcとxyzが同じグループに属し、双方が中央インベントリに対する読取りおよび書込みアクセスを持っていることを確認してください。 |
|
|
エージェント・ユーザー・アカウント権限(Microsoft Windowsの場合) |
(Microsoft Windowsの場合)Microsoft Windowsベースのオペレーティング・システム上に管理エージェントをインストールする場合、エージェント・ユーザー・アカウントに次を実行する権限があることを確認します。
エージェント・ユーザーにこれらの権限があることを確認するには、次の手順を実行します。
|
(Microsoft Windowsの場合)Microsoft Windowsベースのオペレーティング・システム上に管理エージェントをインストールする場合、バッチ・ジョブを実行するユーザー・アカウントに この制約事項、および権限を付与する方法の詳細は、次のMicrosoft WebサイトへのURLにアクセスしてください。 |
サイレント・モードで管理エージェントをインストールするには、次の手順に従います。
OMSホストで、OMSホームからEMCLIクライアントにログインします。各OMSインストールでEMCLIクライアントをデフォルトで使用できるため、クライアントを個別にインストールする必要がありません。
$<OMS_HOME>/bin/emcli login -username=sysman -password=<password>
次に例を示します。
$<OMS_HOME>/bin/emcli login -username=sysman -password=2benot2be
注意: ユーザー名は、常にsysman にする必要があります。他のユーザー名前を入力しないでください。 |
$<OMS_HOME>/bin/emcli sync
管理エージェント・ソフトウェアがOMSホストで使用できるプラットフォームを特定します。
$<OMS_HOME>/bin/emcli get_supported_platforms
このコマンドは、管理エージェント・ソフトウェアがOMSホストで使用できるすべてのプラットフォームをリストします。例5-1は、コマンドの出力例を示しています。
例5-1 異なるプラットフォームで使用できるソフトウェアを示す出力
--------------------------------------------------- Version = 12.1.0.1.0 Platform Name = Linux x86 --------------------------------------------------- Version = 12.1.0.1.0 Platform Name = Oracle Solaris on x86-64 (64-bit) --------------------------------------------------- Version = 12.1.0.1.0 Platform Name = HP-UX PA-RISC (64-bit) ---------------------------------------------------
管理エージェントをインストールするプラットフォームの出力が示されている場合、次の手順に進みます。それ以外の場合は、自己更新コンソールを使用して、必要なプラットフォームのソフトウェアをダウンロードします。
自己更新とそれを使用したソフトウェアのダウンロード方法の詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』の自己更新に関する章を参照してください。
Oracleソフトウェア・ライブラリからOMSホストの一時ディレクトリに管理エージェント・ソフトウェアをダウンロードします。
$<OMS_HOME>/bin/emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>
次に例を示します。
./emcli get_agentimage -destination=/tmp -platform="Linux x86" -version=12.1.0.1.0
注意: コマンドでは、次のことに注意してください。
|
このコマンドは、入力した宛先ディレクトリにコア管理エージェント・ソフトウェアをダウンロードします。たとえば、Linux x86の場合、12.1.0.1.0_AgentCore_46.zip
ファイルが表示されます。このコア・ソフトウェアの内容の詳細は、「ダウンロードした管理エージェント・ソフトウェアの内容の理解」を参照してください。
ダウンロードしたZIPファイルを管理エージェントをインストールする宛先ホストの一時ディレクトリ(/tmp
)に転送します。任意のFTPソフトウェアを使用して、ファイルを転送できます。たとえば、FileZillaなどです。
宛先ホストで、UNZIPユーティリティを使用して、ZIPファイルの内容を抽出します。
unzip /tmp/<software_zip_file> -d <software_extract_location>
次に例を示します。
unzip /tmp/12.1.0.1.0_AgentCore_46.zip -d /tmp/agtImg
表5-2の説明に従って、agent.rsp
レスポンス・ファイルを編集します。
<software_extract_location>/agent.rsp
デプロイメント・スクリプトを起動して、レスポンス・ファイルを渡します。
<software_extract_location>/agentDeploy.sh AGENT_BASE_DIR=<absolute_path_to_agentbasedir> RESPONSE_FILE=<absolute_path_to_responsefile>
注意:
|
要求された場合、ルート・スクリプトを実行します。詳細は、「インストール後」を参照してください。
注意: インストールが成功したにもかかわらず、前提条件エラー・ファイルに例外が含まれている場合、その例外トレースは無視できます。この問題は、操作でコレクション内にないキーを使用してコレクションから要素を取得しようとした場合に発生します。この例外は無視できます。 |
表5-2は、レスポンス・ファイルに含む必要がある様々なパラメータを示しています。
表5-2 サイレント・モードでOracle Management Agentをインストールするためのレスポンス・ファイルの作成
パラメータ | 説明 |
---|---|
OMS_HOST |
OMSホスト名を入力します。 たとえば、 |
EM_UPLOAD_PORT |
アップロード・ポート(HTTPまたはHTTPS)を入力して、OMSと通信します。 たとえば、 |
AGENT_REGISTRATION_PASSWORD |
Enterprise Managerシステムを結合する新しい管理エージェントを登録するパスワードを入力します。 デフォルトでは、OMSと管理エージェント間の通信が保護され、システムの一部になる前にEnterprise Managerシステムを結合する新しい管理エージェントを認証する必要があります。ここで入力するパスワードは、新しい管理エージェントを認証するために使用されます。 たとえば、 |
AGENT_INSTANCE_HOME |
すべての管理エージェント関連の構成ファイルを格納できる宛先ホストのディレクトリの場所を入力します。このパラメータには、次のいずれかを実行できます。
|
AGENT_PORT |
管理エージェント・プロセスを起動する空きポートを入力します。HTTPとHTTPSの両方に同じポートが使用されます。 たとえば、 値を入力しない場合、3872または1830から1849の間の空きポートが適用されます。 |
b_startAgent |
インストールして構成した後に管理エージェントを自動的に起動する場合、 たとえば、 |
ORACLE_HOSTNAME |
エージェントをインストールするホストの完全修飾ドメイン名を入力します。 たとえば、 |
s_agentHomeName |
管理エージェント用に作成された表示するOracleホームの名前を入力します。 たとえば、 |
s_agentServiceName |
カスタマイズされた管理エージェント・サービス名を入力します。このフィールドを空のままにすると、デフォルトはOracle+<oracle_home_name>+Agentになります。 |
表5-3は、agentDeploy.sh
スクリプトでサポートされるオプションを示しています。Microsoft Windowsでは、これらのオプションはagentDeploy.bat
ファイルで利用できます。
表5-3 agentDeploy.sh/agentDeploy.batでサポートされるオプションの理解
オプション | 説明 |
---|---|
-prereqOnly |
前提条件チェックのみを実行します。実際に管理エージェントをインストールしないでください。 使用している環境が正常な管理エージェントのインストールのすべての前提条件チェックを満たしているかどうかを確認する場合、このオプションが便利です。 |
-ignorePrereqs |
前提条件チェックの実行をスキップします。すでに |
-invPtrLoc |
インベントリ詳細を格納するOracle Inventoryディレクトリを考慮します。 重要: このオプションの値を入力する場合、 |
INVENTORY_LOCATION |
インベントリ詳細を格納するOracle Inventoryディレクトリを考慮します。 重要:
|
-help |
コマンドライン・ヘルプを表示して、デプロイメント・スクリプトの使用方法を説明します。 |
-debug |
エラーのデバッグおよび解決に役立つ詳細なデバッグ・メッセージを記録します。 |
-ignoreUnzip |
管理エージェント・ソフトウェアのソフトウェア・バイナリの抽出をスキップします。バイナリを再コピーしないで使用できるバイナリを構成するだけの場合に使用してください。 |
-softwareOnly |
ソフトウェア・バイナリのみをインストールして、インストールを構成しません。管理エージェントのソフトウェアのみのインストールを実行する場合に使用してください。詳細は、第9章を参照してください。 注意: ZIPファイルを使用してクローニングしている場合、このオプションは適用されません。 |
-configOnly |
ソフトウェア・バイナリを構成して、ソフトウェア・バイナリをインストールしません。構成のみがコピーされたソフトウェア・バイナリに実行されるため、 注意: ZIPファイルを使用してクローニングしている場合、このオプションは適用されません。 |
-forceConfigure |
OMSを使用できない場合でも、強制的に管理エージェントを構成します。OMSをインストールする前に管理エージェントをインストールし、渡すレスポンス・ファイルのパラメータ このオプションを渡す場合、-configOnly,、-softwareOnlyおよび-prereqOnlyを渡さないでください。 注意: このオプションを渡すと、HTTP (保護されていない)通信を使用するために管理エージェントが構成されます。管理エージェントおよびOMS間のセキュアなHTTPS通信を確立するため、OMSが使用可能になった後に管理エージェントを手動で保護する必要があります。 |
表5-4は、管理エージェントをインストールする前にダウンロードするコア管理エージェント・ソフトウェアの内容を示しています。
表5-4 ダウンロードした管理エージェント・ソフトウェアの内容
ファイル | 説明 |
---|---|
12.1.0.1.0_PluginsOneoffs_<platform id>.zip |
OMSとともにインストールされたすべての検出プラグイン、Oracleホームの検出プラグインおよびOracleホームの監視プラグインを含むプラグインZIPファイル。 |
agentcoreimage.zip |
コア・エージェント・ビットおよびエージェントsetuidバイナリを含むアーカイブ済ZIPファイル。 |
agentDeploy.sh/agentDeploy.bat |
管理エージェントをデプロイするために使用されるスクリプト。 |
unzip |
ZIPファイルのアーカイブを解除するために使用されるユーティリティ。 |
Agentimage.properties |
バージョンやプラットフォームIDなどを取得するために使用されるプロパティ・ファイル。 |
agent.rsp |
管理エージェントをインストールするために編集して渡すレスポンス・ファイル。 |
管理エージェントのインストール後、次の手順を実行します。
(UNIXオペレーティング・システムのみ)プロンプトが表示されたら、rootユーザーとして次のスクリプトを実行します。SUDO権限を持っていない場合、SUDO権限を持つ管理者にこれらのスクリプトの実行を依頼してください。
これがホストにインストールした最初のOracle製品である場合、oraInstroot.sh
(Windowsの場合はoraInstroot.bat)スクリプトを、管理エージェント・ホームで使用可能なoraInst.loc
ファイルで指定されたインベントリの場所から実行します。
たとえば、oraInst.loc
ファイルで指定されたインベントリの場所が$HOME/oraInventory
である場合、次のコマンドを実行します。
$HOME/oraInventory/oraInstRoot.sh
注意: 自身がrootユーザーではない場合、SUDOを使用して、rootユーザーに変更してください。たとえば、次のようなコマンドを実行します。
|
管理エージェント・ホームからroot.sh
(Microsoft Windowsの場合はroot.bat)スクリプトを実行します。
$<AGENT_HOME>/root.sh
注意: 自身がrootユーザーではない場合、SUDOを使用して、rootユーザーに変更してください。たとえば、次のようなコマンドを実行します。
|
管理エージェント・ホームに移動して次のコマンドを実行すると、管理エージェントが動作していることを確認するメッセージが表示されます。
$<INSTANCE_HOME>/bin/emctl status agent
注意: なんらかの理由で管理エージェントのステータスが停止中の場合、管理エージェントのOracleホームから次のコマンドを実行して、手動で管理エージェントを起動してください。
|
管理エージェント・ホームに移動して次のコマンドを実行すると、EMDアップロードが正常に完了したことを確認するメッセージが表示されます。
$<INSTANCE_HOME>/bin/emctl upload agent
すべてのプラグインが正常にインストールされたかどうかを確認します。これを行うには、管理エージェント・ホームから次のログ・ファイルにアクセスして、警告: プラグイン構成に失敗しましたという文を検索します。
$<AGENT_HOME>/cfgtoollogs/cfgfw/CfmLogger-<timestamp>.log
次に例を示します。
/u01/app/Oracle/core/12.1.0.1.0/cfgtoollogs/cfgfw/CfmLogger-<timestamp>.log
文が見つかった場合、管理エージェント・ホームからAgentPluginDeploy.pl
スクリプトを実行して、問題を解決します。このコマンドでは、すべての<AGENT_HOME>
の参照が管理エージェント・ホームを指しています。
$<AGENT_HOME>/perl/bin/perl <AGENT_HOME>/bin/AgentPluginDeploy.pl -oracleHome <AGENT_HOME> -agentDir <AGENT_BASE_DIR> -pluginIdsInfoFile <AGENT_BASE_DIR>/plugins.txt -action configure -emStateDir <AGENT_INSTANCE_HOME>
次に例を示します。
/u01/app/Oracle/core/12.1.0.1.0/perl/bin/perl /u01/app/Oracle/core/12.1.0.1.0/bin/AgentPluginDeploy.pl -oracleHome /u01/app/Oracle/core/12.1.0.1.0/ -agentDir /u01/app/Oracle/ -pluginIdsInfoFile /u01/app/Oracle/plugins.txt -action configure -emStateDir /u01/app/Oracle/agent_inst
間違ったタイムゾーンの設定に関する前提条件チェックの警告を無視した場合、次の手順を実行します。
必要なホストの正しいタイムゾーンを設定します。
ホストのタイムゾーンを設定する方法の詳細は、表5-1のタイムゾーン要件に関する項目を参照してください。
ホストに存在する管理エージェントを削除します。
管理エージェントのアンインストールの詳細は、『Oracle Enterprise Manager Cloud Controlアドバンスト・インストレーションおよび構成ガイド』を参照してください。
ホストに管理エージェントをインストールします。
デフォルトでは、ホストおよび管理エージェントは、監視のためにEnterprise Manager Cloud Controlコンソールに自動的に追加されます。ただし、そのホストで実行中のターゲットは、自動的に検出および監視されません。
その他のターゲットを監視するには、そのターゲットを、「自動検出の結果」ページ、「ターゲットの手動追加」ページまたは監視するターゲットに提供されている検出ウィザードを使用して、Enterprise Manager Cloud Controlに追加する必要があります。
Enterprise Manager Cloud Control,のターゲットの検出の詳細は、Oracle Enterprise Manager Cloud Controlの管理者ガイドのターゲットの追加に関する章を参照してください。
注意: 管理エージェントを別のEnterprise Manager Cloud Controlに移動する場合、まず、管理エージェントとプラグインをアンインストールし、新しいOracle Management Serviceを使用して管理エージェントとプラグインを再デプロイします。これは通常、テスト環境のEnterprise Manager Cloud Controlから本番環境のEnterprise Manager Cloud Controlに移動する場合に行われます。 |