12 エンドユーザー・ドキュメンテーション・ポータルのインストール

エンドユーザー・ドキュメンテーション・ポータルはカスタマイズ可能な一連のHypertext Markup Language（HTML）ページで、Oracle Collaboration Suiteクライアントの概要と、各Oracle Collaboration Suiteクライアントをダウンロード、インストールおよび構成するための情報を提供します。エンドユーザー・ドキュメンテーション・ポータルには、Oracle Technology Network（OTN）のFrequently Asked Questions（FAQ）とトラブルシューティング・サイト、およびOracle Collaboration Suiteのエンド・ユーザー用チュートリアルへのリンクも含まれています。

エンド・ユーザーにOracle Collaboration Suiteクライアントの実行に必要なすべての情報を提供するためにエンドユーザー・ドキュメンテーション・ポータルをインストールおよび使用することをお薦めします。

この章の内容は次のとおりです。

12.1項「エンドユーザー・ドキュメンテーション・ポータルのインストール」
12.2項「エンドユーザー・ドキュメンテーション・ポータル・パッケージのデプロイ」
12.3項「エンドユーザー・ドキュメンテーション・ポータル管理パネルへのアクセスの制限」
12.4項「エンドユーザー・ドキュメンテーション・ポータル管理パネルのApache認証による保護」

12.1 エンドユーザー・ドキュメンテーション・ポータルのインストール

この項では、エンドユーザー・ドキュメンテーション・ポータルのインストール・プロセスについて説明します。エンドユーザー・ドキュメンテーション・ポータルのインストールには、次の手順が必要です。

12.1.1項「PHPのテスト」
12.1.2項「インストール前のタスクの実行」
12.1.3項「DOM XML拡張機能のインストール」

12.1.1 PHPのテスト

PHPはHTML埋込みスクリプト言語です。エンドユーザー・ドキュメンテーション・ポータルにはPHPバージョン4.3.x以上が必要ですが、PHP 5.0以上では機能しません。これはOracle Collaboration Suiteとともにインストールされ、コンパイル済です。PHPをテストする手順は、次のとおりです。

http://localhostにナビゲートし、URLが示すマシン上のディレクトリ名を探します。デフォルトでは、ディレクトリはhtdocsです。このディレクトリに、次のテスト・スクリプトで構成されるinfo.phpという新しいファイルを作成します。
```
<?php
  phpinfo();
?>
```
http://localhost/info.phpにナビゲートしてテスト・スクリプトが機能するかを確認します。etstスクリプトが成功するとPHPページが表示されます。このページの一部を図12-1に示します。

図12-1 デフォルトのPHPページ

「図12-1 デフォルトのPHPページ」の説明

図12-1で示した表の後に、その他の多くの表が続きます。これらの表には、PHPインストールでインストールされた拡張機能が説明されています。

12.1.2 インストール前のタスクの実行

DOM XML拡張機能をインストールする前に、次のタスクを実行する必要があります。

gccおよびzlibパッケージが適切にインストールされていることを確認します。
また、gettextパッケージが適切にインストールされていることも確認します。
次の環境変数が正しい場所に設定されていることを確認します。
- ORACLE_HOME
- PERL5LIB
  
  この環境変数は、$ORACLE_HOME/perl/lib/5.6.1に設定する必要があります。
- SHLIB_PATH

12.1.3 DOM XML拡張機能のインストール

DOM XML拡張機能は、PHP拡張機能の1つです。これはコンパイル・ライブラリです。

DOM XML拡張機能をインストールする手順は、次のとおりです。

libxmlバージョン2.4.14以上がシステムにインストールされていることを確認します。libxmlがない場合、GNOME XMLライブラリをダウンロードします。libxmlをインストールするには、システム上でソースから次の手順を実行します。
1. 次のコマンドを使用してlibxmlソースを解凍します。
```
gunzip libxml2-2.4.x.x.tar.gz
```
  libxml2-2.4.x.x.tarが作成されます。
2. 次のコマンドを使用してファイルを解凍します。
```
tar -xvf libxml2-2.4.x.x.tar
```
3. 抽出されたディレクトリに対して次のコマンドを実行し、必要なMakeファイルを作成します。
```
./configure
```
4. 次のコマンドを実行して、libxmlライブラリを作成し、ファイルを適切な場所に配置します。
```
make
make install
```
http://www.php.net/downloads.phpからphp-4.3.9.tar.gzをダウンロードします。

任意の場所に配置します。
次のコマンドを使用してphp-4.3.9.tar.gzを解凍します。
```
gunzip php-4.3.9.tar.gz
```
php-4.3.9.tarが作成されます。
tar -xvf php-4.3.9.tarを使用して解凍します。
php-4.3.9ディレクトリに移動します。PHPに対してconfigureスクリプトを実行します。

