Derby を使用する Apache Tomcat サーバー上で Rational® Publishing Engine Web アプリケーション
(rpeng.war および dgaas.war) をデプロイできます。
始める前に
Web アプリケーションをデプロイする前に、Apache Tomcat V7.0.x または V8.0.x と、RPE リモート・サービス・フィーチャーを備えた
Rational Publishing Engine をインストールする必要があります。
RPE_HOME¥remote-services ディレクトリーにある以下の Web アプリケーションにアクセスできる必要があります。
手順
- Apache Tomcat アプリケーション・サーバーを準備します。
- Tomcat アプリケーション・サーバーで、TELELOGIC_LICENSE_FILE システム変数を port_number@hostname
(例えば 19353@licserver1) に設定します。
詳しくは、『TELELOGIC_LICENSE_FILE 環境変数の検証』トピックを参照してください。
- 最大ファイル・サイズと要求サイズを増やします。
Tomcat 7 の場合:
- Tomcat Manager アプリケーションの web.xml ファイルを開きます。
例えば、TomcatInstallDir/webapps/manager/WEB-INF/web.xml です。
- 次のセクションを見つけます。
<multipart-config>
<!-- 50 MB max -->
<max-file-size>52428800</max-file-size>
<max-request-size>52428800</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
- このセクションを編集して容量を増やします。
<multipart-config>
<!-- 70 MB max -->
<max-file-size>73400320</max-file-size>
<max-request-size>73400320</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
- web.xml ファイルを保存して閉じます。
Tomcat 8 の場合:
- Apache Tomcat アプリケーション・サーバーを停止します。
- TOMCAT_HOME¥webapps ディレクトリーから dgaas ディレクトリーと dgaas.war を削除します (これらが既に存在する場合)。
- dgaas.war ファイルを TOMCAT_HOME¥webapps ディレクトリーにコピーします。
- 次のようにして、Apache Tomcat アプリケーション・サーバーを始動します。

- Apache Tomcat を Windows サービスとして実行している場合に、サーバーを始動するには、TomcatInstallDir/bin ディレクトリーから次のコマンドを実行します (Apache Tomcat V7.0.x では、Tomcat7.exe に置き換えてください)。
Tomcat8.exe start
サーバーを停止するには、
TomcatInstallDir/bin ディレクトリーから次のコマンドを実行します (Apache Tomcat V7.0.x では、
Tomcat7.exe に置き換えてください)。
Tomcat8.exe stop
- Apache Tomcat を Windows サービスとして実行していない場合に、サーバーを始動するには、TomcatInstallDir/bin ディレクトリーから次のコマンドを実行します 。
startup.bat
ヒント: 別の Apache Tomcat コンソール・ウィンドウが開きます。このウィンドウを閉じないでください。閉じると、サーバーの動作が停止します。Tomcat サーバーが始動するまでしばらくお待ちください。サーバーの始動後に、Tomcat ウィンドウに起動時間がミリ秒単位で表示されます。
例えば、「25731 ミリ秒でサーバーが始動 (Server startup in 25731 ms)」と示されます。
サーバーを停止するには、
TomcatInstallDir/bin ディレクトリーから次のコマンドを実行します。
shutdown.bat

