構成ファイルおよびプロパティの配備

構成ファイルおよびプロパティの配備には次の内容が含まれます。

概要

deployment.properties ファイルは、Java コントロールパネルでの構成プロパティの配備を格納および取得するために使用します。また、Java Plug-in と Java Web Start 両方の実行時の動作をカスタマイズするためにも使用します。

ユーザレベルの deployment.properties ファイルは必須です。その位置は後述しますが、変更はできません。また、システムレベルの deployment.properties ファイル (省略可能) もあります。存在する場合、その位置は、システム管理者が後述する位置にある deployment.config ファイルで定義します。

構成ファイルの配備 (deployment.properties)

ユーザレベル

ユーザレベルの deployment.properties ファイルは次の位置にあります。

オペレーティングシステム
位置
Windows <User Application Data Folder>\Sun\Java\Deployment\deployment.properties
Unix ${user.home}/.java/deployment/deployment.properties

(${user.home} は、通常 home/<username>)

例:

Windows 2000/XP 上で実行しているユーザ jsmith の場合、deployment.properties ファイルは次の位置にあります。

C:\Documents and Settings\jsmith\Application Data\Sun\Java\Deployment\deployment.properties

Unix 上で実行しているユーザ bjones の場合、deployment.properties ファイルは次の位置にあります。

/home/bjones/.java/deployment/deployment.properties

システムレベル

deployment.config ファイルは、お使いのインフラストラクチャにおける、システムレベルの deployment.properties を指定するために使用されます。デフォルトでは deployment.config ファイルは存在しません。そのため、システムレベルの deployment.properties ファイルも存在しません。deployment.config が存在する場合、その位置は次のとおりです。

オペレーティングシステム
位置
Windows <Windows Directory>\Sun\Java\Deployment\deployment.config
Unix /etc/.java/deployment/deployment.config

または

オペレーティングシステム
位置
Windows ${deployment.java.home}\lib\deployment.config
Unix ${deployment.java.home}/lib/deployment.config

(${deployment.java.home} は、Java Web Start、Java Plug-in、Java Control Panel などの配備対象製品が実行されている位置からの jre の位置)

deployment.config が存在している場合、deployment.system.config と deployment.system.config.mandatory の 2 つのプロパティがあります。

deployment.system.config は、システム (企業全体) の deployment.properties ファイルに対する URL です。システム管理者がユーザ固有の構成設定を中央管理または厳重管理するために使用できます。

deployment.system.config.mandatory はブール値です。デフォルト値は false です。false の場合、deployment.system.config の URL で示される deployment.properties ファイルをロードしようとします。URL が見つかり、ロードできる場合は、このファイルが使用されます。true の場合、deployment.system.config の URL で示されるシステムレベルの deployment.properties ファイルも同様にロードしようとします。URL が見つかり、ロードできる場合は、このファイルが使用されます。見つからない場合や、ロードできない場合は、何も実行できません。

構成プロパティの配備

deployment.properties ファイルで設定可能なプロパティを次の表に示します。

注:

どのシステム配備プロパティ (つまり SomeKey=SomeValue) も、別のキー SomeKey.locked を含めることでロックできます。キー SomeKey.locked は、値を設定できる場合もできない場合もありますが、どちらの場合も SomeKey=SomeValue はロックされるため、ユーザが変更することはできません。システム配備プロパティをロックしない場合、ユーザによる変更が可能になります。


プロパティキー
型
デフォルト値
説明
 
インフラストラクチャ
deployment.user.cachedir
 String "$USER_HOME" +
File.separator + "cache"		 ユーザレベルのキャッシュディレクトリ
deployment.system.cachedir
 String null システムレベルのキャッシュディレクトリ
deployment.user.logdir String "$USER_HOME" + File.separator + "log" ユーザレベルのログディレクトリ
deployment.user.tmp
 String "$USER_HOME" +
File.separator + "tmp";		 一時ユーザディレクトリ
証明書ストアとポリシーファイル
deployment.user.security.policy
 String "file://$USER_HOME/security/java.policy"

ユーザレベルのセキュリティポリシーファイル。URL のプロトコルは file、HTTP、または HTTPS