このスクリプトを実行するときは、オプション--with-dom[=DIR]（DIRはlibxmlのインストール・ディレクトリ）を追加する必要があります。たとえば、libxmlが/usr/local/lib/ディレクトリにインストールされている場合、次のconfigureスクリプトをコールする必要があります。
```
./configure --with-apxs=$ORACLE_HOME/Apache/Apache/bin/apxs --prefix=$ORACLE_HOME 
--with-config-file-path=$ORACLE_HOME/Apache/Apache/conf  --with-zlib-dir=/usr/lib --with-dom=/usr/local/lib/
```
次のコマンドを実行して、PHP実行可能ファイルを作成し、適切な場所に配置します。
```
make
make install
```
すべてのファイルを適切な場所に配置したら、PHPモジュールをロードして.php、.phtmlおよび.phps接尾辞に対するリクエストにサービスを提供するようにApacheを構成する必要があります。
1. $ORACLE_HOME/Apache/Apache/confに移動します。
2. httpd.confファイルを次のように編集します。
```
...
# Dynamic Shared Object (DSO) Support. . .
LoadModule . . .
...
LoadModule php4_module libexec/libphp4.so
...
# Document types.
. . .
# And for PHP 4.x, use:
. . .
AddType application/x-httpd-php .php .phtml
AddType application/x-httpd-php-source .phps.
```
Apacheを再起動して、変更内容を有効にします。
$ORACLE_HOME/Apache/Apache/binに移動します。次のコマンドを実行します。
```
./apachectl restart
```
http://localhost/info.phpにナビゲートしてdomxml表を検索し、拡張機能がインストールされているかどうかを確認します。domxml表があれば、DOM XML拡張機能はインストールされています。

12.2 エンドユーザー・ドキュメンテーション・ポータル・パッケージのデプロイ

エンドユーザー・ドキュメンテーション・ポータル・パッケージを解凍してデプロイする手順は、次のとおりです。

DVD/Doc/EUDPディレクトリからeudp.zipの中身をhtdocsディレクトリ、またはhttp://localhost/が示すディレクトリに解凍します。
ブラウザ・ウィンドウで、http://localhost/eudp/admin/view.phpにナビゲートし、エンドユーザー・ドキュメンテーション・ポータル管理ツールが機能しているかをテストします。

エンドユーザー・ドキュメンテーション・ポータル管理ツールの使用方法および内容のカスタマイズ方法は、『Oracle Collaboration Suite管理者ガイド』の第5章を参照してください。

12.3 エンドユーザー・ドキュメンテーション・ポータル管理パネルへのアクセスの制限

管理者以外のユーザーにエンドユーザー・ドキュメンテーション・ポータル管理パネルにアクセスさせないようにするには、Apacheサーバーのhtpasswdユーティリティを使用してeudp/adminディレクトリを保護します。このディレクトリを保護した後、ユーザーにはview.phpにアクセスを試みるとユーザー名とパスワードを要求するダイアログが表示されます。ディレクトリへのアクセスの制限の詳細は、Apacheサーバーのドキュメントを参照してください。

12.4 エンドユーザー・ドキュメンテーション・ポータル管理パネルのApache認証による保護

次に、eudpのadminディレクトリをApacheの基本認証で保護する方法を示します。

ユーザーがadminディレクトリ（特にview.phpファイル）にアクセスしようとすると、ユーザーはユーザー名とパスワードを要求されます。

エンドユーザー・ドキュメンテーション・ポータルのローカル・インストールの手順は、次のとおりです。

注意:

リモートで次の手順を実行することはできません。

eudp/adminディレクトリに次のディレクティブを含む.htaccessというファイルを作成します。
```
AuthType Basic
AuthName "End-User Documentation Portal Administration Panel"
AuthUserFile "/apache_directory/htdocs/eudp/.htpassword"
AuthGroupFile /dev/null
require user administrator
```
/apache_directoryはApacheサーバーをインストールした場所で、administratorはエンドユーザー・ドキュメンテーション・ポータルの管理者のユーザー名です。
.htpasswordというAuthUserFileを作成します。このファイルはhtaccessで指定したのと同じディレクトリに作成する必要があります。htpasswdユーティリティを次のように実行します。
```
/apache_directory/bin/htpasswd -c \
/apache_directory/htdocs/eudp/.htpassword administrator
```
htpasswdコマンドでパスワードを要求されます。
htaccessファイルにあるディレクティブを有効にします。Apacheのhttpd.confファイルで<Directory>タグを探し、AllowOverrideディレクティブをNoneのかわりにAuthConfigオプションに変更します。
```
<Directory "/apache_directory/htdocs">
#........Other directives................
AllowOverride AuthConfig
</Directory>
```
httpd.confファイルに対する変更を保存します。
Apacheサーバーを再起動します。