RedHat LinuxまたはSun Solaris上のJBoss、Tomcat、WebLogic Server

RedHat Linux 7.x以降、Sun Solaris SPARC 2.6以降、またはSun Solaris x86 9以降で実行するJ2EE実装用のSensorのインストールおよび設定の詳細な手順。

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

次のJ2EE実装がサポートされています。

• JBoss Server 3.2.x以降
• Apache Jakarta Tomcat Server 4.1以降
• WebLogic Server 6.x以降

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

Install the Program Files

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

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

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

   • Linuxの場合：

     tar -zxf installationFilename.tar.gz
     

   • Solarisの場合：

     unzip -d installationFilename.tar.gz 
      tar -xf installationFilename.tar
     

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

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

File	デフォルトの権限	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

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

このファ 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サーバーへのコレクタの追加

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

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

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

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>/etc/txlogd.conf</param-value> 
     <description></description> 
     </init-param> 
   </filter> 
   
   <filter-mapping> 
     <filter-name>VSCollectorFilter</filter-name> 
     <url-pattern>/*</url-pattern> 
   </filter-mapping> 
   

   メモ

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

3. Webサーバープロセスを再起動します（サーバーコンピューター全体を再起動する必要はなく、Webサーバープロセスを再起動します）。 コレクタは、Webサーバと共に読み込まれ、イベントデータの収集とディスクキューへの書き込みを開始する。

センサーのテスト

コレクターがイベントデータを収集し、送信者がそのデータをターゲットの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す。

デフォルトのSolaris設定は60です。 各インスタンスに3つのセマフォーを使用するSensorで実行されたテストに基づいて、1024を設定として使用することをお勧めします。 この数値は、セマフォーを必要とする可能性のある他のアプリケーションと共にSensorが機能するのに十分な値ですが、パフォーマンスには影響しません。 この推奨を支持するため、Adrian Cockcroftは著書Sun Performance and Tuning（Prentice Hall、1994年10月）で以下の内容を述べています。「データベースは、多くの共有メモリとセマフォの設定を使う傾向があります。 これらはパフォーマンスに影響を与えません。十分大きい限り、プログラムは動く」

追加データの取得

すべてのプラットフォームのセンサーは、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ページごとに、この手順を繰り返します。