7 サイレント・モードでのOracle Remote Management Agentのインストール
この章では、Oracle Remote Management Agent (リモート・エージェント)をサイレント・モードでインストールする方法について説明します。この章の具体的な内容は次のとおりです。
サイレント・モードでのリモート・エージェントのインストールの概要
サイレント・モードのリモート管理エージェント(リモート・エージェント)のインストールは、ホスト・ターゲットの追加ウィザードを使用してインストールする場合の代替方法です。リモート・エージェントをインストールするには、インストールの詳細およびデプロイメント・スクリプトを提供するためにレスポンス・ファイルを使用する必要があります。
サイレント・モードのインストールは、ホスト・ターゲットの追加ウィザードUIを使用せずに、宛先ホスト自体から宛先ホストに追加のリモート・エージェントをインストールする場合に役立ちます。
リモート・エージェントをサイレント・モードでインストールするには、次の方法を使用します:
AgentPullスクリプトの使用
この方法では、管理エージェントをインストールするためにスクリプトを実行する前に、EM CLIを使用して管理エージェント・ソフトウェアをリモートの宛先ホストにダウンロードする必要がありません。この方法では、数個の追加パラメータのみをサポートしており、基本的な管理エージェントのインストールに適しています。
agentDeployスクリプトの使用
この方法では、リモート・エージェントをインストールするスクリプトを実行する前に、EM CLIを使用して管理エージェント・ソフトウェアをリモートの宛先ホストにダウンロードする必要があります。OMSホストから、またはリモートの宛先ホストからのいずれかのEM CLIの使用を選択できます。OMSホストからのEM CLIの使用を選択した場合、管理エージェントをインストールするスクリプトを実行する前に、ダウンロード済の管理エージェント・ソフトウェアをリモートの宛先ホストに転送する必要があります。この方法では、数多くの追加パラメータをサポートしており、カスタマイズされた管理エージェントのインストールに適しています。
インストールが完了すると、エージェント・ベース・ディレクトリに次のデフォルトの内容が含まれています。
<agent_base_directory> |_____agent_24.1.0.0.0 |_____sbin |_____OPatch |_____agent.rsp |_____bin |_____cfgtoollogs |_____config |_____install |_____instalclient |_____. |_____. |_____. |_____agent_inst |_____agentInstall.rsp |_____agentimage.properties
ノート:
-
既存の管理エージェントを新しいOracle Management Service (OMS)に再指定できます。手順は、「別のOracle Management ServiceへのOracle Management Agentのリダイレクト」を参照してください。
既存の管理エージェントを新しいOMSに対して再指定する場合、管理エージェントのモニター対象ターゲット、ターゲットの履歴および管理エージェントの履歴は移行できません。モニター対象ターゲットおよび履歴データは失われます。
-
(Microsoft Windowsホストの場合) 24.1.0.x管理エージェントをアップグレードし、異なるOMSを指定する別の管理エージェントを同じホストにインストールする場合、「agentDeployスクリプトを使用してサイレント・モードで管理エージェントをインストールするためのレスポンス・ファイル・パラメータ」に記載されるように、管理エージェントのインストール中に
s_agentSrvcName
パラメータを指定してください。
サイレント・モードでのリモート・エージェントのインストールを開始する前に
サイレント・モードでリモート・エージェントのインストールを開始する前に、次の点に留意してください:
-
サイレント・モードでは、一度に1つのホストにのみリモート・エージェントをインストールできます。このため、この方式は少数のホストにリモート・エージェントをインストールする場合に使用してください。
-
リモート・エージェントをインストールするホストのプラットフォーム用の管理エージェント・ソフトウェアは、自己更新を使用してダウンロードおよび適用する必要があります。OMSホスト・プラットフォーム用の管理エージェント・ソフトウェアのみが、デフォルトでダウンロードおよび適用されます。管理エージェント・ソフトウェアには、インストールに必要なコア・バイナリ、編集して渡されるレスポンス・ファイルおよび
agentDeploy.sh
(Microsoft Windowsの場合はagentDeploy.bat
)スクリプトが含まれます。自己更新を使用してプラットフォーム用の管理エージェント・ソフトウェアをダウンロードし適用する方法については、『Oracle Enterprise Manager基本インストレーション・ガイド』のオンライン・モードでの管理エージェント・ソフトウェアの取得を参照してください。
AgentPull.sh
スクリプト(Microsoft WindowsではAgentPull.bat
)を使用した管理エージェントのパラレル・デプロイメントがサポートされています。これにより、AgentPull.sh
スクリプトまたはAgentPull.bat
スクリプトを使用して、管理エージェントを複数のホストに同時に(パラレル方式で)デプロイできるようになります。-
リモート・エージェントをサイレント・モードでMicrosoft Windowsホストにインストールする場合は、他のコマンド・プロンプトではなく必ずデフォルトのコマンド・プロンプト
cmd.exe
から、AgentPull.bat
スクリプトまたはagentDeploy.bat
スクリプトを実行します。 -
インストール・プロセスの一部としてインストール前スクリプトまたはインストール後スクリプトを実行できません。これらは、インストール前またはインストール後に手動で実行できます。
-
デフォルトでは、サイレント・モードでリモート・エージェントをインストールすると、次のタイプのプラグインのみが構成されます:
-
管理エージェント・ソフトウェアがデプロイされているOMSで構成されたすべての検出プラグイン
-
Oracleホームの検出プラグイン
-
Oracleホームのモニタリング・プラグイン
-
サイレント・モードでリモート・エージェントをインストールするための前提条件
サイレント・モードでリモート・エージェントをインストールする前に、次の前提条件を満たしていることを確認してください:
表7-1 リモート・エージェントをインストールするための一般的な前提条件
要件 | 説明 |
---|---|
ハードウェアの要件 |
My Oracle Support Doc ID 3076694.1を参照してください。
|
オペレーティング・システムの要件 | unresolvable-reference.html#GUID-41B02FB6-7BA7-4835-BC65-38C974FC9B56を参照してください。 |
宛先ホストの要件 |
リモート・ホストがEnterprise Managerによって検出されていないことを確認します。リモート・エージェント・ホストにローカル・ターゲットを含めることはできません。 リモート・エージェントのインストール用に選択するホストが、ソフトウェア・インストールから解放されていることを確認します。 |
宛先ホストの資格証明の要件 |
SSHキーまたはパスワードベースの資格証明が必要です。 SSH資格証明を選択した場合、リモート・エージェントをインストールする前にSSHキーを構成する必要があります。 |
sudo/pbrun/sesu/su SSH要件 |
リモート・ホスト・ターゲットの追加ウィザードまたはEM CLIを使用して名前付き資格証明を追加する場合は、 Enterprise Manager 24aiリリース1では、Power Brokerはサポートされていません。 |
ユーザーがパスワードなしのsudoを構成する必要があるかどうかを確認します | リモート・ホスト・ターゲットの追加の構成中、次の資格証明を使用できます:
|
リモート・ホスト上のユーザーに対してパスワードなしのsudoが構成されているかどうかを確認します |
リモート・ホスト上のモニタリング・ユーザーは、パスワードを要求しないように構成する必要があります。確認するには、次の手順を実行します:
|
追加の前提条件については、unresolvable-reference.html#GUID-707CAE59-AD17-4E8C-8C0E-7B9B2D3FFE70を参照してください。
サイレント・モードでのリモート・エージェントのインストール
この項では、サイレント・モードでのリモート・エージェントのインストールに必要な操作について説明します。内容は次のとおりです。
ノート:
OMSホストがMicrosoft Windowsで稼働していて、OMSソフトウェアがC:\
以外のドライブにインストールされている場合は、ORACLE_HOME\oui\prov\resources\ssPaths_msplats.properties
のSCRATCH_PATH
変数を更新します。
たとえば、OMSソフトウェアがD:\
にインストールされている場合は、SCRATCH_PATH
変数をD:\tmpada
に更新してください。
AgentDeployスクリプトを使用したリモート・エージェントのインストール
agentDeploy
スクリプトと宛先ホストからのEM CLIを使用してリモート・エージェントをインストールするには、次のステップを実行します:
-
管理エージェント・ソフトウェアを取得し、EM CLIを使用して宛先ホストにこれをダウンロードします。
-
宛先ホストにEM CLIを設定します。
OMSが実行されていないホストでのEM CLIの設定方法については、Oracle Enterprise Managerコマンドライン・インタフェース・ガイドのEM CLIの概要と概念を参照してください。
-
宛先ホスト上のEM CLIインストール位置から、EM CLIにログインします。
<emcli_install_location>/emcli login -username=<username>
たとえば、
<emcli_install_location>/emcli login -username=sysman
パスワードを求められたら、指定します。
ノート:
EM CLIログイン・ユーザーに
ADD_TARGET
権限が付与されていることを確認します。 -
<emcli_install_location>/emcli sync
-
管理エージェント・ソフトウェアがソフトウェア・ライブラリで入手可能なプラットフォームを特定します。
<emcli_install_location>/emcli get_supported_platforms
このコマンドは、管理エージェント・ソフトウェアがソフトウェア・ライブラリで入手可能なすべてのプラットフォームをリストします。次に、コマンドの出力例を示します。
--------------------------------------------------- Version = 24.1.0.0.0 Platform Name = Linux x86-64 ---------------------------------------------------
管理エージェントをインストールするプラットフォームの出力が示されている場合、次のステップに進みます。それ以外の場合は、自己更新を使用して、必要なプラットフォーム用の管理エージェント・ソフトウェアを取得および適用します。
自己更新を使用してプラットフォーム用の管理エージェント・ソフトウェアを取得し適用する方法については、『Oracle Enterprise Manager基本インストレーション・ガイド』のオンライン・モードでの管理エージェント・ソフトウェアの取得を参照してください。
-
ソフトウェア・ライブラリから宛先ホストの一時ディレクトリに管理エージェント・ソフトウェアをダウンロードします。このコマンドは、入力した宛先ディレクトリにコア管理エージェント・ソフトウェアをダウンロードします。たとえば、Linux x86-64の場合、
24.1.0.0.0_AgentCore_226.zip
ファイルが表示されます。このコア・ソフトウェアの内容の詳細は、「ダウンロードした管理エージェント・ソフトウェアの内容」を参照してください。<emcli_install_location>/emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>
たとえば、
./emcli get_agentimage -destination=/tmp/agentImage -platform="Linux x86-64" -version=24.1.0.0.0
コマンドでは、次のことに注意してください。
-destination
は、管理エージェント・ソフトウェアをダウンロードする宛先ホストのディレクトリです。この場所への書込み権限を持っていることを確認します。-platform
は、ソフトウェアをダウンロードするプラットフォームで、ソフトウェアがソフトウェア・ライブラリで入手可能な以前のステップで示されたプラットフォームのいずれかと一致する必要があります。-version
は、ダウンロードする管理エージェント・ソフトウェアのバージョンで、オプションの引数です。この引数を渡さない場合、デフォルトのバージョンはOMSバージョンになります。ノート:
get_agentimage
EM CLI動詞を使用して宛先ホストとは異なるプラットフォーム用の管理エージェント・ソフトウェアをダウンロードする場合、次の要件を満たす必要があります。-
ZIPユーティリティがバージョン3.0 2008ビルド以上、UNZIPユーティリティがバージョン6.0以上であることを確認します。
-
ZIP_LOC
環境変数に、ZIPユーティリティが存在するサブディレクトリを設定します。たとえば、ZIPユーティリティが/usr/bin/zip
にある場合、ZIP_LOC=usr/bin/zip
と設定します。 -
UNZIP_LOC=usr/bin/unzip
環境変数に、UNZIPユーティリティが存在するサブディレクトリの親ディレクトリを設定します。たとえば、UNZIPユーティリティがサブディレクトリ/usr/bin/unzip
にある場合は、UNZIP_LOC=usr/bin/
と設定します(usr/bin
が親ディレクトリです)。
同様に、get_agentimage EM CLI動詞を使用してOMSホストとは異なるプラットフォーム用の管理エージェント・ソフトウェアをダウンロードする場合、次の要件を満たす必要があります。
-
ZIPユーティリティがバージョン3.0 2008ビルド以上、UNZIPユーティリティがバージョン6.0以上であることを確認します。
-
ZIP_LOC
環境変数を$OMS_HOME/bin/zip
(OMSホスト上でZIPユーティリティがあるサブディレクトリ)に設定します。 -
UNZIP_LOC=<ORACLE_HOME>/bin/unzip
環境変数を<ORACLE_HOME>/bin/
(OMSホストのOracleホームでUNZIPユーティリティが存在するサブディレクトリの親ディレクトリ)に設定します。
-
-
-
agentDeployスクリプトを使用して管理エージェントをインストールします。
-
宛先ホストで、UNZIPユーティリティを使用して、ZIPファイルの内容を抽出します。
unzip <software_zip_file_location> -d <software_extract_location>
たとえば、
unzip /tmp/agentImage/24.1.0.0.0_AgentCore_226.zip -d /tmp/agtImg
-
表6-4
の説明に従って、agent.rspレスポンス・ファイルを編集します。<software_extract_location>/agent.rsp
サンプル・レスポンス・ファイルの内容は次のとおりです。
OMS_HOST=example.com EM_UPLOAD_PORT=14511 AGENT_REGISTRATION_PASSWORD=abc123 AGENT_PORT=1832
スクリプトが特定のレスポンス・ファイル・パラメータを無視するようにするには、パラメータの前に「#」を指定します。たとえば、
#AGENT_PORT
のように指定します。 -
デプロイメント・スクリプトを起動して、レスポンス・ファイルを渡します。
<software_extract_location>/agentDeploy.sh AGENT_BASE_DIR=<absolute_path_to_agentbasedir> OMS_HOST=<host_value> EM_UPLOAD_PORT=<em_port> AGENT_REGISTRATION_PASSWORD=<password_value> RESPONSE_FILE=<software_extract_location>/agent.rsp REMOTE_AGENT=true
宛先ホストとOMSホストの間にプロキシが設定される場合、プロパティ・ファイルに
REPOSITORY_PROXYHOST
パラメータおよびREPOSITORY_PROXYPORT
パラメータを指定し、agentDeploy.sh
を実行して宛先ホストに管理エージェントをインストールするときにPROPERTIES_FILE
パラメータを指定する必要があります。<software_extract_location>/agentDeploy.sh AGENT_BASE_DIR=<absolute_path_to_agentbasedir> RESPONSE_FILE=<absolute_path_to_responsefile> PROPERTIES_FILE=<absolute_path_to_properties_file> REMOTE_AGENT=true
たとえば、
/tmp/agtImg/agentDeploy.sh AGENT_BASE_DIR=/scratch/agent24 RESPONSE_FILE=/tmp/agtImg/agent.rsp PROPERTIES_FILE=/tmp/agent.properties REMOTE_AGENT=true
使用するプロパティ・ファイルは次の形式である必要があります。
REPOSITORY_PROXYHOST=<proxy_host_name> REPOSITORY_PROXYPORT=<proxy_port>
ノート:
-
レスポンス・ファイルを渡すかわりに、デプロイメント・スクリプトの起動中にレスポンス・ファイルのパラメータを明示的に渡すことができます。
必須のレスポンス・ファイル・パラメータは、
OMS_HOST
、EM_UPLOAD_PORT
および
AGENT_REGISTRATION_PASSWORD
です。たとえば、
/tmp/agtImg/agentDeploy.sh AGENT_BASE_DIR=/u01/software/em24/agentbasedir OMS_HOST=example.com EM_UPLOAD_PORT=14511 AGENT_REGISTRATION_PASSWORD=2bornot2b REMOTE_AGENT=true
-
デプロイメント・スクリプトの起動中に引数を渡す場合、二重引用符でこれらの値を指定する必要はありません。ただし、レスポンス・ファイルで使用する場合、二重引用符で値を囲む必要があります(引数
START_AGENT
を除く)。 -
エージェント・ベース・ディレクトリおよびレスポンス・ファイル(またはインストール詳細の個別の必須引数)を渡す以外に、デプロイメント・スクリプトでサポートされている他のオプションも渡すことができます。詳細は、「agentDeployスクリプトでサポートされるオプション」を参照してください。
-
-
インストール後にルート・スクリプトを実行します。詳細は、サイレント・モードでの管理エージェントのインストール後を参照してください。
-
管理エージェントを物理ホストにインストールし、その物理ホスト上にインストールされた仮想ホストに別の管理エージェントをインストールする場合に、両方の管理エージェントが通信用に同じポートを使用するようにするには、次のステップを実行します。
-
物理ホストに管理エージェントをインストールします。管理エージェントを停止します。
-
仮想ホストに管理エージェントをインストールします。管理エージェントを停止します。
-
$<AGENT_HOME>/sysman/config/emd.properties
ファイルで、AgentListenOnAllNICs=false
と設定します。このステップは、必ず両方の管理エージェントに対して実行します。 -
両方の管理エージェントを起動します。
管理エージェントのインストールが失敗した場合、管理エージェントのインストール・ログを見て問題を診断してください。これらのログの場所の詳細は、「手動の管理エージェント・インストール・ログ」を参照してください。
AgentPullスクリプトを使用したサイレント・モードでリモート・エージェントをインストールするためのレスポンス・ファイル・パラメータ
表6-3は、AgentPull
スクリプトを使用してリモート・エージェントをインストールする際、レスポンス・ファイルに含める必要のある必須パラメータと、含めることができるオプションのパラメータを示しています。
表7-2 AgentPullスクリプトを使用してリモート・エージェントをインストールするためのレスポンス・ファイルの作成
パラメータ | 説明 |
---|---|
LOGIN_USER |
(必須) Enterprise Managerコンソールのログイン・ユーザー名を入力します。 たとえば、 |
LOGIN_PASSWORD |
(必須) Enterprise Managerコンソールのログイン・パスワードを入力します。 たとえば、 |
PLATFORM |
(必須)管理エージェント・ソフトウェアをダウンロードするプラットフォームを入力します。 たとえば、 ノート: パラメータの値は" "で囲む必要があります。 |
AGENT_REGISTRATION_PASSWORD |
(必須)Enterprise Managerシステムを結合する新しい管理エージェントを登録するパスワードを入力します。 デフォルトで、OMSと管理エージェント間の通信は保護およびロックされます。Enterprise Managerシステムに追加する新しい管理エージェントは、事前に認証を受ける必要があります。ここで入力するパスワードは、新しい管理エージェントを認証するために使用されます。 たとえば、 |
VERSION |
(オプション)ダウンロードする管理エージェント・ソフトウェアのバージョンを入力します。 たとえば、 このパラメータを指定しないと、OMSのバージョンが割り当てられます。 |
OMS_HOST |
(オプション) OMSホスト名を入力します。 たとえば、 |
EM_UPLOAD_PORT |
(オプション) OMSと通信するためのアップロード・ポート(HTTPまたはHTTPS)を入力します。 たとえば、 |
AGENT_INSTANCE_HOME |
(オプション)すべての管理エージェント関連の構成ファイルを格納できる宛先ホストのディレクトリの場所を入力します。このパラメータには、次のいずれかを実行できます。
|
AGENT_PORT |
(オプション)管理エージェント・プロセスを起動する空きポートを入力します。HTTPとHTTPSの両方に同じポートが使用されます。 たとえば、 値を入力しない場合、3872または1830から1849の間の空きポートが適用されます。 |
START_AGENT |
(オプション)管理エージェントをインストールして構成した後に自動的に起動する場合、 たとえば、 このパラメータを追加しないと、デフォルトで |
ORACLE_HOSTNAME |
(オプション)管理エージェントをインストールするホストの完全修飾ドメイン名を入力します。 たとえば、 このパラメータを追加しないと、デフォルトで物理ホスト名が設定されます。 |
ALLOW_IPADDRESS |
(オプション) たとえば、 このパラメータを追加しないと、デフォルトで |
INVENTORY_LOCATION |
(オプション)カスタム・インベントリの場所を入力します。 |
PROPERTIES_FILE |
(オプション)プロパティ・ファイルの絶対位置を指定する場合にこのパラメータを使用します。 たとえば、 プロパティ・ファイルで管理エージェントのデプロイメントに使用するパラメータを指定します。プロパティ・ファイルに指定できるパラメータのリストは、
プロパティ・ファイルでは、空白の入ったパラメータ値はサポートしていません。特定のパラメータの値に空白があった場合には、管理エージェントのデプロイ後に次のコマンドを実行します。
|
s_agentSrvcName (Microsoft Windowsのホストのみ) |
(オプション)カスタマイズされた管理エージェント・サービス名を入力します。 たとえば、 このパラメータを追加しないと、デフォルトでOracle+<oracle_home_name>+Agentが設定されます。 ノート: (Microsoft Windowsホストの場合)ホストにインストールされている24.1.0.x管理エージェントをアップグレードし、同じホストに、別のOMSを指す別の管理エージェントをインストールする場合は、その管理エージェントのインストール中に |
アクセス権 |
書込み権限をagent.rspファイルに追加します |
リモート・エージェント | このパラメータは、リモート・エージェントをインストールする場合に使用します。たとえば:
|
サイレント・モードでのリモート・エージェントのインストール後
詳細は、Oracle Enterprise Manager基本インストレーション・ガイドのリモート・エージェントのインストール後のタスクの実行を参照してください。