注: この Java 配備ガイドでは、Java SE 6 update 10 リリースより前にリリースされた機能について説明します。最新情報については、「Java Rich Internet Application の開発および配備」の「構成ファイルおよびプロパティーの配備」を参照してください。
構成ファイルおよびプロパティーの配備
このページでは、次のトピックについて説明します。
概要
deployment.properties ファイルは、Java コントロールパネルでの構成プロパティーの配備を格納および取得するために使用します。また、Java Plug-in と Java Web Start 両方の実行時の動作をカスタマイズするためにも使用します。
ユーザーレベルの deployment.properties ファイルは必須です。その位置は後述しますが、構成はできません。また、システムレベルの deployment.properties ファイル (オプション) もあります。存在する場合、その位置は、システム管理者が後述する位置にある deployment.config ファイルで定義します。
構成ファイルの配備 (deployment.properties)
ユーザーレベル
ユーザーレベルの deployment.properties ファイルは次の位置にあります。
|
オペレーティングシステム
|
Location
|
| 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 が存在する場合、その位置は次のとおりです
|
オペレーティングシステム
|
Location
|
| Windows | <Windows Directory>\Sun\Java\Deployment\deployment.config |
| Unix | /etc/.java/deployment/deployment.config |
または
|
オペレーティングシステム
|
Location
|
| Windows | ${deployment.java.home}\lib\deployment.config |
| Unix | ${deployment.java.home}/lib/deployment.config |
(${deployment.java.home} は、配備対象製品が実行されている位置からの jre の位置。配備対象製品とは、Java Web Start、Java Plug-in、Java コントロールパネルなど)
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.insecure.jres |
String | "PROMPT" |
|
|
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.blacklist | String | ENABLE | 重大なセキュリティーの脆弱性を含む署名付き JAR ファイルのブラックリスト機能のサポート。deployment.security.blacklist.check は、この動作を切り替えるために使用されます。詳細は、「ブラックリスト機能」を参照してください。 |
| 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、 |
|
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,example.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.cache.enabled |
String | false | キャッシュを無効にするかどうか指定する。false の場合は無効にしない。 |
Java コンソール
|
プロパティーキー
|
型
|
デフォルト値
|
説明
|
|
deployment.console.startup.mode |
String |
"HIDE" |
選択肢は、次のとおり
|
トレースおよびロギング
|
プロパティーキー
|
型
|
デフォルト値
|
説明
|
| deployment.trace | String | false | トレースを有効にする。 |
| deployment.log |
String | false | ロギングを有効にする。 |
Java Web Start: JNLP 関連付け
|
プロパティーキー
|
型
|
デフォルト値
|
説明
|
| deployment.javaws.associations | int | 2 |
JNLP の関連付け。選択肢は、次のとおり ASSOCIATION_NEVER = 0、 |
Java Web Start: デスクトップの統合
|
プロパティーキー
|
型
|
デフォルト値
|
説明
|
|
|
String | "ASK_IF_HINTED" |
Java Web Start のデスクトップショートカットを作成するかどうか。選択肢は、次のとおり
|
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" |
自動ダウンロードを行うかどうか。選択肢は、次のとおり
|
ブラウザの選択とパス
|
プロパティーキー
|
型
|
デフォルト値
|
説明
|
|
deployment.browser.path |
String | "<No Browser Selected>" |
アプリケーションビューア、「製品情報」ウィンドウ、および Web Start アプリケーションから Web ページを表示するために使用するブラウザのパス。 このプロパティーは Solaris および Linux でのみ使用する。Widows ではこのプロパティーは無視される。Windows でブラウザを起動するその他のアプリケーションと同様の方法で、デフォルトのブラウザが判断される。 |
更新タイムアウトの確認
|
プロパティーキー
|
型
|
デフォルト値
|
説明
|
| deployment.javaws.update.timeout | int | 500 | 単位はミリ秒。 |