ヘルプをデプロイするサーバーに製品をインストールしていない場合は、ヘルプ・システムをデプロイするための単純なアプリケーション・サーバー・ソリューションとして Apache Tomcat を使用できます。
始める前に
- ヘルプ・コンテンツを構成するサーバーを、ファイアウォールの背後にいるユーザーから利用できるようにする必要があります。
- ご使用のサーバーで help.war ファイルが使用可能になっていることを確認します。
- ヘルプを構成する製品をサーバーにインストール済みの場合、help.war ファイルは既にインストールされている可能性があります。
- installation_directory/help ディレクトリーを調べて、help.war ファイルがないかどうかを確認します。
- 製品の省略語を含むファイル (clmhelp.war や ramhelp.war など) を探します。
- インストール・ディレクトリーで *help.war を検索します。
- 製品をサーバーにインストールしていない場合、または製品に help.war ファイルが組み込まれていない場合は、help.war ファイルをダウンロードします。
- Apache Tomcat をインストールおよび構成します。
- Java™ ランタイム環境 (JRE) または Java Development Kit (JDK) をインストールします。
IBM® Developer Kit のいずれかをインストールすることを選択できます。
- JRE または JDK へのパスによって環境変数を設定します。
- JRE をインストールした場合は、JRE_HOME 環境変数を作成し、その値に JRE をインストールしたディレクトリーへのパスを設定します。
以下に例を示します。
- Windows: C:¥Program Files¥Java70¥jre
- Linux: /usr/local/java70/jre
- JDK をインストールした場合は、JAVA_HOME 環境変数を作成し、その値を JDK がインストールされているディレクトリーへのパスに設定します。
以下に例を示します。
- 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 をデプロイするには、以下のようにします。
- ブラウザーで URL http://localhost:8080/manager/html を入力して、Tomcat Manager Application を開きます。
- ユーザー名およびパスワードを入力します。
- セクションで、「ファイルの選択 (Choose file)」をクリックします。
- help.war ファイルを選択します。
- 「デプロイ (Deploy)」をクリックします。 help.war ファイルが「アプリケーション」セクションでデプロイ、開始、および表示されます。
help.war ファイルは CATALINA_HOME/webapps ディレクトリーにもコピーされます。
- help/index.jsp をご使用のサーバー・アプリケーション URL の末尾に追加して 、ヘルプ・システムにアクセスできることを確認します。
help は .war ファイルの名前です。
例: http://localhost:8080/help/index.jsp
注: - ヘルプ・システムにはまだヘルプ・コンテンツが含まれていないことがあります。
次に文書をヘルプ・システムにインストールすることが必要になる場合があります。
- ヘルプ・システムが製品と同じ Apache Tomcat サーバーにデプロイされている場合は、製品アプリケーションの開始時または停止時に、ヘルプ・システムも開始または停止されます。
次のタスク
- 文書をサーバーにインストールするには、以下のようにします。
- IBM Installation Manager の「ヘルプ・システム構成 (Help System Configuration)」ページにアクセスするための、サーバー、ポート、およびヘルプ・システムへのパスをユーザーに提供します。
指定するサーバーが localhost ではないことを確認してください。
例:
http://server.ibm.com:8080/help/index.jsp の場合、値は以下のとおりです。
- サーバー: server.ibm.com
- ポート: 8080
- パス: /help