Oracle Help for the Web開発者ガイド | ![]() 目次 |
![]() 前へ |
![]() 次へ |
TomcatはApache Software Foundation(http://jakarta.apache.org/
)のJakartaプロジェクトで開発されたJavaサーブレット・エンジンです。 Tomcatの最新バージョン、Tomcat 4.0では、サーブレットAPIのバージョン2.3をサポートします。この項では、Tomcatサーブレット・エンジンでOracle Help for the Web(OHW)ヘルプセットをデプロイする方法を説明します。
このページでは、次の項目について説明します。
TomcatにはOHWのダウンロード・ファイルが含まれていないので、取得してインストールする必要があります。Tomcatのインストールおよび構成方法の完全な説明は、Tomcatのドキュメントを参照してください。しかし、Tomcatのインストールは、通常きわめて簡単です。
Tomcatをダウンロードします。TomcatのバイナリはApache JakartaのWebサイト(http://jakarta.apache.org/tomcat/index.html
)から入手できます。ファイル名はjakarta-tomcat-nnn.zip(本稿執筆時)で、nnnはリリース番号です。
jakarta-tomcat-nnn.zipファイルを、ホスト・コンピュータのTomcatをインストールする場所に解凍します。デフォルトでは、jakarta-tomcat-nnn
の下にディレクトリ構造が作成されます。
注意: 以降このページでは、このディレクトリ名をjakarta-tomcat
とします。
JAVA_HOME環境変数をJDK 1.2以上がインストールされているホストのディレクトリに設定していることを確認してください。(Tomcat 4.0にはJDK 1.2以上が必須です。)
サーバーを起動するために、Tomcat起動バッチ・ファイルを実行するか、またはjakarta-tomcat/bin
ディレクトリから次のスクリプトを実行します。
startup
と入力します。./startup.sh
と入力します。UNIXのスクリプトに実行可能権限がない場合、UNIXのchmodコマンドを使用して、権限を付与する必要があります。
ブラウザにhttp://<hostname>:8080/
と入力します。ここで<hostname>
はTomcatがインストールされているマシンの名前です。
Tomcatの初期画面ページがブラウザに表示されます。ネットワークに接続した場合、これと同じURLに移動することで、リモート・コンピュータでもブラウザに同じコンテンツが表示されます。
TomcatがインストールされているコンピュータでTomcatを表示する場合、ブラウザの構成によってはhttp://localhost:8080/
というURLも使用できます。しかし、リモート・コンピュータでこれを表示する場合、コンテンツを表示するにはホスト名を使用する必要があります。
サーバーを停止するために、Tomcatのシャットダウン・バッチ・ファイルを実行するか、またはjakarta-tomcat/bin
ディレクトリから次のスクリプトを実行します。
shutdown
と入力します。./shutdown.sh
と入力します。次の手順に従う前に、「Apache Tomcatのインストールおよび実行」で前述したとおり、Apache Tomcatをインストールする必要があります。
OHWデプロイ・バンドルをOracle Technology Network(http://otn.oracle.com/tech/java/help/content.html
)からダウンロードします。デプロイ・バンドルのファイル名はohw-deploy-nnn.zipで、nnnはOHWのリリース番号です。このファイルには、多数のJava ARchive(JAR)依存性ファイル、web.xmlファイルおよびohwconfig.xmlファイル、2つのZIPファイルすなわちohw-install.zipおよびuix2-install.zipが含まれています。
ohw-deploy-nnn.zipを一時的な場所に解凍します。
Tomcatインストールのjakarta-tomcat/webapps/
ディレクトリの下に、次の新規サブディレクトリを作成します。
jakarta-tomcat/webapps/ohw
jakarta-tomcat/webapps/ohw/helpsets
jakarta-tomcat/webapps/ohw/WEB-INF
注意: WEB-INFは必ずすべて大文字です。ohwはすべて小文字です。
OHWサーブレットをインストールするために、ohw-deploy-nnn.zipを解凍して取得したすべてのJARファイルをjakarta-tomcat/lib
ディレクトリに配置します。ファイルは次のとおりです。
ohw-install.zip
をjakarta-tomcat/webapps/ohw
ディレクトリに解凍します。これによりjsLibs
というサブディレクトリが作成され、OHWのJavaScriptファイルが、たとえば次のようなディレクトリに格納されます。
jakarta-tomcat/webapps/ohw/jsLibs/<files>
uix2-install.zipをjakarta-tomcat/webapps/ohw
ディレクトリに解凍します。これによりcabo
ディレクトリ構造が作成され、画像、スクリプトおよびスタイルシートなどの、インストール可能なUIXリソース・ファイルが次のサブディレクトリに格納されます。
jakarta-tomcat/webapps/ohw/cabo/images/<files>
jakarta-tomcat/webapps/ohw/cabo/jsLibs/<files>
jakarta-tomcat/webapps/ohw/cabo/jsps/<files>
jakarta-tomcat/webapps/ohw/cabo/styles/<files>
注意: インストール可能なUIXリソース・ファイルを複数のWebモジュールで共有するための設定方法は、「共有するインストール可能なUIXリソース・ファイルの設定」を参照してください。
OHWヘルプ・システムを構成するファイルをjakarta-tomcat/webapps/ohw/helpsets
に配置するか、またはohw/helpsets
の下にサブディレクトリを作成してその中に配置します。たとえば、myProductおよびotherProductという2つの製品がある場合、次が作成できます。
jakarta-tomcat/webapps/ohw/helpsets/myProduct
jakarta-tomcat/webapps/ohw/helpsets/otherProduct
ヘルプセット・ファイル、トピック(HTML)ファイルおよびその他の制御ファイル(索引、目次など)を含むすべてのヘルプ・ファイルを、このディレクトリに配置します。これらのファイルの詳細は、「ファイルについて」を参照してください。ヘルプセットにJARファイルを使用している場合は、JARファイルもここに配置します。(JAR形式および非JAR形式のヘルプセットを、同じデプロイで使用できます。)
ohwconfig.xmlファイルを作成し、OHWを構成します。このファイルをjakarta-tomcat/webapps/ohw/helpsets/
ディレクトリに配置します。ohw-deploy-nnn.zipファイルにはサンプル・ファイルが含まれています。
特にこのファイルは、OHWで使用するヘルプセットおよびヘルプ・トピックHTMLファイルが格納されている場所を定義します。<books>
要素には、任意の数のヘルプセットまたはHelpBook、または両方の組合せを含めることができます。ヘルプセットは実行時にマージされるので、複数の作成者が複数のヘルプセットを作成した場合でも、それらをシームレスにマージできます。マージの動作はcombineBooks
属性およびuseLabelInfo
属性によって指定されます。<helpSet>
要素には、0個以上の<contentLocation>
要素を含めることができます。<contentLocation>
要素は、Oracle Helpで使用する一連のヘルプ・トピックHTMLファイルのルート位置を指定するために使用されます。ohwconfig.xmlファイルの詳細は、「OHW構成ファイル」を参照してください。
編集の例:
<books combineBooks="false" useLabelInfo="true">
<helpSet location="myProduct/myProduct.hs" />
<helpSet jar="otherProduct/otherProduct.jar" location="otherProduct.hs" />
</books>
web.xmlファイルをjakarta-tomcat/webapps/ohw/WEB-INF
ディレクトリに作成します。ohw-deploy-nnn.zipファイルにはサンプルweb.xmlファイルが含まれています。Tomcatとともに使用する前に、このファイルを編集する必要があります。web.xmlをテキスト・エディタで開き、次の3行を削除します。
<login-config>
<auth-method>BASIC</auth-method>
</login-config>
最終的なweb.xmlは次のサンプルXMLファイルに近似しているはずです。このweb.xmlはohwconfig.xmlファイルがjakarta-tomcat/webapps/ohw/helpsets/
ディレクトリにあるかぎり使用できます。
web.xmlファイルの例:
<?xml version="1.0"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_3.dtd">
<web-app>
<servlet>
<servlet-name>OHW</servlet-name>
<servlet-class>oracle.help.OHW</servlet-class>
<init-param>
<param-name>configFileName</param-name>
<param-value>/helpsets/ohwconfig.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>OHW</servlet-name>
<url-pattern>/help/*</url-pattern>
</servlet-mapping>
</web-app>
<servlet-mapping>
パラメータの<url-pattern>
は、OHWへのアクセスに使用されるURLを指定します。たとえば、<url-pattern>
をデフォルトの/help/*
から/onlinereference/*
に変更した場合、OHWへのアクセスに使用されるURLはhttp://<hostname>:8080/ohw/onlinereference/
になります。
次のパラメータは、OHW構成ファイル(ohwconfig.xml)の場所を指定します。
<init-param>
<param-name>configFileName</param-name>
<param-value>/helpsets/ohwconfig.xml</param-value>
</init-param>
構成ファイルのパスはサーブレットのコンテキスト・パスの相対位置に指定されます。ほとんどのユーザーは、このパラメータを変更しないことをお薦めします。
次の手順に従って、ヘルプをOHWで表示します。
前述の「Apache Tomcatのインストールおよび実行」のステップ4で説明されているように、startup.bat
またはstartup.sh
を実行してTomcatを起動します。
ブラウザにhttp://<hostname>:8080/ohw/help/
と入力します。
注意: 最後のスラッシュ(/)は必須です。
TomcatがインストールされているコンピュータでTomcatを表示する場合、ブラウザの構成によってはhttp://localhost:8080/ohw/help/
というURLも使用できます。
ページが予定したように表示されない場合、Tomcatによるエラー・メッセージのログがないかどうか、コンソール・ウィンドウをチェックしてください。 Tomcatは、jakarta-tomcat/logs
の下のログ・ファイルにもエラー・メッセージを記録します。
複数のアプリケーションでインストール可能なUIXリソース・ファイルの1つのセットを共有するには、UIXリソース・ファイルをTomcatインストールのwebapps/ROOT
ディレクトリにインストールします。
uix2-install.zipをjakarta-tomcat/webapps/ROOT
ディレクトリに解凍します。これによりcabo
サブディレクトリが作成され、画像、スクリプトおよびスタイルシートなどの、インストール可能なUIXリソース・ファイルがサブディレクトリに格納されます。
jakarta-tomcat/webapps/ROOT/cabo/WEB-INF
ディレクトリを作成し、次のコンテンツをweb.xmlファイルにコピーします。
UIXリソース・ファイルに使用されるweb.xmlファイルの例:
<?xml version="1.0"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_3.dtd">
<web-app>
</web-app>
web.xmlファイルは基本的に空ですが、UIXのWebモジュールをデプロイするために必要です。
Tomcat Catalinaバッチ・ファイルを変更するか、システム・プロパティのoracle.cabo.ui.sharedContextPathを介してインストール可能なUIXリソース・ファイルの場所が指定されるように、jakarta-tomcat/bin
ディレクトリのスクリプトを変更します。
編集の例:
%_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS% -
Doracle.cabo.ui.sharedContextPath=\jakarta-tomcat\webapps\ROOT -
Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -
Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -
Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS% %ACTION%
Webアプリケーション(たとえばjakarta-tomcat/webapps/ohw/cabo
)にある、インストール可能なUIXリソース・ファイルのプライベート・コピーをすべて削除します。
OHW/Tomcatインストールをアップグレードする前に、最新のダウンロードとインストール方法を、OHWのダウンロード・ページでチェックしてください。
注意: アップグレードの前にTomcat/OHWインスタンスを停止してください。OHWおよびUIXをアップグレードした後Tomcat/OHWを再起動してください。
OHWをアップグレードするには、OHWおよびUIXのJARファイル、およびOHWのJavaScriptファイル(ohw-install.zipとして配布)を置き換える必要があります。次の手順に従って、OHWを新しいリリースにアップグレードしてください。
前述の「OHWのインストールおよびTomcatの構成」のステップ4を繰り返します。これによりOHWおよびUIXのJARファイルが更新されます。
jakarta-tomcat/webapps/ohw/jsLibs
ディレクトリにあるOHWのJavaScriptファイルが更新されます。UIXをアップグレードするには、インストール可能なUIXリソース・ファイル(uix2-install.zipとして配布)を置き換える必要があります。インストール可能なUIXリソース・ファイルを新しいリリースにアップグレードするには、次の1つを行います。
共有するインストール可能なUIXリソース・ファイルがTomcatサーバー・インストールによって使用されている場合、前述の「共有するインストール可能なUIXリソース・ファイルの設定」のステップ1を繰り返します。これにより、uix2-install.zipからjakarta-tomcat/webapps/ROOT
ディレクトリにファイルが解凍され、cabo
ディレクトリおよびそのサブディレクトリがアップグレードされます。
注意: ランタイム・キャッシュ・ディレクトリのjakarta-tomcat/webapps/ohw/cabo
を削除することを忘れないでください。
インストール可能なUIXリソース・ファイルのプライベート・コピーが各Webアプリケーションにある場合、前述の「OHWのインストールおよびTomcatの構成」のステップ6を繰り返してください。これにより、uix2-install.zipからjakarta-tomcat/webapps/ohw
ディレクトリにファイルが解凍され、cabo
ディレクトリおよびそのサブディレクトリがアップグレードされます。
Copyright © 1996, 2004, Oracle. All rights reserved.