F Cygwinを使用しないMicrosoft Windowsターゲット・ホストへの管理エージェントのインストール

ホスト・ターゲットの追加ウィザードまたはEM CLIを使用してMicrosoft Windowsのターゲット・ホストに管理エージェントをインストールするには、前提条件としてホストのそれぞれにCygwinをインストールする必要があります。OMSがバージョン12.1.0.3または12.1.0.4の場合およびこれらのホストにCygwinをインストールしない場合、かわりにPsExecユーティリティをインストールし、これを使用してMicrosoft Windowsのターゲット・ホストに管理エージェントをインストールできます。この付録では、このタスクの実行方法を説明します。内容は次のとおりです。

OMSプラットフォームがUnixベースの場合のPsExecを使用した管理エージェントのインストール
OMSプラットフォームがMicrosoft Windowsの場合のPsExecを使用した管理エージェントのインストール

F.1 OMSプラットフォームがUnixベースの場合のPsExecを使用した管理エージェントのインストール

重要:

OMSプラットフォームがUnixベースの場合に管理エージェントをPsExecを使用してMicrosoft Windowsのターゲット・ホストにインストールするには、Microsoft Windowsのステージング・ホスト・サーバーが必要です。このため、ステージング・サーバーとして使用できるMicrosoft Windowsホストが、使用しているエンタープライズにあることを確認してください。

OMSホストがUnixベースのオペレーティング・システムで実行する際に、PsExecユーティリティをインストールして、これを使用してMicrosoft Windowsのターゲット・ホストに管理エージェントをインストールするには、次の手順を実行します。

PsExecユーティリティを次のURLからMicrosoft Windowsのステージング・ホスト・サーバーにダウンロードします。

http://technet.microsoft.com/en-us/sysinternals/bb897553.aspx

zipファイルのコンテンツを、特定のディレクトリに解凍します。

PsExecユーティリティのダウンロードは一度だけです。PsExecユーティリティはMicrosoft Windowsのステージング・ホスト・サーバーのみにダウンロードする必要があり、Microsoft Windowsのターゲット・ホストにはダウンロードする必要はありません。
コマンド・プロンプトから次のコマンドを実行して、PsExecユーティリティが正常に機能していることを確認します。

psexec calc

PsExecユーティリティが正常に機能している場合には、Microsoft Windowsの電卓アプリケーションが起動します。

次の手順に従って、必要な管理エージェント・ソフトウェアがMicrosoft Windowsのステージング・ホスト・サーバーにあることを確認します。

OMSホストから次のコマンドを実行し、管理エージェント・ソフトウェアがダウンロードされて適用されるプラットフォームのリストを取得します。

$<OMS_HOME>/bin/emcli get_supported_platforms

このリストに必要なMicrosoft Windowsプラットフォームが表示されていない場合、自己更新を使用してこのプラットフォーム用の管理エージェント・ソフトウェアをダウンロードおよび適用します。この実行方法の詳細は、第7.3.2項を参照してください。
管理エージェント・ソフトウェアをMicrosoft Windowsのステージング・ホスト・サーバーにダウンロードして解凍します。このタスクを実行するには、次の方法のいずれかを使用します。

方法 1: EM CLIを使用してOMSホストからソフトウェアをダウンロードし、それをFTPクライアントを使用して転送

管理エージェント・ソフトウェアをOMSホストの一時ディレクトリにダウンロードし、そのソフトウェアをWinSCPまたは他のFTPクライアントを使用してステージング・ホストに転送します。管理エージェント・ソフトウェアをOMSホストの一時ディレクトリにダウンロードするには、OMSホストから次のコマンドを実行します。

$<OMS_HOME>/bin/emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>

zipファイルをステージング・ホストに転送後、そのサイズとチェックサム値を検証し、zipファイル全体が転送されたことを確認します。zipファイルを解凍します。ZIP_LOC環境変数を$OMS_HOME/bin/zip(OMSホスト上のZIPユーティリティの場所)に設定します。

方法 2: EM CLIを使用してステージング・ホストからソフトウェアをダウンロード

EM CLIをステージング・ホスト・サーバーにダウンロードします。

これを実行する方法の詳細は、『Oracle Enterprise Managerコマンドライン・インタフェース』の「EM CLIのダウンロードとデプロイ」の章を参照してください。

