IBM HTTP Server(AIX 5.1以降)

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

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

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

Install the Program Files

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

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

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

    tar -zxf installationFilename
    
  3. 展開したプログラムファイルを、次の表に示すディレクトリにコピーします。

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

txlogd

送信プログラム。

/usr/local/bin

--OR--

/usr/local/sbin

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

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

プログラムファイルの権限

メモ

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

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

File デフォルトの権限 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は正常に実行されません。
  • オプションのパラメータ は、デフォルトで事前定義された値(変更可能)に設定される設定、またはオプション機能を有効にする設定です。

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

  • テキストエデ /etc/txlogd.conf ィターでファイルを開き、必要なパラメーターと必要なオプションのパラメーターを設定します。
  • ファイルを保存して閉じます。

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

  1. テキストエデ /etc/txlogd.conf ィターでファイルを開き、必要なパラメーターと必要なオプションのパラメーターを設定します。
  2. ファイルを保存して閉じます。

送信機を起動し、ディスク・キューを作成する

txlogd.confファイルを設定したら、送信プログラムを起動し、Windowsサービスとして登録し、ディスクキューを作成します。

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

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

  2. Sensorがインストールされているコンピューターで、次のコマンドを実行して送信機を起動します。

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

    送信機の起動時に使用できるオプションについて詳しくは、Sensor Transmitter Command-Line Optionsを参照してください。

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

  4. キューが正しく作成されていない場合は、Ctrl + Cキーを押して送信機を終了し、次の手順を実行します。

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

Webアプリケーションへのコレクタの追加

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

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

Sensorがサーバーコンピューター上の複数の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変数を定義するケースブロックの後に、次の行を追加します。

    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. (任意のマシン上の)ブラウザーを開き、Sensorが実行されているWebサーバーからページを要求します(Sensorが監視しているページを必ず選択してください)。

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

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

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

システム起動スクリプトへの送信機の追加

システムの起動スクリプトへの送信機の自動読み込みに関する情報です。

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

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

このコマンドは、送信機をデーモンとして起動します。 送信機が生成する動作メッセージとエラーメッセージはsyslogに書き込まれます。

追加データの取得

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

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

メモ

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

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

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

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

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

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

    <%@ page import="com.visualsciences.collector.VSCollector" %>
    
  2. コレクタオブジェクトの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ページごとに、この手順を繰り返します。

このページ