Confluence Data Center won't start due to no matching network interface found

要約

On Data Center, Confluence or Confluence managed Synchrony are unable to start. Hazelcast errors out because the specified network interface is incorrect.


Error log details

The following error appears in atlassian-confluence.log or atlassian-synchrony.log:

java.lang.RuntimeException: Hazelcast CANNOT start on this node. No matching network interface found. 
Interface matching must be either disabled or updated in the hazelcast.xml config file.
at com.hazelcast.instance.DefaultAddressPicker.pickAddress(DefaultAddressPicker.java:180)
atlassian-confluence.log
ERROR: Confluence is not able to find network interface named <interface_name>. Please fix the network interface name in the confluence.cfg.xml file and restart Confluence
atlassian-confluence.log
ERROR Enabling Hazelcast interfaces config. Please ensure that custom Hazelcast network settings are up to date

原因

An incorrect value is specified for the network interface property within <confluence-home-folder>/confluence.cfg.xml:

    <property name="confluence.cluster.interface">wlan0</property>

ソリューション

If the issue affects the startup of the DC cluster, then follow the below steps.

DC Cluster node

  1. Download list-interfaces.jar from CONFSERVER-10979 - List confluence cluster interface onto your Confluence node
  2. 次のコマンドを実行します。

    java -jar list-interfaces.jar
  3. Identify the interface name for that node that matches to the Confluence node IP address, in this example it is en0 that matches 192.168.0.1 (my sample Confluence Node IP):

    % java -jar list-interfaces.jar 
    interfaces.size() = 2
    networkInterface[0] = name:en0 (en0)
                       ([/fe80:0:0:0:105a:1ff1:8033:4968%en0/64 [null], /192.168.0.1/24 [/192.0.0.255]])
    networkInterface[1] = name:lo0 (lo0)
                       ([/fe80:0:0:0:0:0:0:1%lo0/64 [null], /0:0:0:0:0:0:0:1/128 [null], /169.254.169.254/8 [null], /127.0.0.1/8 [null]])
  4. Shutdown Confluence node
  5. Modify the following interface line in <confluence-home-folder>/confluence.cfg.xml to match what was returned by the list-interfaces.jar command:

      <property name="confluence.cluster.interface">en0</property>
  6. Start the Confluence node
  7. Once the node has fully started, repeat the above steps on the remaining Confluence DC nodes

ノードによって異なるインターフェイス名が設定されている可能性があります。各ノードでコマンドの出力を確認し、適切な名前を設定するようにしてください。


Last modified on Mar 26, 2025

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

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