EM CLIをステージング・ホストにダウンロードした後、必ずクライアントをOMSに接続します。これを実行する方法の詳細は、前述の章のEM CLIクライアントのOMSへの接続に関する項を参照してください。

次のコマンドを実行して管理エージェント・ソフトウェアをステージング・ホスト・サーバーにダウンロードします。

<emcli_install_location>\emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>

管理エージェント・ソフトウェアのzipファイルを解凍します。

重要:

(必要な管理エージェント・ソフトウェアをステージング・ホストにダウンロードする)この手順は、一度だけの操作です。ステージング・ホストに必要な管理エージェント・ソフトウェアがダウンロードされると、これを再利用して任意の数のMicrosoft Windowsターゲット・ホストに管理エージェントをデプロイできます。

My Oracle Supportノート1636851.1にアクセスします。添付されたagentDeployPsExec.batスクリプトのサイズを確認します。このスクリプトをステージング・ホストにダウンロードします。ダウンロードしたスクリプトのサイズを確認します。

管理エージェントのインストール入力を指定するレスポンス・ファイルを作成します。表F-1 にレスポンス・ファイルに含める必要のある必須パラメータと含めることができるオプション・パラメータを示します。

表 F-1 PsExecを使用して管理エージェントをインストールするためのレスポンス・ファイルの作成

パラメータ	説明
HOST_NAMES	(必須)このパラメータを使用して管理エージェントをインストールするMicrosoft Windowsのターゲット・ホストの名前を指定します。ホスト名間のセパレータとしてコロン(:)を使用します。
USER_NAME	(必須)このパラメータを使用してターゲット・ホストのログイン・ユーザー名を指定します。
PASSWORD	(必須)このパラメータを使用してターゲット・ホストのログイン・パスワードを指定します。
PSEXEC_DIR	(必須)このパラメータを使用してPsExecユーティリティをダウンロードおよび解凍する場所への絶対パスを指定します。
AGENT_IMAGE_PATH	(必須)このパラメータを使用して管理エージェント・ソフトウェアのzipファイルを解凍した場所への絶対パスを指定します。
AGENT_BASE_DIR	(必須)このパラメータを使用して管理エージェントのインストール・ベース・ディレクトリの場所を指定します。
AGENT_REGISTRATION_PASSWORD	(必須)このパラメータを使用してEnterprise Managerシステムを結合する新しい管理エージェントを登録するパスワードを指定します。
EM_UPLOAD_PORT	(必須)このパラメータを使用してOMSによる通信用のアップロード・ポート(HTTPまたはHTTPS)を指定します。
OMS_HOST	(必須)このパラメータを使用してOMSホストの名前を指定します。
REMOTE_SYS_DIR	(必須)このパラメータを使用してPsExecユーティリティがファイルのコピーまたは転送用に内部的に使用する必要のあるディレクトリを指定します。このパラメータは必ず`C:\Windows`または`C:\Windows\System32`に設定してください。
ADDITIONAL_PARAMETERS	(オプション)このパラメータを使用して使用する追加パラメータのリストを指定します。パラメータはコロンを使用して区切ります。
PROPERTIES_FILE	(オプション)このパラメータを使用してプロパティ・ファイルの絶対パスを指定します。
LOG_LOC	(オプション)このパラメータを使用して管理エージェントのデプロイメント・ログの場所を指定します。

図F-1に、サンプルのレスポンス・ファイルを示します。

図F-1 PsExecを使用して管理エージェントをインストールするためのサンプルのレスポンス・ファイル

ステージング・ホストにPERL5LIB環境変数を設定した場合にはそれを削除します。この環境変数は管理エージェントのインストール後に再度設定できます。
ステージング・ホストから次のコマンドを実行して、選択したMicrosoft Windowsターゲット・ホストに管理エージェントをインストールします。

C:\<location_of_deploy_script>\agentDeployPsExec.bat PROPERTIES_FILE=<absolute_path_to_response_file>

例: C:\stage\agentDeployPsExec.bat PROPERTIES_FILE=C:\stage\input.txt

注意:

