RedHat Linux 7.x以降、Sun Solaris SPARC 2.6以降、またはSun Solaris x86 9以降で実行するJ2EE実装用のSensorのインストールおよび設定の詳細な手順。
Sensorのプログラムファイルは、アドビのダウンロードサイトから入手したインストールファイルにパッケージ化されます。 お使いのWebサーバー用のSensorインストールファイルがまだない場合は、次の手順を開始する前に、ダウンロード(またはアドビの担当者から入手)してください。
次のJ2EE実装がサポートされています。
Sensorをインストールして設定するには、次の手順を実行する必要があります。
Sensor用のプログラムファイルを抽出してインストールする手順。
rootユーザーまたはroot権限を持つユーザーとしてログオンします。
次のコマンドを使用して、インストールファイルを解凍し、解凍します。
Linuxの場合:
tar -zxf installationFilename.tar.gz
Solarisの場合:
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
展開したプログラムファイルを、次の表に示すディレクトリにコピーします。
ファイル | 説明 | ターゲットディレクトリ |
---|---|---|
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コマンド |
---|---|---|
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設定ファイルを編集するには
txlogd.confファイルを設定したら、送信プログラムを起動し、Windowsサービスとして登録し、ディスクキューを作成します。
ディスクキューが存在するディレクトリが存在しない場合は、作成します。 ディレクトリがコレクタ・モジュールと送信プログラムの両方にファイルへの読み取り/書き込みアクセスを提供していることを確認します。
ディスクキューファイルに必要な権限について詳しくは、Sensor UNIX File Permissionsを参照してください。
Sensorがインストールされているコンピューターで、次のコマンドを実行して送信機を起動します。
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
送信機の起動時に使用できるオプションについて詳しくは、Sensor Transmitter Command-Line Optionsを参照してください。
送信機が、QueueFileパラメーターで指定された場所と、QueueSizeパラメーターで指定されたサイズのディスクキューを作成したことを確認します。
キューが正しく作成されていない場合は、Ctrl + Cキーを押して送信機を終了し、次の手順を実行します。
Apacheサーバーの場合、コレクターは、Webサーバープロセスに読み込む動的共有オブジェクトです。
Webサーバーにコレクターを追加するには、以下の説明に従ってファ httpd.conf イルを編集し、Webサーバーを再起動する必要があります。
Sensorがサーバーコンピューター上の複数のWebサーバーのデータを取り込む場合は、各Webサーバーに対して次の手順を実行する必要があります。
テキストエディターを使用して、Sensorで取 httpd.confり込んだイベントを含むWebサーバーのファイルを開きます。
次の要素と要素を <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>
これらの行では大文字と小文字が区別されます。 上に表示されたとおりに入力します。
Webサーバープロセスを再起動します(サーバーコンピューター全体を再起動する必要はなく、Webサーバープロセスを再起動します)。 コレクタは、Webサーバと共に読み込まれ、イベントデータの収集とディスクキューへの書き込みを開始する。
コレクターがイベントデータを収集し、送信者がそのデータをターゲットのInsightサーバーに送信していることを確認します。
送信機がイベントデータをInsightサーバーに正常に送信できることを確認するには、次のテストを開始する前に、ターゲットのInsightサーバーがインストールされ、実行されていることを確認します。
トランスミッタがまだ実行されていない場合は、次のコマンドを使用して再起動します。
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
(任意のマシン上の)ブラウザーを開き、Sensorが実行されているWebサーバーからページを要求します(Sensorが監視しているページを必ず選択してください)。
リクエストを発行した後、送信機のコンソールで、送信機がターゲットの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つの利点は、ページタギング手法を使用して作成されるように、追加のログエントリを作成せずに追加のデータを収集できることです。
処理について詳しくは、『データセット設定ガイド』を参照してください。
ページから追加のデータを取り込むには
データを取り込む.jspページの先頭に次のコードを追加します。
<%@ page import="com.visualsciences.collector.VSCollector" %>
コレクタオブジェクトの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です。
追加のデータを取り込む.jspページごとに、この手順を繰り返します。