4 RUEIソフトウェアのインストール

この章では、Apache WebサーバーとRUEIソフトウェアのインストール手順について説明します。既存のRUEI 5.xインストールをリリース6.5にアップグレードする手順については、第5章「RUEI 6.5.1へのアップグレード」で説明しています。インストール後の構成手順については、第6章「RUEIの構成」で説明しています。

RUEIソフトウェアの解凍

ダウンロードしたRUEI zipファイルをサーバーの/rootディレクトリにコピーし、解凍します。次のコマンドを使用します。

cd /root
unzip package_name.zip

RUEIのインストールを完了するために必要なソフトウェアが含まれている次のディレクトリが作成されます。

• /root/RUEI/65

• /root/RUEI/ZendOptimizer

• /root/RUEI/IC

• /root/RUEI/PHP

• /root/RUEI/Java

• /root/RUEI/extra

一般的なインストール作業

この項で説明されている手順は、予定しているインストール（すなわち、ローカル・データベースを持つレポータ、リモート・データベースを持つレポータ、またはコレクタ）に関係なく、すべて実行する必要があります。

RUEI構成ファイル

/etc/ruei.confファイルでは、インストール内で使用する設定が指定されています。RUEI環境内のすべてのコンポーネント（リモート・データベースやコレクタなど）には、同じグローバルな/etc/ruei.conf構成ファイルが必要です。表4-1に示す設定が定義されています。

表4-1 RUEIの設定

設定	説明脚注1	値
RUEI_HOME脚注2	RUEIソフトウェアのホーム・ディレクトリ。	/opt/ruei
RUEI_DATA脚注2	RUEIデータ・ファイルのディレクトリ。	/var/opt/ruei
RUEI_USER	RUEIオペレーティング・システム・ユーザー。	moniforce
RUEI_GROUP	RUEIオペレーティング・システム・グループ。	moniforce
RUEI_DB_INST脚注3	データベース・インスタンス名。	ux
RUEI_DB_USER脚注4	データベース・ユーザー名。	UXINSIGHT
RUEI_DB_TNSNAME脚注5	データベース接続文字列。	uxinsight

^脚注1 この表で指定されている変数はすべて、このマニュアル全体を通して使用される値であり、必要に応じて変更できます。

^脚注2 ディレクトリ名は50文字以内です。

^脚注3 データベース・インスタンス名は8文字以内です。

^脚注4 データベース・ユーザー名は30文字以内です。

^脚注5 別名は255文字以内です。

RUEIディストリビューション・パックに含まれているソフトウェアを使用する場合は、JAVA_HOMEおよびINSTANTCLIENT_DIRの設定を変更する必要はありません。

1. moniforceグループおよびユーザーを作成します。moniforceのホーム・ディレクトリは、グループ・メンバーの読取り権限付きで/var/opt/rueiに設定する必要があります。

   /usr/sbin/groupadd moniforce
   /usr/sbin/useradd moniforce -g moniforce -d /var/opt/ruei
   chmod -R 750 /var/opt/ruei
   chown -R moniforce:moniforce /var/opt/ruei
   

2. 構成ファイルの例は、RUEIディストリビューション・パックに含まれています。次のコマンドを発行することにより、ファイルがRUEI_USERユーザーに読取り可能であることを確認します。

   cp /root/RUEI/extra/ruei.conf /etc/
   chmod 644 /etc/ruei.conf
   chown moniforce:moniforce /etc/ruei.conf
   

リモート・データベース・インストールの場合、ruei.confファイルは、レポータ・システムのものと同一である必要があります。

Javaのインストール

レポータおよびコレクタの両システムには、Java Runtime Environment（JRE）をインストールする必要があります。Javaは、RUEIディストリビューション・パックにバンドルされています。

1. 次のコマンドを発行します。

   cd /root/RUEI/Java
   chmod +x ./jre-1_5_0_22-linux-amd64-rpm.bin
   ./jre-1_5_0_22-linux-amd64-rpm.bin
   

   Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。

2. これにより、必要なJavaソフトウェアが/usr/java/jre1.5.0_22ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。

   ln -s /usr/java/jre1.5.0_22 /usr/java/jre
   

リモート・コレクタのインストール

レポータまたはリモート・データベース・サーバーの場合、この項は省略してかまいません。

