JBoss サーバー、Tomcat サーバー、WebLogic サーバー（RedHat Linux または Sun Solaris）

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

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

サポートされる J2EE 実装には、以下が含まれます。

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

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

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

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

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

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

   • Linux の場合：

     tar -zxf installationFilename.tar.gz
     

   • Solaris の場合：

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

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

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

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

この 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 サーバーにコレクタを追加する

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

Web サーバーにコレクターを追加するには、 httpd.conf ファイルを開き、web サーバーを再起動します。

1. テキストエディターを使用して、 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>/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. （任意のマシン上で）ブラウザーを開き、センサーが動作している Web サーバーからページをリクエストします（センサーが監視しているページを必ず選択してください）。

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

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

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

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

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

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

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

このコマンドは、トランスミッターをデーモンとして起動します。 トランスミッターが生成するオペレーティングメッセージとエラーメッセージは、に書き込まれます syslog.

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

追加データのキャプチャ

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