ヘルプをデプロイするサーバーに製品をインストールしなかった場合は、Apache Tomcat アプリケーション・サーバーにヘルプをデプロイできます。
始める前に
- ヘルプ・コンテンツを構成するサーバーは、ファイアウォールの背後のユーザーが使用可能でなければなりません。
- help.war ファイルが、ご使用のサーバー上になければなりません。
- Apache Tomcat をインストールして構成します。
- Java™ ランタイム環境 (JRE) または Java Developer Kit をインストールします。いずれかの IBM® Developer Kit をインストールできます。
- JRE または Java Developer Kit へのパスが指定された環境変数を設定します。
- JRE をインストールした場合は、JRE_HOME 環境変数を作成し、その値に JRE をインストールしたディレクトリーへのパスを設定します。以下に例を示します。
- Windows: C:¥Program
Files¥Java70¥jre
- Linux: /usr/local/java70/jre
- Java Developer Kit をインストールした場合は、JAVA_HOME 環境変数を作成し、その値に Java Developer Kit をインストールしたディレクトリーへのパスを設定します。以下に例を示します。
- Windows: C:¥Program
Files¥Java70
- Linux: /usr/local/java70/
- Apache Tomcat サーバー・アプリケーションをダウンロードします。
- 圧縮された Apache Tomcat アーカイブ・ファイルを解凍します。
- 解凍したフォルダーを永久的な場所に移動します。この場所は、CATALINA_HOME と呼ばれます。例えば、C:¥apache-tomcat-version です。
- CATALINA_HOME 環境変数を作成し、その値に CATALINA_HOME ディレクトリーを設定します。例えば、C:¥apache-tomcat-version となります。
- CATALINA_HOME/conf/tomcat-users.xml ファイルに、サーバー管理者ユーザーを追加して、変更を保存します。例えば、次のようになります。
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- CATALINA_HOME/bin ディレクトリーを開き、スタートアップ・ファイルを実行して、Apache Tomcat サーバーを開始します。このファイルの名前は、ご使用のオペレーティング・システムに応じて異なります。
- Windows: startup.bat
- Linux: startup.sh
コマンド・ライン・ユーティリティーの情報メッセージに、Server Startup in number ms と示されていれば、Apache Tomcat は稼働しています。
手順
help.war ファイルをデプロイするには、以下のようにします。
- ブラウザーで http://localhost:8080/manager/html という URL を入力して、Tomcat Manager アプリケーションを開きます。
- ユーザー名とパスワードを入力します。
- セクションで「ファイルの選択 (Choose file)」をクリックします。
- help.war ファイルを選択します。
- 「デプロイ」をクリックします。 help.war ファイルがデプロイされ、開始され、「アプリケーション (Applications)」セクションに表示されます。
help.war ファイルは、CATALINA_HOME/webapps ディレクトリーにもコピーされます。
- help/index.jsp をご使用のサーバー・アプリケーション URL の末尾に追加して、ヘルプ・システムにアクセスできることを確認します。help は .war ファイルの名前です。
例えば、http://localhost:8080/help/index.jsp のようになります。
注: - ヘルプ・システムにヘルプ・コンテンツがまだ含まれていない場合もあります。その場合は、次にヘルプ・システムに資料をインストールする必要があります。
- 製品と同じ Apache Tomcat サーバーにヘルプ・システムをデプロイした場合は、製品アプリケーションの開始/停止時にヘルプ・システムも開始/停止します。
次のタスク
- 以下のいずれかの作業を完了して、ヘルプ・コンテンツをサーバーにインストールします。
- 組織内のチーム・メンバーにインフォメーション・センターの URL を教えます。ヘルプ・コンテンツに関する選択項目の変更で説明しているとおり、チーム・メンバーは、Rational® DOORS® クライアントのヘルプ設定でイントラネット・サーバーの URL を入力して、そのサーバー上のヘルプにアクセスするように変更することができます。教えた URL に、サーバー名として localhost が含まれていないことを確認してください (例: http://server.ibm.com:8080/help/index.jsp)。