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

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

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

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

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

JVM 引数を Synchrony に渡す

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

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

例:

synchrony.jvm.arg.0=-Dproperty1=value1
synchrony.jvm.arg.1=-Dproperty2=value2
...
synchrony.jvm.arg.N=-XX:NumberOfGCLogFiles=5

その他の例については「 Synchrony プロセスのガベージ コレクション (GC) ロギングを有効化する方法」をご確認ください。

この方法では、Confluence のシステム プロパティ (synchrony.port、Xmx または Xss など) によってすでに処理された値は渡せません。

Synchrony をクラスターにおいてスタンドアロンで実行している場合は、その引数を start-synchrony スクリプトの "Optional Overrides (オプションのオーバーライド)" セクションに追加することで、Synchrony の JVM に引数を直接渡します。

設定変更の一般的な例

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

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

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

Confluence 6.0.3 以前を使用している場合、synchrony.port の代わりに reza.port を使用する必要があります。

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

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

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

クラスタで Confluence を実行している場合は、各ノードの最大ヒープ サイズを 4 GB に増やしてください。 

例については、「Confluence DC で Synchrony のヒープ割り当てを増やす方法」を参照してください。

管理対象の Synchrony のログ レベルを変更する

管理対象の Synchrony のログ レベルは、デフォルトで INFO に設定されています。詳細度が高すぎる場合は、WARN または ERROR にログ レベルを下げることができます。 

管理対象の Synchrony のログ レベルを変更するには、次の手順に従います。 

1. Create a file called synchrony-log4j2.xml with the following content:

   <?xml version="1.0" encoding="UTF-8"?>
   <Configuration status="WARN">
     <Appenders>
       <Console name="stdout" target="SYSTEM_OUT">
         <PatternLayout pattern="%d %p [%t] [%c{4}] %m%n"/>
       </Console>
     </Appenders>
     <Loggers>
       <Root level="WARN">
         <AppenderRef ref="stdout"/>
       </Root>
     </Loggers>
   </Configuration>

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

2. ファイルを保存します。ファイルはどこに置いてもかまいませんが、synchrony-args.properties ファイルと一緒にホーム ディレクトリ (または共有ホーム ディレクトリ) に置くことをおすすめします。 
3. <home-directory>/synchrony-args.properties ファイルを編集します。クラスターで Confluence を実行している場合は、これが共有ホーム ディレクトリになります。 

4. 次の行を追加し、Synchrony にログ設定の場所を伝えます。 

   log4j2.configurationFile=file://<path-to-file>/synchrony-log4j2.xml

   <path-to-file> を、実際のファイル パスと置き換えます。Linux の場合は、たとえば =file:///var/confluence/local-home/synchrony-log4j.properties のような記述になります。

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

Confluence DEBUG プレフィックスを除外する

Synchrony は Confluence で管理されるため、Synchrony のログには Confluence 自体の情報を使用したプレフィックスが含まれています。このプレフィックスを除外することで、ログを読みやすくすることができます。

Synchrony のログから Confluence DEBUG プレフィックスを除外するには、次の手順を実行します。

1. <install-directory>/confluence/WEB-INF/classes/log4j2.xml ファイルを編集します。

2. Find the `synchronylog` appender, and change its `PatternLayout` to remove %d %p [%t]  as follows:

   <ConfluenceHomeRollingFile name="synchronylog" fileName="atlassian-synchrony.log" filePattern="atlassian-synchrony.log.%i">
     ...
     <PatternLayout alwaysWriteExceptions="false" pattern="%enc{%m}{JSON}%n%loggingcontext%stacktrace"/>
   </ConfluenceHomeRollingFile>

3. ファイルを保存してから Confluence を再起動し、変更内容を反映させます。

Confluence をクラスターで実行している場合は、この手順を各 Confluence ノードで実行する必要があります。 

スタンドアロンの Synchrony のログ レベルを変更する

Synchrony をクラスターに単独でデプロイして管理する場合は、ログ レベルを start-synchrony スクリプトで設定することができます。 

スタンドアロンの Synchrony のログ レベルを変更するには、次の手順を実行します。 

1. Create a file called synchrony-log4j2.xml with the following content:

   <?xml version="1.0" encoding="UTF-8"?>
   <Configuration status="WARN">
     <Appenders>
       <Console name="stdout" target="SYSTEM_OUT">
         <PatternLayout pattern="%d %p [%t] [%c{4}] %m%n"/>
       </Console>
     </Appenders>
     <Loggers>
       <Logger name="com.hazelcast" level="INFO"/>
       <Root level="WARN">
         <AppenderRef ref="stdout"/>
       </Root>
     </Loggers>
   </Configuration>

   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. ファイルを保存します。ファイルの置き場所は自由ですが、Synchrony のディレクトリに置くことをおすすめします。 
3. <synchrony-directory>/start-synchrony.sh または start-synchrony.bat ファイルを編集します。

4. Add the following line in the Optional Overrides section to tell Synchrony where to find your log config. Note the -D  prefix:

   1. On Linux, in start-synchrony.sh :

      OPTIONAL_OVERRIDES="-Dlog4j2.configurationFile=file:///<path-to-file>/synchrony-log4j2.xml"

   2. On Windows, in start-synchrony.bat : 

      set OPTIONAL_OVERRIDES=-Dlog4j2.configurationFile=file:///<path-to-file>/synchrony-log4j2.xml

   3. If OPTIONAL_OVERRIDES  already contains other properties, add this property to them, separated by a space.
5. Synchrony を再起動して変更内容を反映します。 

この手順を、各 Synchrony ノードで繰り返します。 

トラブルシューティング

• Data Center ライセンスがあり、Confluence で Synchrony を管理している場合は、synchrony-args.properties ファイルを共有ホーム ディレクトリに保存して、すべての Synchrony プロセスが同じ JVM 引数で開始されるようにします。ローカル ホームに synchrony-args.properties ファイルがあれば、引数はそのノードの Synchrony プロセスにのみ渡されます。
• 7.20 以来、JVM 引数を Synchrony に渡せるようにして、Synchrony 関連の課題の診断に役立つようにしました。「 Synchrony プロセスのガベージ コレクション (GC) ロギングを有効化する方法」をご参照ください。