管理エージェントのインストール・ログ・ファイルは、LOG_LOCレスポンス・ファイル・パラメータに指定した場所に作成されます。レスポンス・ファイルでLOG_LOCパラメータを指定しなかった場合、ログ・ファイルはagentDeployPsExec.batスクリプトを含むディレクトリに作成されます。

F.2 OMSプラットフォームがMicrosoft Windowsの場合のPsExecを使用した管理エージェントのインストール

重要:

OMSプラットフォームがMicrosoft Windowsの場合にPsExecを使用して管理エージェントをMicrosoft Windowsホストにインストールするには、別個のMicrosoft Windowsのステージング・ホスト・サーバーは不要です。
OMSソフトウェアがC:\以外のドライブにインストールされた場合には、$OMS_HOME\oui\prov\resources\ssPaths_msplats.propertiesにおいてSCRATCH_PATH変数を更新します。

たとえば、OMSソフトウェアがD:\にインストールされた場合、必ずSCRATCH_PATH変数をD:\tmpadaに更新してください。

OMSホストがMicrosoft Windowsで実行する際に、PsExecユーティリティをインストールして、これを使用してMicrosoft Windowsのホストに管理エージェントをインストールするには、次の手順を実行します。

次のURLからPsExecユーティリティをOMSホストにダウンロードします。

http://technet.microsoft.com/en-us/sysinternals/bb897553.aspx

zipファイルのコンテンツを、特定のディレクトリに解凍します。

PsExecユーティリティのダウンロードは一度だけです。PsExecユーティリティはOMSホストのみにダウンロードする必要があり、Microsoft Windowsのターゲット・ホストにはダウンロードする必要はありません。
コマンド・プロンプトから次のコマンドを実行して、PsExecユーティリティが正常に機能していることを確認します。

psexec calc

PsExecユーティリティが正常に機能している場合には、Microsoft Windowsの電卓アプリケーションが起動します。

次の手順に従って、必要な管理エージェント・ソフトウェアがOMSホストにあることを確認します。

次のコマンドを実行し、管理エージェント・ソフトウェアがダウンロードされて適用されるプラットフォームのリストを取得します。

$<OMS_HOME>\bin\emcli get_supported_platforms

このリストに必要なMicrosoft Windowsプラットフォームが表示されていない場合、自己更新を使用してこのプラットフォーム用の管理エージェント・ソフトウェアをダウンロードおよび適用します。この実行方法の詳細は、第7.3.2項を参照してください。
OMSホストの一時ディレクトリに管理エージェント・ソフトウェアをダウンロードします。

$<OMS_HOME>\bin\emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>

次に例を示します。

.\emcli get_agentimage -destination=C:\temp -platform="Microsoft Windows x64 (64-bit)" -version=12.1.0.4.0

管理エージェント・ソフトウェアのzipファイルを解凍します。ZIP_LOC環境変数を$OMS_HOME\bin\zip(OMSホスト上のZIPユーティリティの場所)に設定します。

重要:

(必要な管理エージェント・ソフトウェアをOMSホストにダウンロードする)この手順は、一度の操作です。OMSホストに必要な管理エージェント・ソフトウェアがダウンロードされると、これを再利用して任意の数のMicrosoft Windowsターゲット・ホストに管理エージェントをデプロイできます。

My Oracle Supportノート1636851.1にアクセスします。添付されたagentDeployPsExec.batスクリプトのサイズを確認します。このスクリプトをOMSホストにダウンロードします。ダウンロードしたスクリプトのサイズを確認します。
管理エージェントのインストール入力を指定するレスポンス・ファイルを作成します。表F-1 にレスポンス・ファイルに含める必要のある必須パラメータと含めることができるオプション・パラメータを示します。

図F-1に、サンプルのレスポンス・ファイルを示します。
OMSホストにPERL5LIB環境変数を設定した場合には、それを削除します。この環境変数は管理エージェントのインストール後に再度設定できます。
OMSホストから次のコマンドを実行して、選択したMicrosoft Windowsホストに管理エージェントをインストールします。

C:\<location_of_deploy_script>\agentDeployPsExec.bat PROPERTIES_FILE=<absolute_path_to_response_file>

例: C:\stage\agentDeployPsExec.bat PROPERTIES_FILE=C:\stage\input.txt

注意: