This page describes how to set Java properties and options on startup for Confluence Stand-alone and EAR/WAR versions.

See Fix Out of Memory Errors by Increasing Available Memory for specific instructions for OutOfMemory Errors.

On this page:

(warning) The information on this page does not apply to Confluence OnDemand.

Linux

Linux インストールでシステム プロパティを設定する方法
  1. From <confluence-install>/bin (Stand-alone) or <Tomcat-home>/bin (EAR-WAR installation), open setenv.sh.
  2. Find the section JAVA_OPTS=
  3. 下記のパラメーター一覧を参照してください。

(info) 引用内部では、各パラメーターをスペース区切りのリスト形式で追加します。

Windows (.batファイルから起動)

Windowsインストールで .bat ファイルから起動する際にシステム プロパティを設定する方法
  1. <confluence-install>/bin (スタンドアロン) または <Tomcat-home>/bin (EAR-WAR インストレーション) で setenv.bat を開きます。
  2. Find the section set JAVA_OPTS=%JAVA_OPTS%
  3. 下記のパラメーター一覧を参照してください。

(info) Add all parameters in a space-separated list. Make sure to keep the string %JAVA_OPTS% in place.

Windows サービス

Windows上でConfluenceをサービスとして自動的に起動する場合、 システム プロパティを設定するには 2 つの方法があり、コマンドラインから設定するかまたは Windows のレジストリで設定するかのいずれかです。

Windows サービスのプロパティをコマンド ラインから設定する

Windows サービスのプロパティをコマンド ラインから設定する
  1. Identify the name of the service that Confluence is installed as in Windows ( Control Panel > Administrative Tools > Services ):

    (info) In the above example, the SERVICENAME is: JIRA030908110721. Find the Confluence equivalent.
  2. Start >> Run >> type in 'cmd' >> Enter でコマンド ウィンドウを開きます。
  3. Confluence インスタンスの bin ディレクトリか、Confluence の EAR/WAR を実行している場合は Tomcat インストレーションの bin ディレクトリに cd します。
  4. 次のコマンドを実行します。

    tomcat6w //ES//%SERVICENAME%
    

    .
    (info) In the above example, it would be tomcat6w //ES//JIRA030908110721

  5. Click on the Java tab to see the list of current start-up options:
  6. 新しいオプションを追加する場合は、既存の Java オプションの最後に新しい行として追加します。以下のパラメーター一覧を参照してください。

Windows レジストリで Windows サービスのプロパティを設定する

Windows の一部のバージョンには、Java 変数をサービスに追加するオプションがありません。この場合、レジストリ内のオプション一覧を表示してプロパティを追加する必要があります。

