JRun によるアプリケーションの開発
Web アプリケーションの アセンブルと公開

Web アプリケーションの公開

公開担当者は JRun Deploy ツールを使用して、Web アプリケーションをインストールします。JRun Deploy ツールは、JMC またはコマンド ライン インターフェイスから実行できます。

Web アプリケーション公開プロセスの内容は次のとおりです。

• WAR ファイルのディレクトリ構造への展開
• Web アプリケーションの JRun サーバーへの追加
• Web アプリケーションに対するアプリケーション マッピングの定義

詳細については、"アプリケーション マッピング"を参照してください。

公開プロセスを開始する前に、次の内容を確認してください。

• WAR ファイルの位置とディレクトリの絶対パス
• 公開した Web アプリケーションを含む JRun サーバーの名前
• Web アプリケーション名 (JRun は、JMC 中およびログに記録するときにこの名前を使用します。)
• アプリケーション ホスト
• この Web アプリケーションにアクセスするためにクライアントにより使用される URL 接頭辞
• Web アプリケーションの公開先ディレクトリの絶対パス (このディレクトリは、必ず常に存在する必要があります。同じ名前のファイルが存在する場合、そのファイルは公開プロセスによって上書きされます。)

JMC の使用

JMC を使用して Web アプリケーションを公開するには、次の手順を実行します。

1. JMC にログオンします。
2. Web アプリケーションの公開先サーバーを展開します。
3. [Web アプリケーション] を展開せずにクリックします。
4. 右側ペインで、[アプリケーションの公開] をクリックします。
5. 情報を指定します。
6. [公開] をクリックします。

詳細については、『JRun セットアップ ガイド』を参照してください。

コマンド ライン インターフェイスの使用

Web アプリケーション Deploy ツールのコマンド ライン インターフェイスでは、一連のパラメータを使用して WAR ファイルを公開できます。インターフェイスは、プロパティ ファイルおよびコマンド ラインからパラメータを受け入れます。

このセクションでは、コマンド ライン インターフェイスで使用される構文およびプロパティ ファイルの形式について説明します。

構文

WarDeploy ユーティリティを使用すると、Web アプリケーションの公開、削除、および再公開を行うことができます。このユーティリティは、jrun.jar ファイルに含まれています。次の構文を使用します。ここでは、jrun.jar が現在のシステム クラスパスであると想定しています。

java allaire.jrun.tools.WarDeploy -deploy -config=公開用プロパティ ファイル

java allaire.jrun.tools.WarDeploy -remove -config=削除用プロパティ ファイル
java allaire.jrun.tools.WarDeploy -redeploy -config=再公開用プロパティ ファ
イル

プロパティ ファイルの形式

公開を実行するためのプロパティ ファイルの形式は、次のとおりです。

• deploy.war.path= .war ファイルへの絶対パス
• deploy.server.name=default | サーバー名
• deploy.webapp.name=アプリケーション名
• deploy.context.path=/コンテキスト パス
• deploy.webapp.rootdir=Web アプリケーションのルート ディレクトリ (絶対パス)
• deploy.jrun.rootdir=JRun のルート ディレクトリ (絶対パス)

次の例は、公開プロパティを持つファイルを示します。

deploy.war.path=c:＼＼testdeploy＼＼rds-app.war

deploy.server.name=default
deploy.webapp.name=testdeploy
deploy.context.path=/testdeploy
deploy.webapp.rootdir=c:＼＼testdeploy
deploy.jrun.rootdir=c:＼＼program files＼＼allaire＼＼jrun

Web アプリケーションの削除または再公開のためのプロパティ ファイルの形式は次のとおりです。

• deploy.server.name=default | サーバー名
• deploy.webapp.name=アプリケーション名
• deploy.jrun.rootdir=JRun のルート ディレクトリ (絶対パス)

次の例は、削除または再公開に必要なプロパティを持つファイルを示します。

deploy.server.name=default

deploy.webapp.name=testdeploy
deploy.jrun.rootdir=c:＼＼program files＼＼allaire＼＼jrun

認証のためのユーザとロールの定義

認証のために、公開担当者は公開する Web アプリケーションのユーザとロールを定義します。詳細については、第 39 章を参照してください。

ホット デプロイおよびオート デプロイの使用

JRun バージョン 3.1 では、Web アプリケーションの動的な更新および自動的な公開が導入されました。この機能には、次のような特徴があります。

• ホット デプロイ - 既存の Web アプリケーション構造に対する物理的変化 (WAR ファイルの更新や web.xml ファイルへの変更など) を検出すると、実行中の Web アプリケーションを自動的に再起動します。
• オート デプロイ - 新しい WAR ファイルを検出すると、新しい Web アプリケーションを自動的に公開します。