コレクタ・システムにrootユーザーとしてログオンし、次のようにします。

1. RUEIのファイルとディレクトリの場所は固定です。したがって、後述の正確なディレクトリ名を使用する必要があります。次のコマンドを使用して、RUEIアプリケーションのルート・ディレクトリを作成します。

   mkdir -p /opt/ruei
   chmod 750 /opt/ruei
   

2. RUEIルート・ディレクトリに変更し、次のコマンドを使用してruei-install.shスクリプトを実行します。

   cd /root/RUEI/65
   chmod +x ruei-install.sh ruei-check.sh
   ./ruei-install.sh collector
   

3. 前述のアクションの他に、ネットワーク・インタフェースを構成する必要があります。これについては、「ネットワーク・インタフェースの構成」で詳しく説明しています。さらに、レポータ・システムから新しく作成したコレクタ・システムに、パスワードなしのリモート・ログインを設定する必要もあります。必要な構成手順は、「レポータ通信の構成（分割サーバー設定のみ）」で説明しています。

レポータのインストール

この項では、レポータ・システムの必須コンポーネントをインストールする手順について説明します。これらにはApache Webサーバー、OracleデータベースのInstant ClientおよびZend Optimizerが含まれます。

Apache WebサーバーとPHPのインストール

この項では、Apache Webサーバーとそれを使用するコンポーネントのインストールと構成について説明します。

PHPの構成

1. 次のコマンドを発行して、再起動後にWebサーバーが自動的に起動することを確認します。

   /sbin/chkconfig httpd on
   

2. /etc/sysconfig/httpdファイルを編集して、次の行をファイルの最後に追加します。

   source /etc/ruei.conf
   

3. /etc/php.d/ruei.iniファイルで次の設定を作成します。

   session.gc_maxlifetime = 14400
   memory_limit = 96M
   upload_max_filesize = 128M
   post_max_size = 128M 
   

rsvg警告の回避

RUEIでは、グラフ生成にrsvgを使用します。欠落しているディレクトリについての警告を回避するために、次のコマンドを使用して、空の.gnome2ディレクトリを作成します。

mkdir -p /var/www/.gnome2

OracleデータベースのInstant Clientのインストール

rootユーザーとして次のコマンドを実行して、OracleデータベースのInstant ClientおよびSQLplus拡張機能をインストールします。

cd /root/RUEI/IC
rpm -Uhv oracle-instantclient11.2-basic-*.rpm
rpm -Uhv oracle-instantclient11.2-sqlplus-*.rpm

php-oci8モジュールのインストール

次のコマンドを使用して、php-oci8モジュール（RUEIディストリビューション・セットの一部）をインストールします。

cd /root/RUEI/PHP
rpm -Uhv php-oci8-11gR2-5*

Zend Optimizerのインストール

Zend Optimizerコードが格納されているディレクトリに移動し、tarファイルを解凍して、Zend Optimizerインストーラを実行します。使用許諾契約を確認します。使用許諾の条件に同意しなければ、先に進めません。デフォルトの設定をすべて使用し、インストーラがApache Webサーバーを再起動できるようにします。次のコマンドを発行します。

cd /root/RUEI/ZendOptimizer
tar zxvf ZendOptimizer-3.3.3-linux-glibc23-x86_64.tar.gz
cd ZendOptimizer-3.3.3-linux-glibc23-x86_64
./install

注意: （Yumを使用するなどして）システム・パッケージをアップグレードする場合、以前に/etc/php.iniファイルに加えた変更が上書きされる可能性があります。したがって、Zend Optimizerの再インストールの準備ができている必要があります。そうする場合は、Zend Optimizerインストーラでphp.iniファイルの場所が、/usr/local/Zend/etc/php.iniではなく、/etc/php.iniとなっていることを確認します。

追加情報

/etc/php.iniファイルで作成されたZend構成の行を、RUEI固有のPHP構成ファイル/etc/php.d/ruei.iniに移し、アップグレードの問題が起こらないようにすることをお薦めします。Zend Optimizerのデフォルトのインストールを実行した場合、これには次の行の移動が必要になります。

[Zend]
zend_extension_manager.optimizer=/usr/local/Zend/lib/Optimizer-3.3.3
zend_extension_manager.optimizer_ts=/usr/local/Zend/lib/Optimizer_TS-3.3.3
zend_optimizer.version=3.3.3