Windows サービスのプロパティを Windows レジストリで設定する方法
  1. Go to {{Start >> Run, and run "regedit32.exe".
  2. Find the Services entry:
    32-bit: HKEY_LOCAL_MACHINE >> SOFTWARE >> Apache Software Foundation >> Procrun 2.0 >> Confluence
    64-bit: HKEY_LOCAL_MACHINE >> SOFTWARE >> Wow6432Node >> Apache Software Foundation >> Procrun 2.0 >> Confluence
  3. To change existing properties, especially increasing Xmx memory, double-click the appropriate value.
  4. To change additional properties, double-click options.
  5. 以下のパラメーター一覧を参照してください。各行に1つずつ入力します。

設定を確認する

現在の Confluence の設定は、システム プロパティ表示で確認します。

認識済みのシステム プロパティ

プロパティ

利用可能バージョン

既定値

モジュール...

効果

atlassian.forceSchemaUpdate

1.0

false

atlassian-config

既定では、Confluence はアップグレードされたことを検出したときにのみ、データベース スキーマの更新を実行します。このフラグによって、Confluence はシステム起動時にスキーマの更新を自動的に実行します。

confluence.home

1.0

任意のファイルシステム パス

Confluence and atlassian-config

このシステム プロパティが設定されている場合、Confluence は confluence-init.properties ファイルの内容を無視し、このプロパティを Confluence ホーム ディレクトリの設定として使用します。

confluence.devmode

1.0

false

Confluence

Confluence 開発者の役に立つ追加のデバッグ オプションを有効にします(さらに、Spring Bean の作成を変更して、既定で遅延初期化を使用し、起動時間を短縮します)。本番システム上でこのフラグを有効にしないでください。

confluence.disable.mailpolling

2.4

false

Confluence

"true" に設定されている場合は、Confluence がメールを取得してスペース内にアーカイブするのを妨げます。Web UI を使用する手動の "新規メールの確認" トリガーは動作します。このプロパティは送信メールには影響しません

confluence.i18n.reloadbundles

1.0

true

Confluence

このプロパティを設定すると、Confluence は国際化文字列が検索されるたびに、i18 n リソース バンドルをリロードします。これは翻訳をテストするときに役立ちますが、Confluenceの実行が非常に遅くなります。

confluence.ignore.debug.logging

1.0

true

Confluence

デバッグ レベル ログが有効であることを検出した場合、Confluenceでは重大なエラーメッセージがログに記録されるのが普通です。(一般的に、デバッグログはシステムのパフォーマンスを大幅に低下させる原因となるためです)。このプロパティを設定すると、エラーメッセージが抑制されます。

confluence.jmx.disabled

3.0

false

Confluence

"true" に設定すると、Confluence の JMX モニタリングが無効になります。これには、WEB-INF/classes/jmxContext.xml で "enabled" プロパティを false に設定するのと同じ効果があります。

confluence.optimize.index.modulo

2.2

20

Confluence

インデックスが最適化される前に、フラッシュするインデックス キューの数。

confluence.plugins.bundled.disable

2.9

false

Confluence

バンドルされたプラグインなしで Confluence を起動します。開発環境で Confluence を速く起動するのに役立つ可能性はありますが、Confluence の主要な機能の一部はバンドルされたプラグインを必要とするため、このプロパティは、本番システムに設定するべきではありません。

atlassian.mail.fetchdisabled

3.5

false

Confluence

IMAP と POP のメール フェッチ サービスを無効にします。

atlassian.mail.senddisabled

3.5

false

Confluence and atlassian-mail

メールの送信を無効にします

atlassian.disable.caches

2.4

true

atlassian-plugins, atlassian-cache-servlet

このプロパティを設定すると、Web リソース上のヘッダーに対する条件付き GET が無効になり、期限切れになります。これによってユーザーエクスペリエンスは大幅に遅くなりますが、静的リソースを頻繁に変更していて、ブラウザのキャッシュを継続的に消去したくない場合、開発では役に立ちます。

confluence.html.encode.automatic

2.9

 

Confluence

このプロパティを設定すると、antixss エンコードを強制的にオンまたはオフにし、設定によって決定される動作が上書きされます。既定の動作は Confluence のバージョンによって異なります。

org.osgi.framework.bootdelegation

2.10

atlassian-plugins

アプリケーションから OSGi プラグインを提供するパッケージ名をカンマ区切りで表示した一覧。Confluence のプロファイリング時に通常必要。例: "com.jprofiler.、com.yourkit. "。

confluence.diff.pool.size

3.1

20

Confluence

同時差分の最大数。その数を超えると、差分を作成しようとする RSS フィードによる追加の試みは無視され、ログに記録されます。(RSS 要求は成功しますが、ただ差分が欠けています)。

confluence.diff.timeout

3.1

1000

Confluence

差分の作成操作(2 つのページ バージョンを比較)を完了するまで待機するミリ秒数で、これを過ぎるとエラーメッセージを表示して操作を中止します。

atlassian.user.experimentalMapping

2.10

false

Confluence

多数のユーザーを抱えるローカルグループにローカルユーザーを追加する際、このプロパティを設定することにより、ローカルユーザーとローカルグループの関係を変化させて、パフォーマンスの低下を軽減します。このプロパティを設定すると、他のユーザー管理機能を遅延させる可能性があることにご注意ください。大規模なローカルグループにローカルユーザーを追加する際、パフォーマンスの問題が発生する場合にのみ、このプロパティを設定することをお勧めします。Confluence 3.1.1. で修正済の CONF-12319 を参照してください。

confluence.import.use-experimental-importer

3.2

false

Confluence

このプロパティを設定すると、試験的な XML インポーターを使用するよう Confluence を変更します。このインポーターはより安定した実装ができるように設計されていますが、3.2 リリース時にはほとんどテストされていないため、サポートされていません。

atlassian.webresource.disable.minification

3.3

false

atlassian-plugins

Confluence がサービスを提供する JavaScript と CSS リソースの自動ミニフィケーションを無効にします。

index.queue.thread.count

3.3

"効果" を参照

Confluence

再インデックス ジョブに使用されるスレッド数を設定します。値は 1 ~ 10 (境界を含む)の範囲内でなければなりません。すなわち、少なくとも 1 つのスレッドを使用し、10 スレッド以下のスレッドを使用します。つまり、既定値はありません。

  • index.queue.thread.count を設定しない場合、使用されるスレッド数は、再インデックスに必要なオブジェクト数および使用可能なプロセッサ数をもとに計算されます (最大 10 スレッドが使用されます)。
  • index.queue.thread.count=2 と設定している場合、再インデックスされるオブジェクト数や利用可能なプロセッサ数を問わず、2 つのスレッドがコンテンツの再インデックスに使用されます。
  • index.queue.thread.count=200 と設定している場合、10 スレッド (最大限度) がコンテンツの再インデックスに使用されます。

index.queue.batch.size

3.3

1500

Confluence

インデクサーが使用するバッチのサイズ。この値を小さくすると、インデクサーがシステムにかける負荷が軽減しますが、インデックス作成に時間がかかります。この値を大きくすると、インデックス作成が速く完了しますが、システムに高い負荷がかかります。通常、この設定はチューニングを必要としません。

password.confirmation.disabled

3.4

false

Confluence

このプロパティは、Confluence が追加のセキュリティ対策として使用するパスワード確認機能を無効にします。このプロパティを設定すると、Confluence では次の操作のパスワード確認を必要としません:管理操作、メールアドレスの変更、ログイン失敗に対応する Captcha。カスタム認証システムを使用している場合は、パスワードの確認を無効にすると便利です。

confluence.browser.language.enabled

3.5

true

Confluence

このプロパティを "false" に設定すると、ブラウザの言語ヘッダーの検出が無効になり、Confluence の動作を実質的に以前のリリースの動作に戻します。このプロパティを "true" に設定すると、ブラウザから送られる言語ヘッダーの検出が有効になります。Confluenc はブラウザのヘッダーをもとに、UI 言語を変更します。言語設定の選択 方法に関するドキュメントを参照してください。

upm.pac.disable

ユニバーサル プラグイン マネージャー 1.5

false

ユニバーサル プラグイン マネージャー(UPM)

When this property is set to true, then UPM will not try to access the Atlassian Plugin Exchange. This is useful for application servers that do not have access to the Internet. See the UPM documentation.

confluence.reindex.documents.to.pop

3.5.9

20

Confluence

完全な再インデックス中に、各インデックス スレッドが一度に処理するオブジェクト数を示します。この数には添付ファイル数が含まれませんので、ご注意ください

confluence.reindex.attachments.to.pop

3.5.9

10

Confluence

完全な再インデックス中に、各インデックス スレッドが一度に処理する添付ファイル数を示します。

confluence.upgrade.active.directory

3.5.11

false

Confluence

Forces Confluence to treat any LDAP directories it migrates as Active Directory, rather than relying on looking for sAMAccountName in the username attribute. This is necessary if you are upgrading from before Confluence 3.5, and need to use an attribute other than sAMAccountName to identify your users and are seeing LDAP: error code 4 - Sizelimit Exceeded exceptions in your logs. For more details, see Unable to Log In with Confluence 3.5 or Later Due to 'LDAP error code 4 - Sizelimit Exceeded'

com.atlassian.logout.disable.session.invalidation

4.0

false

Confluence

ログアウト時のセッション無効化を無効にします。4.0 での既定の動作は、ログアウト時にクライアントに割り当てられた JSession を無効にすることです。これが true に設定されている場合、セッションはアクティブのまままになります(ただし、ユーザーはログアウト)。これは外部の認証システムを使用する場合に役立ちますが、一般に必要とされるものではありません。

関連トピック

Recognised System Properties
Fix Out of Memory Errors by Increasing Available Memory