ホット デプロイおよびオート デプロイを有効にすれば、Web アプリケーションを変更したり、新しい Web アプリケーションを追加するたびに JRun サーバーを再起動する必要がありません。ただし、JDBC データ ソースの追加など、サーバー レベルでの変更の後は、JRun サーバーを再起動しなければならないことに注意してください。

JRun 3.1 で実装する Web サーバーおよびアプリケーションでは、この設定を次のように使用しています。

• admin server - 無効 (admin/local.properties ファイルは
  webapp.hotdeploy.enabled=falseと指定します。)
• jmc-app (admin server) - 無効 (admin/jmc-app/WEB-INF/webapp.properties ファイルは webapp.hotdeploy.enabled=false と指定します。)
• default application - 有効 (この指定は global.properties ファイルの
  webapp.hotdeploy.enabled=true 指定から継承されます。)
• default server - 有効 (この指定は global.properties ファイルの
  webapp.hotdeploy.enabled=true 指定から継承されます。)
• default-app - 有効 (この指定は global.properties ファイルの
  webapp.hotdeploy.enabled=true 指定から継承されます。)
• demo-app - 有効 (この指定は global.properties ファイルの
  webapp.hotdeploy.enabled=true 指定から継承されます。)
• invoice-app - 有効 (この指定は global.properties ファイルの
  webapp.hotdeploy.enabled=true 指定から継承されます。)

ホット デプロイ

ホット デプロイは、global.properties および local.properties にある次のプロパティを使用して制御します。

• webapp.hotdeploy.enabled=true|false - ホット デプロイを有効または無効にします。
• webapp.hotdeploy.interval=interval - JRun が変更を確認する間隔を秒単位で指定します。既定値は 5 秒です。この値をゼロに設定すると、ホット デプロイ サービスは無効になります。
• webapp.hotdeploy.onchange=ディレクトリおよびファイルのカンマ区切りリスト -
  JRun が監視するディレクトリおよびファイルを指定します。これらのファイルのいずれかが変更されると、JRun は自動的に Web アプリケーションを再起動し、ログ ファイルに「hot deploy initiating」というメッセージを書き込みます。global.properties の既定の設定は、次のとおりです。

  webapp.hotdeploy.onchange={webapp.rootdir}/WEB-INF/web.xml,
   {webapp.rootdir}/WEB-INF/webapp.properties,
   {webapp.rootdir}/WEB-INF/lib
  

• webapp.hotdeploy.defaultname=default-app war file - 既定のコンテキスト (/ の URL) にマッピングされる WAR ファイルの名前を指定します。既定値は default.war です。ほとんどの場合、Web アプリケーションは /webappname をコンテキストとして使用しますが、既定のアプリケーションは単純にスラッシュを使用します。詳細については、Chapter 6, "JRun によるサーブレットへの要求のマッピング"を参照してください。

変更されたファイルが WAR ファイルの場合、JRun では以前に定義されたルート ディレクトリと URL マッピングを使用して Web アプリケーションを再公開し、再起動します。変更されたファイルが WAR ファイルでない場合、JRun では Web アプリケーションを再起動するだけです。

オート デプロイ

オート デプロイは、global.properties および local.properties にある
webapp.hotdeploy.autodeploy プロパティを使用して制御します。このプロパティはディレクトリを指定し、JRun がそのディレクトリに新しい WAR ファイルを見つけると、それらを自動的に公開します。JRun では、サーバーが起動するとこの場所を確認し、サーバーの実行中には新しいファイルがないかどうかを監視します。

global.properties の既定の設定は、次のとおりです。

webapp.hotdeploy.autodeploy={jrun.rootdir}/servers/{jrun.server.name}/
deploy/*.war

WAR ファイルを自動的に公開するときに、JRun は拡張子のない WAR ファイル名を使用して Web アプリケーション名および URL マッピングを作成し、その WAR ファイルを /servers/server name/Web アプリケーション名というディレクトリに展開します。たとえば、newapp.war を既定のサーバーの deploy ディレクトリのルート レベルに追加すると、JRun は次のように作成します。

• Web アプリケーション名は newapp
• URL マッピングは /newapp
• アプリケーションのルート ディレクトリは既定サーバーのルート/newapp

JRun で作成されるディレクトリ構造は、WAR ファイルを公開ディレクトリのサブディレクトリに格納することによって制御できます。たとえば、WAR ファイルを deploy/accounting/payroll.war に保存すると、JRun では、accounting-payroll という名前で /accounting/payroll という URL マッピングを持つ Web アプリケーションが作成されます。

Copyright © 2001, Macromedia Inc. All rights reserved.