zend_extension=/usr/local/Zend/lib/ZendExtensionManager.so
zend_extension_ts=/usr/local/Zend/lib/ZendExtensionManager_TS.so

RUEIデータベース・インスタンスの作成

RUEIデータベースは、ローカル（つまり、レポータ・システム上）に置くことも、リモート・データベース・サーバーに置くこともできます。この項では、RUEIに必要なデータベース・インスタンスを作成し、レポータからこのデータベース・インスタンスに接続するために必要な接続データを生成します。

データベース・インスタンス（RUEI_DB_INST）が作成されるシステムに入るには、次のスクリプトが必要になります。

• ruei-prepare-db.sh: データベース・インスタンス、Oracleウォレットおよびデータベース接続ファイルを作成します。

• ruei-check.sh: これはハードウェアおよび環境のチェック・ユーティリティで、ruei-prepare-db.shによって自動的に起動されます。このスクリプトは、スタンドアロンのトラブルシューティング・ユーティリティとしても使用できます。 スクリプトの詳細は、付録A「ruei-check.shスクリプト」参照してください。

この項で説明する手順で作成される4つの接続データファイルは、次のとおりです。

• cwallet.sso

• ewallet.p12

• sqlnet.ora

• tnsnames.ora

RUEI構成ファイル（/etc/ruei.conf）も、データベース上に存在し、「RUEI構成ファイル」で説明されているように構成する必要があります。

次のようにします。

1. ruei-prepare-db.shおよびruei-check.shスクリプトを、データベース・インスタンスを実行するサーバーにコピーし、oracleユーザーのために実行可能にします。これらのスクリプトは、RUEIディストリビューションzipファイル（/root/RUEI/65）にあります。

2. 「RUEI構成ファイル」で説明されているように、/etc/ruei.confファイル内の設定を調べて、必要に合わせます。

3. データベース・サーバー上のoracleユーザーとしてデータベースにログオンし、ORACLE_HOME環境変数を設定します。oracleユーザーとして、ruei-prepare-db.shスクリプトを実行する必要があります。このスクリプトによりRUEI_DB_INSTデータベースが作成されますが、それはいくつかのハードウェアおよびソフトウェア環境チェックが実行された後です。実行される実際のチェックは、インストール中のシステム・タイプによって異なります。

   スクリプトによりRUEIデータベース・ユーザー・パスワードの入力を要求されます^脚注1 。この結果、RUEIアプリケーションでデータベースに自動的にログインできるようになります。このスクリプトにより、ここで自分用の接続データも作成されます。

   レポータとデータベース・サーバーの組合せのためにruei-prepare-db.shスクリプトを実行すると、すべてのファイルが自動的に正しい場所に置かれます^脚注2 。リモート・データベースの場合、別の.tarファイルが生成され、手順4の実行が必要になります。

   次のコマンドを発行します。

   chmod +x ruei-prepare-db.sh ruei-check.sh
   export ORACLE_HOME=/u01/app/oracle/product/11.1.0/db_1
   ./ruei-prepare-db.sh
   

   前述のコマンドをレポータとデータベース・サーバーの組合せで実行した場合、手順4を省略して、手順5に進んでかまいません。

4. この手順は、リモート・データベースを使用する場合にのみ当てはまります。

   リモート・データベースを使用するレポータの場合、手順3で生成された/tmp/ruei-database-configuration.tarファイルを、データベース・サーバーからレポータ・システムにコピーする必要があります。/tmp/ruei-database-configuration.tarファイルは、レポータ・サーバーの/var/opt/rueiディレクトリ（RUEI_DATA）で解凍する必要があります。ファイルの権限は、指定したRUEI_USER（moniforce）がそれらのファイルを使用できるように設定する必要があります。

   生成された.tarファイルをレポータ・システムにコピーします。このファイルには接続データ・ファイルが入っています。レポータ・サーバーにログオンし、次のコマンドを使用して.tarファイルを解凍します。

   cd /var/opt/ruei
   tar xvf path-to-tar-file/ruei/database-configuration.tar
   chown moniforce:moniforce cwallet.sso ewallet.p12 sqlnet.ora tnsnames.ora
   

