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

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

概要

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.jsse.hostmismatch.warning

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

deployment.security.trusted.policy

String ""

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

deployment.security.mixcode

 String ENABLE "ENABLE" は、信頼できるコードと信頼できないコードの混在についての検査を有効にし、安全でない可能性のあるコンポーネントが検出された場合に警告ダイアログを表示します。"HIDE_RUN" は、警告ダイアログを表示せず、安全でない可能性のあるコンポーネントが検出されると、警告ダイアログでユーザーが「いいえ」をクリックした場合と同じように動作します。つまり、保護がいくらか強化された状態でアプレットまたはアプリケーションの実行が継続されます。"HIDE_CANCEL" は、警告ダイアログを表示せず、警告ダイアログでユーザーが「はい」をクリックした場合と同じように動作します。つまり、安全でない可能性のあるコンポーネントの実行はブロックされ、場合によってはプログラムが終了することもあります。"DISABLE" (非推奨) は、信頼できるコードと信頼できないコードの混在の検査を完全に無効にします。その場合、ユーザーは安全でない可能性のあるコードを、警告も保護の強化もなくそのまま実行することになります。

deployment.security.sandbox.awtwarningwindow

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

deployment.security.sandbox.jnlp.enhanced

String true ユーザーに JNLP API セキュリティーダイアログを表示して同意を求める場合は true
deployment.security.validation.ocsp Boolean false OCSP (Online Certificate Status Protocol) を有効にするかどうかを指定。
deployment.security.validation.ocsp.url String null OCSP の応答サーバーを示す URL 文字列を指定。
deployment.security.validation.ocsp.signer String null OCSP 応答 singer の証明書の主体名を指定。
deployment.security.validation.crl Boolean false 証明書の取り消しリストを使用するかどうかを指定。
deployment.security.validation.crl.url String null 証明書の検証を実行するため、証明書の取り消しリストの URL を指定。
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 単位はミリ秒