Apache サーバー 2.0.40、2.0.42 以降、および Apache サーバー 2.2 または 2.4(Linux、Solaris、FreeBSD のいずれか)

重要

Data Workbench 提供終了のお知らせ.

Apache Server 2.0.40、2.0.42 以降、Apache Server 2.2、または Apache Server 2.4 を Linux、Sun Solaris、FreeBSD のいずれかにインストールして設定する方法について説明します。

Sensor のプログラムファイルは、インストールファイルにパッケージ化され、Adobeダウンロードサイトから入手できます。 ご使用の Web サーバー用の Sensor インストールファイルがまだない場合は、次の手順を開始する前に、そのファイルをダウンロード ( またはAdobe担当者から入手 ) してください。

Sensor をインストールして設定するには、次の大まかな手順を実行する必要があります。

次の Apache サーバーがサポートされています。

  • RedHat Linux 7.x 以降、または Sun Solaris SPARC 2.6 以降で動作する Apache Server 2.0.40
  • Apache Server 2.0.40、2.0.42 以降、Apache Server 2.2、Apache Server 2.4(Linux、Sun Solaris、FreeBSD のいずれか)
  • RedHat Linux 7.x 以降、Sun Solaris SPARC 2.6 以降、SUSE Linux 9.x 以降、FreeBSD 5.3 以降で動作する Apache Server 2.0.42 以降
  • 64 ビットバージョンの RedHat Linux ES 4 および ES 5 で動作する Apache Server 2.0.42 以降。
  • RedHat Linux 7.x 以降または Sun Solaris SPARC 2.6 以降で動作する Apache Server 2.2
  • RedHat Linux 7.x 以降、Sun Solaris x86_64、FreeBSD のいずれかで動作する Apache Server 2.4
メモ

Apache Server バージョン 2.0.40、2.0.42 以降(32 ビットと 64 ビット)、または 2.2 を実行する Web サーバーに Sensor をインストールする手順は同じですが(以下の手順で説明します)、各バージョンのインストールファイルは異なります。 Sensor をインストールする前に、実行中の Apache サーバーおよびオペレーティングシステムのバージョンに対して、正しいインストールファイルを受け取っていることを確認してください。

プログラムファイルのインストール

Sensor のプログラムファイルを抽出してインストールする手順です。

  1. root ユーザーまたは root 権限を持つユーザーとしてログオンします。

  2. 次のコマンドを使用して、インストールファイルを解凍し、解凍します。

    • Linux の場合:

      tar -zxf installationFilename
      
      unzip -d installationFilename.tar.gz
       tar -xf installationFilename.tar
      
    • Solaris の場合:

  3. 展開済みのプログラムファイルを、次の表で指定されたディレクトリにコピーします。

ファイル 説明 ターゲットディレクトリ
mod_visual_sciences.so コレクターのロードモジュール。 IBMHttpServer/modules

txlogd

トランスミッタープログラム。

/usr/local/bin

--OR--

/usr/local/sbin

txlogd.conf Sensor 設定ファイル。 /etc
trust_ca_cert.pem 接続プロセス中に Insight サーバーが提示する電子証明書を検証するために使用される証明書 /usr/local/visual_sciences
メモ

インストールパッケージには、TestExperiment.xls という名前のスプレッドシートファイルが含まれています。 このスプレッドシートは、アーキテクトが対照実験の設定に使用するツールです。 センサー自体はこのファイルを使用しないので、Sensor が実行されているマシンにファイルをインストールする必要はありません(ただし、インストールすることは可能です)。 代わりに、アーキテクトがアクセスできる場所にファイルをコピーするか、必要に応じてインストールパッケージからファイルを抽出します。 対照実験の詳細については、『 Insight 対照実験ガイド』を参照してください。

プログラムファイルに対する権限

メモ

プログラムファイルに対する権限が正しくないと、Sensor のインストール時に発生する問題の大部分が発生します。 権限は、この節で説明したとおりに設定してください。

デフォルトでは、tar ファイル内のプログラムファイルには次の権限があります。 システムの設定によっては、ファイルを抽出する際に、これらの設定が変更(マスクなし)される場合があります。 権限を推奨されるデフォルト設定にリセットするには、次の chmod コマンドを使用します。 ファイルをインストールしたディレクトリで、少なくともこのレベルのアクセスが許可されていることを確認します。

ファイル デフォルトの権限 chmod コマンド
mod_visual_sciences.so rwx r-x r-x chmod 775
txlogd rwx —x —x chmod 711
txlogd.conf rw-r— r— chmod 664
trust_ca_cert.pem rw-r— r— chmod 664

Sametime サーバーでのログの有効化

Sametime Server にログオンするための手順です。

  1. Lotus Domino 管理者クライアントを使用して、Sametime を実行している Lotus Domino サーバーに接続します。
  2. Lotus Domino 管理者で、「ファイル」タブをクリックし、「 Sametime Configuration - stconfig.nsf 」をダブルクリックして、Sametime 設定ファイルを開きます。
  3. Sametime 設定ファイルで、コミュニティサービスフォームを開き、フォーム上の任意の場所をダブルクリックして編集モードに入ります。
  4. チャットログフラグを"strict"に設定し、キャプチャサービスの種類を"0x1000"に設定します。
  5. コミュニティサービスフォームを保存して閉じ、Sametime 設定ファイルを閉じます。
  6. Sametime サーバーを再起動します。

センサー設定ファイルの編集

この txlogd.conf ファイルには、Sensor の設定パラメータが含まれています。

このファイルを編集して、ディスクキューファイルのサイズと場所、Insight サーバーのアドレス、このセンサーによって生成されるイベントデータに添付される ID を指定する必要があります。

