Microsoft Windows Server 2000以降で実行するWebLogic Server 6.x以降用のSensorのインストールおよび設定の詳細な手順です。
Sensorのプログラムファイルは、アドビのダウンロードサイトから入手したインストールファイルにパッケージ化されます。 お使いのWebサーバー用のSensorインストールファイルがまだない場合は、次の手順を開始する前に、ダウンロード(またはアドビの担当者から入手)してください。
Sensorをインストールして設定するには、次の手順を実行する必要があります。
Sensor用のプログラムファイルを抽出してインストールする手順。
WebLogic Serverで、Sensorプログラムファイルをインストールするディレクトリを作成します。 ディスクキューはこのディレクトリに存在するので、選択したデバイスに必要なサイズのキューを保持するのに十分な領域があることを確認してください。
C:\VisualSensor
作成したディレクトリにインストールファイルの内容を抽出します。 この手順で、Sensorは次のファイルをインストールします。
ファイル | 説明 | ターゲットディレクトリ |
---|---|---|
visual_sciences.dll | コレクタロードモジュール。 | 任意のディレクトリ。 |
J2EECollector.jar | コレクタのロードモジュールライブラリ | WEB-INF/lib |
txlogd.exe |
送信プログラム。 | 任意のディレクトリ |
txlogd.conf | Sensor設定ファイル。 | 任意のディレクトリ |
trust_ca_cert.pem | 接続プロセス中にInsightサーバーが提示するデジタル証明書の検証に使用される証明書 | 任意のディレクトリ |
インストールパッケージには、という名前のスプレッドシートファイルが含まれてい TestExperiment.xlsます。 このスプレッドシートは、設計者が制御実験を設定する際に使用するツールです。 センサー自体はこのファイルを使用しないので、Sensorを実行しているコンピューターにファイルをインストールする必要はありません(ただし、インストールは可能です)。 必要に応じて、設計者がアクセスできる場所にファイルをコピーするか、インストールパッケージからファイルを抽出します。 対照実験について詳しくは、『Insight Controlled Experiments Guide』を参照してください。
このファ txlogd.conf イルには、Sensorの設定パラメーターが含まれています。
このファイルを編集して、特に、ディスクキューファイルのサイズと場所、Insightサーバーのアドレス、およびこのセンサーによって生成されるイベントデータに添付されるIDを指定する必要があります。
設定ファイルには、必須パラメーターとオプションのパラメーターが含まれています。
Sensor設定ファイルを編集するには
Sensor設定ファイルを編集するには
txlogd.confファイルを設定したら、送信プログラムを起動し、Windowsサービスとして登録し、ディスクキューを作成します。
Windowsのスタートメニューで、アクセサリ/コマンドプロンプトを選択します。
コマンドプロンプトウィンドウで、Sensorをインストールしたディレクトリに移動し、次のコマンドを実行します。
txlog /regserver
このコマンドは、トランスミッタを起動し、ディスクキューを作成し、SensorをWindowsサービスとして登録します。
送信機が正しく動作していることを確認するには、スタート/コントロールパネル/管理ツール/サービスをクリックします。
このコマンドの順序は、使用しているWindowsのバージョンによって異なる場合があります。
起動中に送信機でエラーが発生したかどうかを確認するには、スタート/コントロールパネル/管理ツール/イベントビューアをクリックし、イベントビューアを開きます。
アプリケーションログの確認が完了したら、イベントビューアを閉じます。
送信機が、Sensorプログラムファイルをインストールしたディレクトリにディスクキュー(Diskq2000.log)を作成し、txlogd.confファイルのQueueSizeパラメーターで指定したサイズであることを確認します。
キューが正しく作成されていない場合:
txtlogd.confファイルを調べ、QueueSizeパラメーターが正しく設定されていることを確認します。
Sensorをインストールしたデバイスに、QueueSizeパラメーターで指定したサイズのファイルを保持するのに十分な空き領域があることを確認します。
Windowsのサービス・コントロール・パネルを使用して、送信機を停止します。
キューファイルを削除します。
SensorをWindowsサービスとして再登録します。windowsのスタートメニューから、アクセサリ/コマンドプロンプトを選択します。 コマンドプロンプトウィンドウで、Sensorをインストールしたディレクトリに移動し、次のコマンドを実行します。
txlog /regserver
送信機は、連続的に動作するように設計されています。 コンピューターを再起動すると、送信機が自動的に再起動します。 送信機を手動で起動および停止する必要がある場合は、Windowsのサービスコントロールパネルを使用して実行できます。
JBossサーバーの場合、コレクターはサーブレットコンテナ内のフィルターとして機能します。
Webサーバーにコレクターを追加するには、以下の説明に従ってファイルを編集し、Web web.xml アプリケーションを再起動する必要があります。
テキストエディターを使用して、Sensorで取 web.xml り込んだイベントを持つ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>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サーバープロセスを再起動します(サーバーコンピューター全体を再起動する必要はなく、Webサーバープロセスを再起動します)。 コレクタは、Webサーバと共に読み込まれ、イベントデータの収集とディスクキューへの書き込みを開始する。
起動スクリプトの変更手順。
WebLogicの起動に使用するスクリプト(例:C:\bea\user_projects\mydomain\startServer.cmd)で、「set JAVA_OPTIONS=」行を編集し、java.library.pathの定義をvisual_sciences.dllファイルを含むディレクトリに設定します。
set JAVA_OPTIONS=-Djava.library.path=C:\Sensor
directory
appendToLog()機能を使用して、J2EEベースのWebアプリケーションから追加の測定データを取り込むことができます。
データを取り込む.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ページごとに、この手順を繰り返します。