Confluence system plugins that do not support cluster environment


If you are doing the following Confluence migration, you have to be aware of that some system plugins do not support cluster environment.

  • Confluence server to Confluence data center cluster
  • Confluence data centre non-clustered (single node) to Confluence data centre clustered (multiple nodes)

A simple example is the ‘Confluence Usage Stats‘ which provides the macros like popular content, top users…

During my migration from single node to cluster, I noticed that ‘Confluence Usage Stats’ plugin was disabled automatically as Confluence detected it is a cluster environment.

And it did not allow me to enable it either. The error in the log shows:

2020-08-11 11:51:03,946 ERROR [ThreadPoolAsyncTaskExecutor::Thread 46] [plugin.osgi.factory.OsgiPlugin] onPluginContainerFailed Unable to start the plugin container for plugin 'com.atlassian.confluence.ext.usage'

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'unclusteredOnlySpringBean': Invocation of init method failed; nested exception is java.lang.RuntimeException: This plugin cannot be used in a cluster.

Obviously it means the plugin does not support the cluster environment. And actually there is a feature request for that CONFSERVER-52388

So if there are any pages use the macros that are provided by the system plugin, it won’t work after the migration. And it will display as ‘unknow marco: xxx‘. This is the change you have to expect.

More details can be found in Restricted Functions in Confluence Data Center.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s