設定ファイルには、必須のパラメーターとオプションのパラメーターが含まれています。

  • 必須パラメーター は、Sensor をインストールする際に指定する必要がある設定です。 これらの設定がないと、センサーは正常に動作しません。
  • オプションのパラメーター は、事前定義済みの値(変更可能)をデフォルトにする設定またはオプション機能を有効にする設定です。

Sensor 設定ファイルを編集するには

  • を開きます。 /etc/txlogd.conf ファイルを編集し、必要なパラメーターと必要なオプションパラメーターを設定します。
  • ファイルを保存して閉じます。

Sensor 設定ファイルを編集するには

  1. を開きます。 /etc/txlogd.conf ファイルを編集し、必要なパラメーターと必要なオプションパラメーターを設定します。
  2. ファイルを保存して閉じます。

トランスミッターを起動し、ディスクキューを作成します。

txlogd.conf ファイルを設定した後、トランスミッタープログラムを起動し、Windows サービスとして登録し、ディスクキューを作成できます。

  1. ディスクキューが存在するディレクトリが存在しない場合は、作成します。 ディレクトリに、コレクターモジュールとトランスミッタープログラムの両方に、ファイルへの読み取り/書き込みアクセス権が付与されていることを確認します。

    ディスクキューファイルに必要な権限の詳細については、「 Sensor UNIX File Permissions 」を参照してください。

  2. センサーがインストールされているコンピューターで、次のコマンドを実行してトランスミッターを起動します。

    /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
    
    • このコマンドの「i」オプションは、トランスミッターを「インタラクティブモード」で開始します。 このモードでは、トランスミッターメッセージを画面に表示し、キーボードコマンドを使用してトランスミッターを操作できます。
    • 「c」オプションは、トランスミッターにディスクキューを作成するよう指示します。
    • 「f」オプションは、設定ファイルの場所を指定します。

    トランスミッターの開始時に使用できるオプションの詳細については、センサートランスミッターのコマンドラインオプションを参照してください。

  3. トランスミッターが、QueueFile パラメーターで指定された場所と、QueueSize パラメーターで指定されたサイズにディスクキューを作成したことを確認します。

  4. キューが正しく作成されていない場合は、Ctrl+C キーを押してトランスミッターを終了し、次の手順を実行します。

    1. txtlogd.conf ファイルを調べ、QueueFile および QueueSize パラメーターが正しく設定されていることを確認します。
    2. ディスクキューが割り当てられているデバイスが動作し、QueueSize パラメータで指定されたサイズのファイルを保持するのに十分な空き容量があることを確認します。
    3. 必要な修正を加え、この手順を繰り返します。

Web サーバーにコレクタを追加する

IBM HTTP サーバーの場合、コレクターは、Web サーバープロセスに読み込む動的共有オブジェクトです。

Web サーバーにコレクターを追加するには、以下の説明に従って httpd.conf ファイルを編集し、Web サーバーを再起動する必要があります。

センサーがサーバーコンピューター上の複数の Web サーバーのデータをキャプチャする場合は、各 Web サーバーで次の手順を実行する必要があります。

  1. テキストエディターを使用して、Sensor が取り込むイベントの Web サーバーの httpd.conf ファイルを開きます。

  2. ファイルの末尾に次の 2 行を追加します。

    LoadModule visual_sciences_module modules/mod_visual_sciences.so
    VisualSciencesConfig /etc/txlogd.conf
    
    メモ

    これらの行では大文字と小文字が区別されます。 上に表示されたとおりに入力します。

  3. Web サーバープロセスを再起動します(サーバーコンピューター全体を再起動する必要はありません。Web サーバープロセスを再起動するだけです)。 コレクタは Web サーバと共にロードされ、イベントデータの収集とディスクキューへの書き込みを開始します。

センサーをテストする

コレクターがイベントデータを収集し、トランスミッターがターゲットの Insight サーバーに送信していることを確認します。

メモ

トランスミッターが Insight サーバーにイベントデータを正常に送信できることを確認するには、次のテストを開始する前に、ターゲット Insight サーバーがインストールされ、実行されていることを確認してください。

  1. トランスミッターがまだ実行されていない場合は、次のコマンドを使用して再起動します。

    /usr/local/bin/txlogd -i -f /etc/txlogd.conf
    
  2. (任意のマシン上で)ブラウザーを開き、センサーが動作している Web サーバーからページをリクエストします(センサーが監視しているページを必ず選択してください)。

  3. リクエストを発行した後、トランスミッターのコンソールを調べて、イベントデータがターゲット Insight サーバーに送信されていることを示すメッセージを確認します。

  4. センサーがデータを正常に送信しない場合は、次の点を確認します。

    • ターゲット Insight サーバーが実行中です。
    • txtlogd.conf で ServerAddress および ServerPort パラメーターが正しく設定されている。 サーバー名を使用して ServerAddress を指定した場合は、代わりに数値の IP アドレスを使用してみてください。
    • CertName パラメーターの値は、ターゲット Insight サーバーの電子証明書に表示される共通名と完全に一致します。

システム起動スクリプトへのトランスミッターの追加

トランスミッターをシステム起動スクリプトに自動的に読み込む方法に関する情報です。

Web サーバーマシンの再起動時にトランスミッターが自動的に読み込まれるようにするには、次のコマンド(トランスミッターを起動する)をシステム起動スクリプトに追加します。

/usr/local/bin/txlogd -f /etc/txlogd.conf

このコマンドは、トランスミッターをデーモンとして起動します。 トランスミッタが生成する動作およびエラーメッセージは、syslog に書き込まれます。

このページ