deployment.user.security.trusted.cacerts

String "$USER_HOME" + File.separator + "security" + File.separator + "trusted.cacerts";

ユーザレベルのルート CA 証明書ストア

deployment.user.security.trusted.jssecacerts

String "$USER_HOME" + File.separator + "security" + File.separator + "trusted.jssecacerts"

ユーザレベルの JSSE CA 証明書ストア

deployment.user.security.trusted.certs

String "$USER_HOME" + File.separator + "security" + File.separator + "trusted.certs"

ユーザレベルの信頼される署名者証明書ストア

deployment.user.security.trusted.jssecerts

String "$USER_HOME" + File.separator + "security" + File.separator + "trusted.jssecerts";

ユーザレベルの信頼される JSSE 証明書ストア

deployment.user.security.trusted.clientauthcerts

String "$USER_HOME" + File.separator + "security" + File.separator + "trusted.clientcerts"

ユーザレベルのクライアント認証証明書ストア

deployment.system.security.policy

String null

システムレベルのセキュリティポリシーファイル。URL のプロトコルは file、HTTP、または HTTPS

deployment.system.security.cacerts

String "$JAVA_HOME" + File.separator + "lib" + File.separator + "security" + File.separator + "cacerts"

システムレベルのルート CA 証明書ストア

deployment.system.security.jssecacerts

String "$JAVA_HOME" + File.separator + "lib" + File.separator + "security" + File.separator + "jssecacerts";

システムレベルの JSSE CA 証明書ストア

deployment.system.security.trusted.certs

String "$SYSTEM_HOME" + File.separator + "security" + File.separator + "trusted.certs"

システムレベルの署名者証明書ストア

deployment.system.security.trusted.jssecerts

String "$SYSTEM_HOME" + File.separator + "security" + File.separator + "trusted.jssecerts"

システムレベルの JSSE 証明書ストア

deployment.system.security.trusted.clientauthcerts

String "$SYSTEM_HOME" + File.separator + "security" + File.separator + "trusted.clientcerts"

システムレベルのクライアント認証証明書ストア
セキュリティアクセスおよびコントロール設定

deployment.security.askgrantdialog.show

String true ユーザが権限を完全に与えることができるようにする場合は true

deployment.security.askgrantdialog.notinca

 String true ユーザが、ルート/JSSE CA 証明書ストア内の CA によって発行されていない証明書への権限を与えることができるようにする場合は true

deployment.security.notinca.warning

String true ルート CA にないことの警告を証明書ダイアログで表示する場合は true

deployment.security.expired.warning

String true 証明書が期限切れであることの警告を証明書ダイアログで表示する場合は true

deployment.security.jsse.hostmismatch.warning

String true ホストが一致しないことの警告を JSSE HTTPS 証明書検証で表示する場合は true

deployment.security.trusted.policy

String ""

ポリシーファイルには、信頼されるアプリケーションやアプレットに与えられる権限の上限ポリシーがある。デフォルトではすべての権限だが、この構成設定を使用することで、権限のより低いセットをユーザまたは企業が構成できる

deployment.security.sandbox.awtwarningwindow

String true sandbox が awtShowWindowWithoutWarning を含む場合は true

deployment.security.sandbox.jnlp.enhanced

String true ユーザに JNLP API セキュリティダイアログを表示して同意を求める場合は true
deployment.security.authenticator
String true 通常、Java Plug-in と Java Web Start では、Web ページの認証やプロキシの認証を行う必要のある通信を処理するために、Authenticator をインストールする。これはデフォルトの動作である (true)。このオプションは、通常の動作を止める場合に使用する。たとえば、アプリケーションが Web ページの認証を行いながら自身と通信するために、独自の Authenticator をインストールする必要がある場合など
ネットワーク機能

deployment.proxy.type

int PROX_TYPE_BROWSER の場合は 3

使用するプロキシのタイプ。選択肢は、次のとおり

PROX_TYPE_UNKNOWN = -1、
PROX_TYPE_NONE = 0、
PROX_TYPE_MANUAL = 1、
PROX_TYPE_AUTO = 2、
PROX_TYPE_BROWSER = 3

