Windows でのホスト・エージェントのインストール

オンラインで編集する

要件に応じて、さまざまな方法を用いて、 Windows ホストに Instana エージェントをインストールできます。 利用可能なすべての設置オプションについては、以下のリストを参照してください：

注： エージェントのインストール後、 Windows コンピュータに以下のレジストリエントリが追加されます。 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\PerfProc\Performance:"ProcessNameFormat"=2 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\.NETFramework\Performance:"ProcessNameFormat"=2 これらのレジストリエントリは、 InstanaPCP がパフォーマンスカウンターからのすべてのメトリクスを正しく関連付けるために必要です。

Windows インストーラーを使用して、ホストエージェントを対話モードでインストールする

オンラインで編集する

Windows インストーラを使用してホストエージェントを対話形式でインストールするには、以下の手順を実行してください：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。

  2. エージェント展開カタログページで、 「 Windows - Windows Installer 64 bit 」というタイルをクリックします。 「 Windows - Windows 」の64ビット版インストーラーのページが開きます。

    注： ユーザー操作を一切行わずにインストールプロセスをサイレントモードで実行する場合は、「 Windows - Windows Installer 64 bit (unattended)」オプションを選択し、 「ホストエージェントのサイレントインストール 」セクションの手順に従ってください。

  3. ダイナミックまたはスタティック・ホスト・エージェントのパッケージング・オプションと、選択したJDKのランタイム・オプションを選択する。

  4. ダウンロードリンクをクリックして、「 Windows 」のインストーラーファイルを保存してください。

  5. 「 Windows 」インストーラを実行し、 Windows ホストコンピュータ上で「 Instana Agent Setup」ウィザードを開きます。 ウィザードに従ってエージェントをインストールします。

  6. ウィザードの「 Instana エージェントの設定 」ステップで、 Instana UIの 「 Windows - Windows Installer 64 bit 」ページから以下の情報をコピーして貼り付けてください。

    • Instana バックエンド・アドレス
    • Instana バックエンド・ポート
    • Instana エージェント・キー
    • 鍵のダウンロード

ウィザードは、エージェントのインストールに加え、前提条件となるソフトウェア（.NET Framework、 4.5、および JVM ）もインストールします。また、エージェントをサービスとして登録し、サービスの自動起動を設定した上で、インストール完了後にサービスを開始します。

エージェントをインストールした後、必要に応じてエージェントを管理および設定することができます。 詳細については、 Windows の「エージェントの管理」 を参照してください。

ホストエージェントのサイレントインストール

オンラインで編集する

ユーザー操作を必要とせずにホストエージェントをインストールするには、以下の手順に従って Windows インストーラーをサイレントモードで実行してください：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。

  2. エージェント展開カタログページで、 「 Windows インストーラー 64 ビット（無人インストール）」 のタイルをクリックします。

  3. 記載されているリンクから「 Windows 」のインストーラーをダウンロードしてください。

  4. 次の例に示すように、インストール・コマンドをコピーして展開する：

    注：Instana エージェントをインストールすると、システムの起動時にエージェントが自動的に起動します。 自動起動を無効にするには、インストールコマンドに INSTANA_SERVICE_MODE=manual を追加してください。
    @ECHO OFF

<installer_file_name> INSTANA_AGENT_ENDPOINT=<your_host> INSTANA_AGENT_ENDPOINT_PORT=<your_port> INSTANA_AGENT_KEY=<your_agent_key> INSTANA_DOWNLOAD_KEY=<your_agent_key> /quiet

    <installer_file_name>」は、ステップ3でダウンロードしたインストーラーファイルの名前に置き換えてください。

    注： GUIが表示されないようにするには、この /quiet スイッチを指定する必要があります。これにより、ユーザーの操作を一切必要とせずに、インストールプロセスをサイレントモードで実行できます。 その他の必要なパラメータは、エージェント展開コードにあらかじめ入力されています。

  5. ホストエージェントをインストールしたい Windows ホストコンピュータで、インストールコマンドを実行してください。 インストールプロセスは、エージェントのインストール作業をバックグラウンドで実行し、前提条件となるソフトウェア（.NET Framework、 4.5、および JVM ）のインストールも自動的に行います。

    インストーラはまた、エージェントをサービスとして登録し、サービスを自動的に開始するように設定し、インストール後にサービスを開始します。

エージェントをインストールした後、必要に応じてエージェントを管理および設定することができます。 詳細については、 Windows の「エージェントの管理」 を参照してください。

.zip ファイルを使用したホストエージェントのインストール

オンラインで編集する

ホストエージェントを手動でインストールするには、ホストエージェントの「.zipファイルをダウンロードして解凍します。