5. データベースのロギングには大量のディスク領域が使用される可能性があるため、不要なディスク領域の使用を避けるために、クリーンアップ・スクリプトをインストールすることをお薦めします。スクリプト（例）をoracleユーザー・ディレクトリにコピーし、次のコマンドを使用して、cronによりアクティブ化します。

   mkdir -p /home/oracle/bin
   cp /root/RUEI/extra/ruei-clean.sh /home/oracle/bin
   chmod +x /home/oracle/bin/ruei-clean.sh
   su - oracle -c 'echo "10 0 * * * /home/oracle/bin/ruei-clean.sh" | crontab'
   

レポータ・ソフトウェアのインストール

1. RUEIディレクトリの場所は、どこでもかまいません。そのため、/etc/ruei.confファイルで構成されているとおりの正確なディレクトリ名を使用する必要があります。次のコマンドを使用して、RUEIアプリケーションのルート・ディレクトリを作成します。

   mkdir -p /opt/ruei
   chmod 750 /opt/ruei
   

   
   

   注意: 指定したRUEI_HOMEディレクトリおよびRUEI_DATAディレクトリには、それらのために定義された750の権限があります。

   
   

2. 次のコマンドを使用して、2つの追加グループのapacheおよびmoniforceメンバーを作成します。

   /usr/sbin/usermod -aG moniforce apache
   /usr/sbin/usermod -aG uucp apache
   /usr/sbin/usermod -aG uucp moniforce
   

3. RUEIソフトウェアがあるディレクトリに移動し、RUEIパッケージをインストールします。必要なインストールに応じて、reporterまたはcollectorをruei-install.shスクリプトに指定できます。

   cd /root/RUEI/65
   chmod +x ruei-install.sh
   ./ruei-install.sh reporter
   

4. 次のコマンドを使用して、Apache Webサーバーを再起動します。

   /sbin/service httpd restart
   

5. 次のコマンドを発行して、RUEIソフトウェアが正しくインストールされたことを確認します。

   ./ruei-check.sh postinstall
   

6. 次のコマンドを使用して、moniforceユーザーとしてRUEIadminユーザー・パスワードを設定し、RUEIインタフェースにログインできるようにします。

   su - moniforce
   set-admin-password
   

   パスワードの入力と確認を求められます。

   
   

   注意: adminユーザー・パスワードを定義する際は、次のことに留意してください。 パスワードは、8文字以上で、英数字以外の文字（$、@、&および!など）を少なくとも1文字含める必要があります。 最初のパスワードは、7日以内に変更する必要があります。 ユーザー名とパスワードは、大文字と小文字が区別されます。

   
   

ネットワーク・インタフェースの構成

この項は、レポータ・システムおよびコレクタ・システムにのみ関係があります。

監視ネットワーク・インタフェースのupステータスを、インタフェースの構成ファイルで取得インタフェースのONBOOTパラメータをyesに設定することで、（再起動後に）永続化します。ネットワーク・インタフェースの構成は、/etc/sysconfig/network-scripts/devices/ifcfg-ethX（Xは必要なネットワーク・インタフェースを表す）にあります。または、グラフィカル・ユーティリティsystem-config-networkを使用して、該当するインタフェースを「activate device when computer starts」に設定します。

マルチバイト・フォントの有効化（オプション、推奨）

この項は、レポータ・システムにのみ関係があります。

マルチバイト・キャラクタ・コンテンツを使用したPDFを生成するには、追加フォントを有効にする必要があります。これらのフォントはJavaで使用できるようにする必要があります。次のコマンドを使用して、RUEIでインストールされたフォントを、適切なJavaディレクトリにコピー（または移動）します。