- サーバーを始動するには、TomcatInstallDir/bin から次のコマンドを実行します。
startup.sh
サーバーを停止するには、
TomcatInstallDir/bin ディレクトリーから次のコマンドを実行します。
shutdown.sh
- Web アプリケーションをデプロイするためのオプションとして、以下のいずれかを選択します。
- グラフィカル・ユーザー・インターフェースを使用して Web アプリケーションをデプロイする場合は、次のステップに進み、Apache Tomcat Manager インターフェースを使用したデプロイを詳細に行ってください。
- ファイル・システムを使用して Web アプリケーションをデプロイする場合は、rpeng.war ファイルと dgaas.war ファイルを
RPE_HOME¥remote-services ディレクトリーから Tomcat の webapps ディレクトリー
(例: Tomcat_InstallDir¥webapps) にコピーします。
その後、このトピックの『タスクの結果』および『次のタスク』セクションに進んでください。
- Apache Tomcat Manager (http://server:port/manager/html) をブラウザーで開いてください。
例:
http://localhost:8080/manager/htmlヒント: Tomcat Manager アプリケーションを認証するためのユーザー名とパスワードの入力を求めるウィンドウが開きます。
manager-gui 役割を
Tomcat_install_dir/conf/tomcat-user.xml ファイルに追加する必要があります。
Tomcat_install_dir は Apache Tomcat のインストール・ディレクトリーです。次の例は、ユーザー名として
my_username、およびパスワードとして
my_password を持つ
manager-gui 役割を追加します。
<user username="my_username" password="my_password" roles="manager-gui"/>
- Apache Tomcat 上で rpeng.war アプリケーションと dgaas.war アプリケーションの両方をデプロイします。
- 「デプロイ (Deploy)」セクションで、rpeng.war ファイルの詳細を入力して、「デプロイ (Deploy)」をクリックします。
- WAR ファイルが Apache Tomcat とは別のサーバーにある場合は、「サーバー上にあるディレクトリーまたは WAR ファイルをデプロイ (Deploy directory or WAR file located on server)」セクションで、以下の情報を入力します。
- コンテキスト・パス (Context Path): Rational Publishing Engine Web アプリケーションの名前として /rpeng と入力します。この入力は、クライアントの構成に使用する URL の一部になります。
- XML 構成ファイル URL (XML Configuration file URL): 必要ありません。
- WAR またはディレクトリーの URL (WAR or Directory URL): rpeng.war ファイルのパス。
例: RPE_HOME¥remote-services¥rpeng.war
- .war ファイルが Apache Tomcat と同じサーバー上にある場合は、「デプロイする WAR ファイル (WAR file to deploy)」セクションで、以下の情報を入力します。
- アップロードする WAR の選択 (Select WAR to upload): rpeng.war ファイルのパス。
例: RPE_HOME¥remote-services¥rpeng.war
- 「デプロイ (Deploy)」セクションで、dgaas.war ファイルの詳細を入力して、「デプロイ (Deploy)」をクリックします。
- .war ファイルが Apache Tomcat とは別のサーバーにある場合は、「サーバー上にあるディレクトリーまたは WAR ファイルをデプロイ (Deploy directory or WAR file located on server)」セクションで、以下の情報を入力します。
- コンテキスト・パス (Context Path): Rational Publishing Engine Web アプリケーションの名前として /dgaas と入力します。この入力は、クライアントの構成に使用する URL の一部になります。
- XML 構成ファイル URL (XML Configuration file URL): 必要ありません。
- WAR またはディレクトリーの URL (WAR or Directory URL): dgaas.war ファイルのパス。
例: RPE_HOME¥remote-services¥dgaas.war
- .war ファイルが Apache Tomcat と同じサーバー上にある場合は、「デプロイする WAR ファイル (WAR file to deploy)」セクションで、以下の情報を入力します。
- アップロードする WAR の選択 (Select WAR to upload): dgaas.war へのパス。
例: RPE_HOME¥remote-services¥dgaas.war
タスクの結果
Rational Publishing Engine Web アプリケーションの最初のページ
(http://server:port/rpeng/) をブラウザーで開くことによって、Web アプリケーションがデプロイされていることを確認できます。
重要: デフォルトで、rpeng.war アプリケーションは、dgaas.war アプリケーションを同じサーバーの /dgaas
コンテキスト・パスの下で探します。
dgaas.war アプリケーションを異なるサーバーまたは異なるコンテキスト・パスにデプロイする場合は、DGAAS_URL ランタイム環境変数を
rpeng.war アプリケーション内で構成する必要があります。
DGAAS_URL ランタイム環境変数を構成するには、以下の手順を実行します。
- 管理者 (rpe_admin) アクセス権限を持つユーザーで、Web アプリケーション (http://server:port/rpeng/) にログオンする必要があります。
rpe_admin ユーザー役割を持つユーザーの構成方法について詳しくは、『Apache Tomcat での Web アプリケーションのユーザーの構成』トピックを参照してください。
- Web アプリケーションのユーザー・ツールバーで、「管理者」を選択します。
この「管理者」メニュー・オプションは、rpe_admin 役割を持つユーザーが選択できます。
- 「ランタイム変数」を選択します。
- DGAAS_URL ランタイム環境変数の値を URL に設定します (例: http://server:port/dgaas)。
次のタスク
文書を生成するために文書生成サービス・テクノロジーを使用し、文書生成サービスのアセットと文書の保管インターフェースを提供する
Newskeeper サンプル・アプリケーションを、必要に応じてデプロイして実行することができます。
詳しくは、『Newskeeper サンプルの実行』を参照してください。
http://server:port/rpeng/ ページにリストされる
Rational Publishing Engine Web アプリケーションを構成します。各 URL の使用法および各フィーチャーを構成するタスクの説明については、『
Web アプリケーション URL』を参照してください。