注： この.zipファイルにはエージェントファイルが含まれていますが、ホストエージェントの実行に必要な JVM は含まれていません。 ホストエージェントをインストールする Windows ホストコンピュータに、サポート対象の JVM がインストールされていることを確認してください。

.zipファイルを使用してホストエージェントをインストールするには、以下の手順を実行します：

  1. エージェントアーカイブをローカルシステムにダウンロードする：

    1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。

    2. エージェント展開カタログページで、 「 Windows - Zip Archives」 のタイルをクリックします。

    3. エージェントのパッケージングモード（DynamicまたはStatic）を選択します。 動的ホスト・エージェントと静的ホスト・エージェントの詳細については、ホスト・エージェントの種類を参照してください。

    4. 32ビット版または64ビット版の Windows のダウンロードリンクをクリックして、ファイルを .zip 保存してください。

      ファイル .zip は、 Windows のホストコンピュータにダウンロードされます。

  2. ダウンロードした'.zipファイルをフォルダ（例えば'<instana-agent-install-dir>）に解凍します。

  3. 以下のコマンドを実行してエージェントを開始します。

    <instana-agent-install-dir>\bin\start.bat

    ホストエージェントは、あなたのアカウント設定で事前に構成されています。

エージェントをインストールした後、必要に応じてエージェントを管理および設定することができます。 詳細については、 Windows の「エージェントの管理」 を参照してください。

エアギャップ環境の Windows へのホストエージェントのインストール

オンラインで編集する

エアギャップ環境の Windows にホストエージェントをインストールするには、以下の手順を実行してください：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。

  2. 「 Instana エージェントのインストール」ページで、「 Windows – エアギャップ環境用（アーカイブ、インストーラー） 」のタイルをクリックします。

  3. 「 Windows - Air-gapped（インストーラー、アーカイブ - 32bit, 64bit ）」ページで、「 インストーラーまたはアーカイブをダウンロード 」アイコンをクリックし、 URL をコピーします。 次に、コピーした URL を新しいブラウザウィンドウに貼り付けてダウンロードページを開きます。そこでは、インストーラーとアーカイブファイル.zipの両方が入手可能です。 お好みのインストール方法に合わせて、インストーラーまたはアーカイブ（.zip）ファイルをダウンロードしてください。

  4. インストーラーをダウンロードした場合は、 「 Windows インストーラーを使用したホストエージェントの対話型インストール 」の手順を参照し、エアギャップ環境の Windows にエージェントをインストールしてください。

  5. アーカイブ（.zip.zip ）ファイルをダウンロードした場合は、「.zip ファイルを使用したホストエージェントのインストール」の手順を参照し、エアギャップ環境の Windows にエージェントをインストールしてください。

オプション：ホストエージェントを Windows サービスとしてインストールする

オンラインで編集する

ホストエージェントを Windows サービスとしてインストールする場合は、 Windows サービスラッパーの使用をお勧めします。 サービスラッパーの詳細については、 WinSW を参照してください。

ホストエージェントを Windows サービスとしてインストールするには、以下の手順を実行してください：

  1. WinSWリリースページからサービスラッパーファイル「WinSW-<version>.exe」をダウンロードし、アーカイブを解凍したフォルダに保存します。

  2. サービス・ラッパー・ファイルの名前を'instana-agent.exeに変更する。

  3. 同じディレクトリに「instana-agent.xmlコンフィギュレーション・ファイルを作成し、以下のコンフィギュレーションをコピーする。 Windows この設定ファイルを使用してサービスラッパーを呼び出し、ホストエージェントを起動します。

    <service>
 <id>instana-agent</id>
 <name>Instana Agent</name>
 <description>Instana Agent</description>
 <!-- start -->
 <executable>"<instana-agent-install-dir>\bin\karaf.bat"</executable>
 <startargument>daemon</startargument>
 <!-- stop -->
 <stopexecutable>"<instana-agent-install-dir>\bin\karaf.bat"</stopexecutable>
 <stopargument>stop</stopargument>
 <stoptimeout>10sec</stoptimeout>
 <!-- logging -->
 <logpath><instana-agent-install-dir>\data\log</logpath>
 <log mode="roll-by-time">
   <pattern>yyyyMMdd</pattern>
 </log>
</service>

  4. と instana-agent.exe instana-agent.xml ファイルを保存したディレクトリで、次のコマンドを実行して、ホストエージェントを Windows サービスとしてインストールします。

    instana-agent.exe install

    次に、次のコマンドを実行して、ホストエージェントの Windows サービスを開始します：

    net start instana-agent-service

エージェントをインストールした後、必要に応じてエージェントを管理および設定することができます。 詳細については、 Windows の「エージェントの管理」 を参照してください。