cp /opt/ruei/gui/include/bi_publisher/fonts/* \
/usr/java/jre/lib/fonts/

メール（MTA）の構成（オプション、レポータのみ）

この項は、レポータ・システムにのみ関係があります。

RUEIでは、PDFレポートおよび電子メール・アラートの送信に、稼働しているローカルMTAの使用を想定しています。デフォルトでは、LinuxでSendmail MTAが使用されます。デフォルトでは、Sendmailにより電子メールが宛先のMTAに直接配信されます。この動作が必要性や方針に合致しない場合は、かわりの手段として、SmartHost （リレー）経由でメールを送信できます。SendmailでSmartHostを構成するには、次のようにします。

1. アップロードされたRPMがあるティレクトリに移動し、次のコマンドを発行して、Sendmail構成ユーティリティをインストールします。

   rpm -Uhv sendmail-cf-8.13.8-*.el5.x86_64.rpm
   

2. /etc/mail/sendmail.mcでSmart Host設定を含む行を検索します。SMART_HOST設定を必要に合せて変更します。次に例を示します。

   define('SMART_HOST', 'my.example')dnl
   

3. 次のコマンドを実行することにより、新しい構成を新しいsendmail.cfで生成します。

   make -C /etc/mail
   

4. Sendmailを再起動します。次に例を示します。

   /etc/init.d/sendmail restart 
   

注意: Sendmail MTAの構成の詳細は、http://www.sendmail.orgで入手できます。

SNMP（Reporterのみ）

RUEI MIB定義ファイルは、レポータ・インタフェースを介してダウンロードできます。この定義ファイルは、SNMPマネージャに追加できます。MIBファイルのダウンロードの手順は、『Oracle Real User Experience Insightユーザーズ・ガイド』で説明されています。

自動ブラウザ・リダイレクションの構成（オプション）

この項は、レポータ・システムにのみ関係があります。

ブラウザを正しいRUEIパスに自動的にリダイレクトするには、/var/www/html/index.htmlファイルを次の内容で作成します。

                   <head>
                   <meta http-equiv="REFRESH" content="0;URL=/ruei/">
                   </head>

レポータ通信の構成（分割サーバー設定のみ）

この項は、リモート・コレクタを使用するレポータ・システムにのみ関係があります。

パスワードなしのSSH接続は、レポータ・システムから各コレクタ・システムまで、Moniforceユーザー間で設定する必要があります。次のようにします。

1. レポータ・サーバーにrootとしてログオンします。次のコマンドを発行します。

   su - moniforcessh-keygen -P ""
   

   [Enter]を押して、デフォルトを使用します。

2. 各コレクタ・システムにrootとしてログオンし、次のコマンドを発行してmoniforceユーザーになります。

   su - moniforce
   

3. 次のコマンドを発行して、各コレクタ・システム上にmoniforceユーザー用の.sshディレクトリ（まだ存在していない場合）を作成します。

   mkdir ~/.ssh
   chmod 700 ~/.ssh
   

4. 次のコマンドを発行して、レポータ・システム上のSSHキーを、コレクタ・システム上の必要な場所にコピーします。

   cd ~/.ssh
   ssh root@Reporter cat /var/opt/ruei/.ssh/id_rsa.pub >> authorized_keys
   

   （レポータ・システムのrootパスワードを指定する必要があります。）

   chmod 600 authorized_keys
   

5. レポータ・システムで、パスワードを使用せずにリモート・コマンドを実行（moniforceユーザーとして）できるようになったことを確認します。次に例を示します。

   • rootとしてレポータ・サーバーにログオンします。

   • moniforceユーザー（su - moniforce）としてログオンします。

   • リモートのpwdコマンド（ssh Collector pwd）を実行します。

   • 「Are you sure you want to continue connecting (yes/no)?」という質問に対して「yes」と入力します。

   • コマンドから/var/opt/rueiが返されます。

6. これらの手順をコレクタごとに実行する必要があります。

   
   

   注意: レポータとコレクタ間の接続が正しく構成されていない場合、リモートのコレクタを登録しようとすると、認可エラーを受け取ります。

   
   

RUEIのインストール成功の確認

Initial setup wizard（「初期RUEI構成の実行」で説明）での作業が完了すると、「System」、「Status」を選択することで、インストールを検証できます。すべてのシステム・インジケータが「OK」になっているはずです。システム・アラートがまだ構成されていないため、「Status」の通知は「Unknown」と表示されます。これについては、『Oracle Real User Experience Insightユーザーズ・ガイド』で詳細に説明されています。

---

脚注の説明

脚注1: データベース・パスワードは、Oracleウォレット・パスワードとしても使用できます。どちらのパスワードも8〜30文字で、数字と文字の両方を含める必要があります。Oracleウォレット・パスワードの変更については、該当するOracleドキュメントを参照してください。
脚注2: rootパスワードがわからない場合、remote databaseオプションを選択し、手動で接続tarファイルを解凍できます。これについては手順4で説明されています。