Data Workbench 提供終了のお知らせ.
RedHat Linux 7.x 以降、SUSE Linux 9.x 以降、Sun Solaris SPARC 2.6 以降、Sun Solaris x86 9 以降、FreeBSD 4 以降、Mac OS X PowerPC 上に Sensor をインストールして設定する手順の詳細。
Sensor のプログラムファイルは、インストールファイルにパッケージ化され、Adobeダウンロードサイトから入手できます。 ご使用の Web サーバー用の Sensor インストールファイルがまだない場合は、次の手順を開始する前に、そのファイルをダウンロード ( またはAdobe担当者から入手 ) してください。
Sensor をインストールして設定するには、次の大まかな手順を実行する必要があります。
Sensor のプログラムファイルを抽出してサーバーマシンにインストールする手順。
root ユーザーまたは root 権限を持つユーザーとしてログオンします。
次のコマンドを使用して、インストールファイルを解凍し、解凍します。
Linux の場合:
tar -zxf installationFilename.tar.gz
Solaris の場合:
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
展開済みのプログラムファイルを、次の表で指定されたディレクトリにコピーします。
ファイル | 説明 | ターゲットディレクトリ |
---|---|---|
mod_visual_sciences.so | コレクターロードモジュール | apachePath/libexec |
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 コマンド |
---|---|---|
mod_visual_sciences.so | rwx r-x r-x | chmod 755 |
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 設定ファイルを編集するには
txlogd.conf ファイルを設定した後にディスクキューを作成する手順。
ディスクキューが存在するディレクトリが存在しない場合は、作成します。 ディレクトリに、コレクターモジュールとトランスミッタープログラムの両方に、ファイルへの読み取り/書き込みアクセス権が付与されていることを確認します。
センサーがインストールされているコンピューターで、次のコマンドを実行してトランスミッターを起動します。
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
トランスミッターが、QueueFile パラメーターで指定された場所と、QueueSize パラメーターで指定されたサイズにディスクキューを作成したことを確認します。
キューが正しく作成されていない場合は、Ctrl+C キーを押してトランスミッターを終了し、次の手順を実行します。
Apache サーバーの場合、コレクターは、Web サーバープロセスに読み込む動的共有オブジェクトです。
Web サーバーにコレクターを追加するには、以下の説明に従って httpd.conf ファイルを編集し、Web サーバーを再起動する必要があります。
センサーがサーバーコンピューター上の複数の Web サーバーのデータをキャプチャする場合は、各 Web サーバーで次の手順を実行する必要があります。
テキストエディターを使用して、 httpd.conf ファイルを作成します。
ファイルの末尾に次の行を追加します。
LoadModule visual_sciences_module libexec/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
AddModule mod_visual_sciences.c
これらの行では大文字と小文字が区別されます。 上に表示されたとおりに入力します。
Web サーバーを再起動します。 コレクターは Web サーバーと共に読み込まれ、イベントデータの収集とディスクキューへの書き込みを開始します。
トランスミッターを起動し、Insight サーバーに接続して、イベントデータを送信できることを確認します。
トランスミッターが Insight サーバーにイベントデータを正常に送信できることを確認するには、次のテストを開始する前に、ターゲット Insight サーバーがインストールされ、実行されていることを確認してください。
トランスミッターがまだ実行されていない場合は、次のコマンドを使用して再起動します。
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
(任意のマシン上で)ブラウザーを開き、センサーが動作している Web サーバーからページをリクエストします(センサーが監視しているページを必ず選択してください)。
リクエストを発行した後、トランスミッターのコンソールを調べて、イベントデータがターゲット Insight サーバーに送信されていることを示すメッセージを確認します。
センサーがデータを正常に送信しない場合は、次の点を確認します。
ターゲット Insight サーバーが実行中です。
この ServerAddress および ServerPort パラメーターが txtlogd.conf.
指定した場合 ServerAddress サーバー名を使用し、代わりに数値 IP アドレスを使用してみてください。 の値 CertName パラメーターは、ターゲット Insight サーバーの電子証明書に表示される共通名と完全に一致します。
Web サーバーマシンを再起動したときに、トランスミッターが自動的に読み込まれるようにする情報です。
次のコマンド(トランスミッターを起動する)をシステム起動スクリプトに追加します。
/usr/local/bin/txlogd -f /etc/txlogd.conf
このコマンドは、トランスミッターをデーモンとして起動します。 トランスミッタが生成する動作およびエラーメッセージは、syslog に書き込まれます。
一部の Solaris ユーザーで、「mutex を取得できません」というエラーが発生する場合があります。 Sensor がこれらのシステムで正しく機能するには、次の行を/etc/system ファイルに追加または編集する必要があります。
semsys:seminfo_semmnu=1024
デフォルトの Solaris 設定は 60 です。 Sensor で実施されたテストに基づき、各インスタンスに 3 つのセマフォを使用します。Adobeでは、1024 を設定として使用することをお勧めします。 この数値は、セマフォを必要とする可能性のあるサーバー上の他のアプリケーションと共に Sensor が機能するのに十分な高さですが、パフォーマンスには影響しません。 この勧告を支持するため、Adrian Cockcroft は彼の著書 Sun Performance and Tuning (Prentice Hall, 1994 年 10 月)で以下の内容を述べています。「データベースは、多くの共有メモリとセマフォの設定を使う傾向があります。 これらはパフォーマンスに影響を与えません。十分大きい限り、プログラムは動くだろう」