deployment.proxy.same

boolean false true の場合は、https と ftp でも、http 用に構成されたのと同じ Web サーバとポートを使用する(deployment.proxy.type = PROX_TYPE_MANUAL の場合のみ有効)
deployment.proxy.auto.config.url   String (デフォルト値なし) 自動プロキシ設定用 JavaScript の URL
deployment.proxy.bypass.list String (デフォルト値なし) プロキシをバイパスするホスト名の一覧。このプロパティでは、ホスト名をカンマで区切る。例: 192.168.1.100,localhost,sun.com
deployment.proxy.bypass.local   String (デフォルト値なし)

ローカルホストの場合はすべてバイパスする
deployment.proxy.http.host   String (デフォルト値なし) HTTP プロキシホスト名
deployment.proxy.http.port   String (デフォルト値なし) HTTP プロキシポート
deployment.proxy.https.host    String (デフォルト値なし) HTTPS プロキシホスト名
deployment.proxy.https.port String (デフォルト値なし) HTTPS プロキシポート
deployment.proxy.ftp.host   String (デフォルト値なし) FTP プロキシホスト名
deployment.proxy.ftp.port   String (デフォルト値なし) FTP プロキシポート
deployment.proxy.socks.host   String (デフォルト値なし) SOCKS v4 プロキシホスト名
deployment.proxy.socks.port   String (デフォルト値なし) SOCKS v4 プロキシポート
deployment.proxy.override.hosts
String "" プロキシがオーバーライドされる一覧
キャッシュと省略可能なパッケージのリポジトリ
deployment.cache.max.size
String -1

配備キャッシュの最大サイズ (MB)。Java Web Start および Java Plug-in の各キャッシュに対するキャッシュサイズ

0 - Java Plug-in でのキャッシュを無効にする。Java Web Start でのキャッシュサイズは制限されない

-1 - キャッシュサイズの制限なし
deployment.cache.jarcompression
String 0

アプレットの jar 圧縮で使用される 0〜9 の圧縮比
deployment.javapi.cache.enabled
 String false キャッシュを無効にするかどうか指定する。false の場合は無効にしない
Java コンソール

deployment.console.startup.mode

String

HIDE

選択肢は、次のとおり

  • HIDE - Java コンソールを隠す
  • SHOW - Java コンソールを表示する
  • DISABLE - Java コンソールを無効にする
トレースおよびログ
deployment.trace   String false トレースを有効にする
deployment.log
String false ログを有効にする
Java Web Start: JNLP 関連付け
deployment.javaws.associations   int 2

JNLP の関連付け。選択肢は、次のとおり

ASSOCIATION_NEVER = 0、
ASSOCIATION_NEW_ONLY = 1、
ASSOCIATION_ASK_USER = 2、
ASSOCIATION_REPLACE_ASK = 3
Java Web Start: デスクトップの統合


deployment.javaws.shortcut

 String ASK_IF_HINTED

Java Web Start のデスクトップショートカットを作成するかどうか。選択肢は、次のとおり

  • NEVER
  • ALWAYS
  • ASK_USER
  • ASK_IF_HINTED
  • ALWAYS_IF_HINTED
Java Web Start: JRE の選択

deployment.javaws.installURL

String http://java.sun.com/products/autodl/j2se

自動ダウンロードの URL
Java Web Start: JRE の管理

deployment.javaws.autodownload

String ALWAYS

自動ダウンロードを行うかどうか。選択肢は、次のとおり

  • ALWAYS
  • PROMPT
  • NEVER
ブラウザの選択とパス

deployment.browser.path

 String No Browser Selected

アプリケーションビューア、[製品情報] ウィンドウ、および Web Start アプリケーションから Web ページを表示するために使用するブラウザのパス

このプロパティは Solaris および Linux でのみ使用する。Widows ではこのプロパティは無視される。Windows で ブラウザを起動するその他のアプリケーションと同様の方法で、デフォルトのブラウザが判断される
更新タイムアウトの確認
deployment.javaws.update.timeout   
 int 500 単位はミリ秒