Synchrony の設定

Synchrony は、Confluence での共同編集を実現します。

Synchrony を設定するための UI はありません。設定の変更 (Synchrony ポートやメモリ設定の変更など) はシステム プロパティ経由で行われます。これらのプロパティの渡し方は、Synchrony が Confluence によって管理されているか、別のクラスタとしてデプロイされているかによって異なります。 

ほとんどの場合、Synchrony は Confluence で管理されます。 

Data Center ライセンスをお持ちの場合、Confluence に対して Synchrony の管理を許可するのではなく、スタンドアロンの Synchrony をクラスタでデプロイおよび管理することを選択できます。詳細は、「Confluence および Synchrony で利用可能な設定」を参照してください。 

このページの内容

認識済みのプロパティを Synchrony に渡す

Synchrony が Confluence で管理されている場合 (最も一般的な設定)、システム プロパティを Confluence に渡すことで、Synchrony に変更を加えることができます。お使いのオペレーティング システムでこれを行う最適な方法について、「システム プロパティの設定」を参照してください。 

認識済みのシステム プロパティ」でシステム プロパティの完全な一覧を確認できます。 

スタンドアロンの Synchrony をクラスタで実行している場合は、start-synchrony スクリプト経由で Synchrony に直接プロパティを渡します。

プロパティは、Synchrony が Confluence で管理されている場合とは異なる場合があります。必須プロパティとオプションのプロパティの完全な一覧については、「Confluence Data Center 用に Synchrony クラスタを設定する」を参照してください。 

JVM 引数を Synchrony に渡す

システム プロパティで提供されていない追加の引数を、Synchrony の JVM へ直接渡す必要が生じることがあります。  

Synchrony が Confluence で管理されている場合、ホーム ディレクトリ (Datacenter ライセンスの場合は共有ディレクトリ) で synchrony-args.properties という名前のファイルを作成し、次のように、Synchrony に渡したい引数を 1 行に 1 つずつ含める必要があります。

property1=value1
property2=value2

この方法では、ポート、Xmx または Xss などの、システム プロパティによって既に処理された値を渡すことはできません。

スタンドアロンの Synchrony をクラスタで実行している場合は、[オプションを上書き] セクションで start-synchrony スクリプトに追加して、Synchrony の JVM に引数を直接渡します。 

設定変更の一般的な例

Synchrony に変更を加える 2 つの一般的な例として、ポート 8091 が既に使用されている場合に Synchorny を実行するポートを変更する場合と、Synchrony に割り当てられている最大ヒープ メモリをを変更する場合があります。 

Synchrony が実行されているポートの変更

Synchrony は、既定でポート 8091 で実行されます。このポートがサーバー上の別のアプリケーションによってすでに使用されている場合は、synchrony.port システム プロパティを使用して、利用可能なポートを変更します。  

If you're running Confluence 6.0.3 or earlier you'll need to use reza.port instead of synchrony.port.

Synchrony の最大ヒープを変更するには

Synchrony の既定の最大ヒープサイズは 1 GB です。 

Synchrony に関連してメモリ不足エラーが発生した場合は、synchrony.memory.max システム プロパティを使用して、Synchrony に割り当てられているヒープ サイズを変更できます。

If you're running Confluence in a cluster, we recommend you increase the maximum heap size to at least 2gb on each node. 

Change the logging level for managed Synchrony

The logging level for managed Synchrony is set to INFO by default. If you find this too verbose, you can decrease the logging level to WARN or ERROR

To change the managed Synchrony logging level: 

  1. Create a file called synchrony-log4j.properties with the following content:

    log4j.rootLogger=WARN, stdout
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.Target=System.out
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%d %p [%t] [%c{4}] %m%n

    In this example we'll set the logging level to WARN . Replace this with ERROR if you only want to log errors. 

  2. Save the file. You can place the file anywhere, but we recommend your home directory (or shared home) alongside the synchrony-args.properties file. 
  3. Edit your <home-directory>/synchrony-args.properties  file. If you're running Confluence in a cluster, this will be in your shared home directory. 
  4. Add the following line to tell Synchrony where to find your log configuration. 

    log4j.configuration=file://<path-to-file>/synchrony-log4j.properties

    Replace <path-to-file> with your file path. In Linux this will be something like =file:///var/confluence/local-home/synchrony-log4j.properties, for example.

  5. In Confluence, go to  > General Configuration > Collaborative editing and select Restart Synchrony to pick up the changes.

Exclude the Confluence DEBUG prefix

Because Synchrony is managed by Confluence, the Synchrony logs include a prefix with information from Confluence itself.  You can omit this prefix to make the logs easier to read.

To omit the Confluence DEBUG prefix from the Synchrony logs:

  1. <install-directory>/confluence/WEB-INF/classes/log4j.properties ファイルを編集します。
  2. Change the log4j.appender.synchronylog.layout.ConversionPattern line to remove %d %p [%t] [%c{4}]  as follows:

    log4j.appender.synchronylog.layout.ConversionPattern=%m%n
  3. Save the file, then restart Confluence to pick up the changes.

If you're running Confluence in a cluster, you'll need to repeat this process on each Confluence node. 

Change the logging level for Synchrony standalone

If you choose to deploy and manage Synchrony standalone in a cluster, you can configure the logging level in your start-synchrony script. 

To change the Synchrony standalone logging level: 

  1. Create a file called synchrony-log4j.properties  with the following content:

    log4j.rootLogger=WARN, stdout
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.Target=System.out
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%d %p [%t] [%c{4}] %m%n
    log4j.category.com.hazelcast=INFO
    log4j.category.hazelcast=INFO

    In this example we want to set the logging level to WARN . Replace this with ERROR  if you only want to log errors.  We keep the Hazelcast logging level at INFO so you can still see the Synchrony nodes communicating with each other.

  2. Save the file. You can place the file anywhere, but we recommend your Synchrony directory. 
  3. Edit your <synchrony-directory>/start-synchrony.sh or start-synchrony.bat file.
  4. Add the following line in the Optional Overrides section to tell Synchrony where to find your log config:

    log4j.configuration=file://<path-to-file>/synchrony-log4j.properties
  5. Restart Synchrony to pick up the changes. 

Repeat this process on each Synchrony node. 

トラブルシューティング

  • Data Center ライセンスを持っており、Confluence で Synchrony を管理している場合、synchrony-args.properties ファイルを共有ホーム ディレクトリに保存し、すべての Synchrony プロセスが同じ JVM 引数で開始されるようにします。synchrony-args.properties ファイルをローカル ホームに保存すると、引数はそのノード上の Synchrony プロセスにのみ渡されます。  
最終更新日 2020 年 8 月 12 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.