Data Workbench 提供終了のお知らせ.
Microsoft Windows Server 2000 以降で実行されているIBM AIX 5.1 以降にIBM HTTP サーバーをインストールして設定する方法について説明します。
Sensor のプログラムファイルは、インストールファイルにパッケージ化され、Adobeダウンロードサイトから入手できます。 ご使用の Web サーバー用の Sensor インストールファイルがまだない場合は、次の手順を開始する前に、そのファイルをダウンロード ( またはAdobe担当者から入手 ) してください。
Sensor をインストールして設定するには、次の大まかな手順を実行する必要があります。
IBM AIX サーバーで、Sensor プログラムファイルをインストールするディレクトリを作成します。 ディスクキューもこのディレクトリに存在するので、選択したデバイスに必要なサイズのキューを保持するのに十分な空き容量があることを確認してください。
root ユーザーまたは root 権限を持つユーザーとしてログオンします。
次のコマンドを使用して、インストールファイルを解凍し、解凍します。
tar -zxf installationFilename
展開済みのプログラムファイルを、次の表で指定されたディレクトリにコピーします。
ファイル | 説明 | ターゲットディレクトリ |
---|---|---|
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 設定ファイルを編集するには
txlogd.conf ファイルを設定した後、トランスミッタープログラムを起動し、Windows サービスとして登録し、ディスクキューを作成できます。
ディスクキューが存在するディレクトリが存在しない場合は、作成します。 ディレクトリに、コレクターモジュールとトランスミッタープログラムの両方に、ファイルへの読み取り/書き込みアクセス権が付与されていることを確認します。
ディスクキューファイルに必要な権限の詳細については、「 Sensor UNIX File Permissions 」を参照してください。
センサーがインストールされているコンピューターで、次のコマンドを実行してトランスミッターを起動します。
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
トランスミッターの開始時に使用できるオプションの詳細については、センサートランスミッターのコマンドラインオプションを参照してください。
トランスミッターが、QueueFile パラメーターで指定された場所と、QueueSize パラメーターで指定されたサイズにディスクキューを作成したことを確認します。
キューが正しく作成されていない場合は、Ctrl+C キーを押してトランスミッターを終了し、次の手順を実行します。
WebSphere サーバーの場合、コレクターはサーブレットコンテナ内でフィルターとして動作します。
Web アプリにコレクターを追加するには、Sensor が取り込むイベントの Web サーバーの web.xml ファイルを開きます。
センサーがサーバーコンピューター上の複数の Web サーバーのデータをキャプチャする場合は、各 Web サーバーで次の手順を実行する必要があります。
テキストエディターを使用して、Sensor が取り込むイベントの Web サーバーの httpd.conf ファイルを開きます。
以下を追加します。 <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>
これらの行では大文字と小文字が区別されます。 上に表示されたとおりに入力します。
Web アプリケーションを再起動します。 コレクターがアプリケーションと共に読み込まれ、イベントデータの収集とディスクキューへの書き込みが開始されます。
Websphere 起動スクリプトを編集して、J2EECollector.jar ファイルと libvisual_sciences.so ファイルの場所を宣言します。
Websphere /bin ディレクトリの setupCmdLine.sh ファイルを開きます。
$WAS_CLASSPATH 変数を定義する行の後に、次の行を追加します。
WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
$WAS_LIBPATH 変数を定義する case ブロックの後に、次の行を追加します。
WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
setupCmdLine.sh ファイルを保存します。
コレクターがイベントデータを収集し、トランスミッターがターゲットの Insight サーバーに送信していることを確認します。
トランスミッターが Insight サーバーにイベントデータを正常に送信できることを確認するには、次のテストを開始する前に、ターゲット Insight サーバーがインストールされ、実行されていることを確認してください。
トランスミッターがまだ実行されていない場合は、次のコマンドを使用して再起動します。
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
(任意のマシン上で)ブラウザーを開き、センサーが動作している Web サーバーからページをリクエストします(センサーが監視しているページを必ず選択してください)。
リクエストを発行した後、トランスミッターのコンソールを調べて、イベントデータがターゲット 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 つは、ページのタグ付け手法を使用して作成されるように、追加のログエントリを作成せずに追加のデータを収集できる点です。
処理の詳細については、『データセット設定ガイド』を参照してください。
ページから追加データを取り込むには:
データの取り込み元の.jsp ページの先頭に次のコードを追加します。
<%@ page import="com.visualsciences.collector.VSCollector" %>
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 です。
追加のデータを取り込む.jsp ページごとに、この手順を繰り返します。