Agent Builder を使用して、エージェント・インストール用の圧縮パッケージを作成できます。
このタスクについて
エージェント・パッケージには、エージェントの実行に必要なすべてのファイルのほか、インストール・スクリプトと構成スクリプトも格納されます。パッケージには、モニター環境用のサポート・ファイルも組み込まれます。
エージェント・パッケージを使用すると、IBM® Tivoli® Monitoring 環境および IBM Cloud Application Performance Management 環境にエージェントをインストールできます。
手順
-
以下のいずれかの方法を使用して、Agent Builder の「プロジェクト・エクスプローラー」のナビゲーション・ツリーから itm_toolkit_agent.xml ファイルをクリックします。
- itm_toolkit_agent.xml ファイルを右クリックして、と選択します。
- itm_toolkit_agent.xml ファイルを選択して、ツールバーにある
「エージェントの生成」アイコンを選択します。
- itm_toolkit_agent.xml ファイルをダブルクリックして、を選択します。
-
「エージェント・イメージの生成」セクションで、出力 (圧縮したパッケージまたは展開したファイル) を格納するディレクトリーの名前を入力します。
- オプション:
生成された展開ファイルを zip ファイルまたは tar ファイルとは別に保持する場合は、「中間ファイルの保持」チェック・ボックスを選択します。
-
「ZIP ファイルの作成」チェック・ボックスを選択して、指定したディレクトリーに圧縮ファイルを作成します。Windows システムでの圧縮 zip ファイルのデフォルトの名前は smai-agent_name-version.zip です。
-
「TAR ファイルの作成」チェック・ボックスを選択して、指定したディレクトリーに tar ファイルを作成します。UNIX システムおよび Linux システムでの圧縮 tar ファイルのデフォルトの名前は
smai-agent_name-version.tgz です。
- 生成するエージェント・コンポーネントを選択します。「基本エージェント」または「Cognos レポート」、あるいはその両方を選択できます。
重要: IBM Cloud Application Performance Management 環境では「Cognos レポート」を選択しないでください。現時点ではこのレポートはサポートされておらず、またこのレポートを含めるとパッケージのサイズが増大するためです。
-
オプションで、エージェント・アプリケーション・ファイルのセキュリティー署名を指定できます。セキュリティー署名を指定する場合は、「自己記述型サポート JAR に署名」を選択します。「すべての JAR 署名設定を編集」をクリックします。署名した JAR ファイルにタイム・スタンプを追加し、時刻認証局を指定できます。ご使用の Java™ 鍵ストア・ファイルに関する詳細を指定します。
重要: Java ツールを使用することにより Java 鍵ストア・ファイルを作成できます。例えば、秘密鍵と証明書を対応する公開鍵と共に Java 鍵ストア・ファイルで生成するには、以下のコマンドを実行します。
- ab_install_path/jre/bin/keytool
-genkeypair -keystore keystore_file_path -storepass key_store_password -alias key_store_alias -dname
"CN=common_name, OU=organizational_unit,
L=city_or_locality, ST=state_or_province,
C=country" -keypass key_password
各部の意味は次のとおりです。
- ab_install_path は、Agent Builder がインストールされているロケーションです。
- keystore_file_path は、既存の JKS 鍵ストアが存在するパス、または JKS 鍵ストアが作成されるパスです。
- key_store_password は、この鍵ストア内のすべての項目にアクセスするために必要なパスワードです。
- key_store_alias は、鍵ストア内でこの鍵を識別する名前です (デフォルトは "mykey")。
- key_password は、この特定の鍵にアクセスするために必要なパスワードです (デフォルトは key_store_password)。
この証明書をサーバーの鍵ストアに含めます。
- 「完了」をクリックします。