JRun セットアップ ガイド 戻る 上へ
プロパティ ファイル


PropertyScript の使用法

PropertyScript ユーティリティを使用すると、JRun プロパティ ファイルにある設定の変更、追加、および削除を行うことができます。PropertyScript は、JRun プロパティ ファイルを変更するディレクティブが含まれている、個別のスクリプト ファイルを処理します。

PropertyScript クラスは、install.jar ファイルにある allaire.jrun.install パッケージの一部です。クラスパスには、install.jar を含める必要があります。

PropertyScript の使用法 

java -cp [classpath] allaire.jrun.install.PropertyScript script-file 
[property-file]

script-file は、ディレクティブが含まれているスクリプト ファイルへのファイルのシステム パスです。スクリプト ファイルの作成については、"スクリプト ファイルの作成"を参照してください。

property-file オプションでは、global.properties、local.properties、jvms.properties などの JRun プロパティ ファイルを指示します。このオプションは現在のリリースの JRun で推奨されていないため、必要ありません。script-file には JRun プロパティ ファイルを指定します。

例 : 

C:¥>java -cp "c:¥program files¥allaire¥jrun¥lib¥install.jar" 
allaire.jrun.install.PropertyScript 
"c:¥program files¥allaire¥jrun¥servers¥default¥script.txt"

スクリプト ファイルの作成

script-file オプションでは、JRun プロパティ ファイルの変更時に PropertyScript によって使用されるすべてのディレクティブが含まれるテキスト ファイルを指示します。スクリプト ファイルの作成時には、少なくとも 1 つの file コマンドと filename (JRun プロパティ ファイルを参照する) を含める必要があります。各 file コマンドの下には、前に示してある filename に対して実行するディレクティブおよびオプションを列挙します。

スクリプト ファイルの構文は、次のようになります。 

file filename
directive1
[directive2]
...
[file filename]
[directive1]
[directive2]
...

スクリプト ファイル内のプロパティ ファイルのセクションごとに、新しい file コマンドを指定する必要があります。filename (ファイル名) には、*.property ファイルへの絶対パスを指定する必要があります。

通常、スクリプト ファイル内の各ディレクティブは、1 つのコマンドと、1 組のキーと値のペアから成り立っています。キーは、JRun プロパティ ファイル内のプロパティに対応します。

次の例では、add がコマンド、control.endpoint.main.port がキー、53000 が値です。 

add control.endpoint.main.port=53000

複数の値を持つキーもあります。この場合、値はスペースまたはカンマで区切られることがあります。

次の表では、スクリプト ファイルのディレクティブとそのオプションについて説明しています。
ディレクティブ
説明
add キー 値
 新しいキーと値を、プロパティ ファイルの最後に追加します。既存のキーを追加すると、該当するキーと値が PropertyScript によって上書きされます。
replace キー 値
 キーの値を新しい値に置き換えます。存在しないキーの値を置き換えようとすると、このディレクティブは PropertyScript によって add として処理されます。
delete キー
 キーとその値を削除します。
clear キー
 キーのすべての値を削除しますが、キーは削除しません。
append キー 値
 キーの最後の値の後に、値を追加します。値の先頭には、区切り文字 (通常はカンマ) を指定する必要があります。
たとえば、jcp を servlet.services キーに追加する場合は、次のように指定します。
append servlet.services ,jcp
一部のキーはカンマでなくスペースによって区切られます。この場合は、append_space ディレクティブを使用します。
append_space キー 値
 キーの最後の値の後にスペースを入れてから、値を追加します。スペースを区切り文字として使用する java.args キーを変更する場合に役立ちます。
token_remove キー 値
 キーの中から指定した値を検索し、その値および後に続く区切り文字 (スペースまたはカンマ) を削除します。
ejb_append jrun.services 値
 global.properties ファイル内の jrun.services キーを変更する場合にのみ使用します。servlet_services はほかのすべてのサービスが開始してから開始する必要があるので、このメソッドを使用して {servlet_services} キーを一覧の最後に表示します。
unplug [servlet|ejb]
 サーブレットまたは EJB のいずれかの機能を JRun から削除します。ユーザがコンポーネントを追加および削除できるようにする場合に使用します。また、インストール ファイルを編集して、不要なコンポーネントがインストールされないようにすることもできます。
unplug によってコンポーネントが無効になりますが、実際にはアンインストールされません。
comment キー
テキスト文字列
 テキスト文字列から構成されるコメント行を、指定したキーの上の行に追加します。
adduser ユーザ名
パスワード
 新規 JMC ユーザを追加します。PropertyScript では、UnixCrypt を使用してパスワードが暗号化されます。このディレクティブは、pass.properties ファイルを変更する場合にのみ使用します。
このディレクティブを使用して、新規の Web アプリケーション ユーザを users.properties ファイルに追加することはできません。Web アプリケーション ユーザを追加する方法については、『JRun によるアプリケーションの開発』にある「PropertyFileAuthentication クラス」の説明を参照してください。
port キー 最小値,最大値
 インストール時に JRun で設定される、admin サーバのアクセス可能ポート範囲を設定します。最小値は最小のポート番号、最大値は最大のポート番号です。
PropertyScript では、この範囲内にあるすべてのポートが試行されます。
ポート ディレクティブは、JRun サーバの
local.properties ファイルごとに指定します。
admin サーバの既定範囲は 8000 ～ 8099 です。default サーバの既定範囲は 8100 ～ 8199 です。

サンプル スクリプト ファイル

次に、スクリプト ファイルの一例を示します。この例では、default JRun サーバの local.properties ファイルに対して、新しい Web アプリケーション、「MyStocks」を追加し、demo-app を削除します。最後の行は、default JRun サーバの JRun Web サーバのポートを、8080 ～ 8089 の範囲で使用可能なポートに変更します。 

file c:¥program files¥allaire¥jrun¥servers¥default¥local.properties
add webapp.mapping./mystocks /mystocks                  
add /mystocks.rootdir C:¥Mycompany¥servers¥default¥mystocks
add /mystocks.class {webapp.service-class}
token_remove servlet.webapps demo-app
append servlet.webapps ,/mystocks
comment servlet.webapps # mystocks app が追加され、demo が削除されました。
delete demo-app.rootdir
delete demo-app.class
delete webapp.mapping./demo
port web.endpoint.main.port 8080,8089


Copyright © 2001, Macromedia Inc. All rights reserved. 戻る 上へ