IBM HTTP サーバー(AIX 5.1 以降)

重要

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

Microsoft Windows Server 2000 以降で実行されているIBM AIX 5.1 以降にIBM HTTP サーバーをインストールして設定する方法について説明します。

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

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

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

IBM AIX サーバーで、Sensor プログラムファイルをインストールするディレクトリを作成します。 ディスクキューもこのディレクトリに存在するので、選択したデバイスに必要なサイズのキューを保持するのに十分な空き容量があることを確認してください。

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

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

    tar -zxf installationFilename
    
  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 コマンド
libvisual_sciences.so rwx —x —x

chmod 711

J2EECollector.jar rw-rw-r-— chmod 664
txlogd rwx —x —x chmod 711
txlogd.conf rw-rw-r-— chmod 664
trust_ca_cert.pem rw-rw-r-— chmod 664

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

この 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 アプリケーションにコレクタを追加

WebSphere サーバーの場合、コレクターはサーブレットコンテナ内でフィルターとして動作します。

Web アプリにコレクターを追加するには、Sensor が取り込むイベントの Web サーバーの web.xml ファイルを開きます。

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

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

  2. 以下を追加します。 <filter> および <filter-mapping> 記述子ファイルの要素。 /etc ディレクトリに txlogd.conf をインストールしなかった場合は、 <param-value> 要素。

    <filter>
      <filter-name>VSCollectorFilter</filter-name>
      <description></description>
      <filter-class>
          com.visualsciences.collector.VSCollectorFilter
        </filter-class>
      <init-param>
        <param-name>configPath</param-name>
        <param-value>C:/VisualSensor/txlogd.conf</param-value>
      <description></description>
      </init-param>
    </filter>
    
    <filter-mapping>
      <filter-name>VSCollectorFilter</filter-name>
      <url-pattern>/*</url-pattern>
    </filter-mapping>
    
    メモ

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

  3. Web アプリケーションを再起動します。 コレクターがアプリケーションと共に読み込まれ、イベントデータの収集とディスクキューへの書き込みが開始されます。

コレクターと共有オブジェクトファイルの場所を宣言する

Websphere 起動スクリプトを編集して、J2EECollector.jar ファイルと libvisual_sciences.so ファイルの場所を宣言します。

  1. Websphere /bin ディレクトリの setupCmdLine.sh ファイルを開きます。

  2. $WAS_CLASSPATH 変数を定義する行の後に、次の行を追加します。

    WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
    
  3. $WAS_LIBPATH 変数を定義する case ブロックの後に、次の行を追加します。

    WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
    
  4. setupCmdLine.sh ファイルを保存します。

センサーをテストする

コレクターがイベントデータを収集し、トランスミッターがターゲットの 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 に書き込まれます。

追加データのキャプチャ

すべてのプラットフォームのセンサーは、HTTP リクエストヘッダーと応答ヘッダーで使用可能な任意のデータを収集できます。

J2EE プラットフォーム用のセンサーは、他のプラットフォームでは利用できないデータを収集するメカニズムを提供します。 J2EE プラットフォーム(J2EE コレクター)のコレクターは、アプリケーションレイヤー上に配置され、アプリケーションでのみ使用可能で、ページタグ付けやヘッダーで公開されない機密データを収集できます。

メモ

ページタグやヘッダーの変更によってデータが非表示になる場合がありますが、ページのソースコードを調べたり、ブラウザープラグインツールを使用してヘッダーを確認したりするユーザーは引き続き使用できます。

例えば、J2EE コレクターを使用して、ページに表示されるリンクのクリック単価 (CPC) データや、ページ上の機密パートナー情報、その他多くのデータポイントを取り込むことができます。 J2EE 環境を使用すると、Web アプリを変更して、アドビのコレクタークラスを使用してこのカスタムデータを簡単に取り込むことができます。

J2EE プラットフォームのセンサーがリクエストを受け取ると、appendToLog 関数を読み込むコレクタークラスを呼び出します。 appendToLog 関数は、最初のリクエストに appendToLog 関数で指定されたクエリー文字列パラメーターを追加します。 これにより、取り込まれるデータの名前と値に対応する追加のクエリー文字列の名前と値のペアを含む最初のリクエストの URI が生成されます。 例えば、特定の広告配置またはクリックスルーリンクの値が 20 セントの場合、CPC=20 が初期リクエストに追加されます。 Insight サーバーは、これらの値を分析用にデータセットに処理します。 この収集方法のもう 1 つの利点の 1 つは、ページのタグ付け手法を使用して作成されるように、追加のログエントリを作成せずに追加のデータを収集できる点です。

処理の詳細については、『データセット設定ガイド』を参照してください。

ページから追加データを取り込むには:

  1. データの取り込み元の.jsp ページの先頭に次のコードを追加します。

    <%@ page import="com.visualsciences.collector.VSCollector" %>
    
  2. collector オブジェクトの appendToLog() メソッドを使用して、要求された.jsp ページのクエリ文字列に必要な名前と値のペアを追加します。 次の例では、/index.jspページに対して要求された.jsp ページのクエリー文字列に"A=1"と"B=2"を追加します。

    <html>
    <body>
      <h1>Hello World</h1>
      <%
        VSCollector collector = new VSCollector(request, response);
        collector.appendToLog("A", "1");
        collector.appendToLog("B", "2");
      %>
    </body>
    </html>
    

    結果のリクエスト URI は/index.jsp?A=1&B=2 です。

  3. 追加のデータを取り込む.jsp ページごとに、この手順を繰り返します。

このページ