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.