Unable to enable Confluence Edge Index plugin and/or Usage Stats plugins after an upgrade
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Symptoms
When you try to enable the usage stat app in UPM you get an error similar to the below one in the atlassian-confluence.log:
There was an error loading the descriptor 'Usage Index Manager' of plugin 'com.atlassian.confluence.ext.usage'. Disabling.
-- referer: http://mymachine.com:8094/confluence/plugins/servlet/upm/manage/system | url: /confluence/rest/plugins/1.0/com.atlassian.confluence.ext.usage-key | userName: username
com.atlassian.bonnie.LuceneException: Failed to create searcher for directory: org.apache.lucene.store.SimpleFSDirectory@/home/confluenceconfluence-home/index/plugin/usage lockFactory=org.apache.lucene.store.SimpleFSLockFactory@1f3e82c
.
.
.
Caused by: java.io.FileNotFoundException: /home/confluence/confluence-home/index/plugin/usage/segments_1ix1m (No such file or directory)
Cause
During the upgrade process, some files inside <confluence-home>/index/plugin and/or <confluence-home>/index/edge were corrupted resulting in search plugins not enabling.
Resolution
Following the steps in How to Rebuild the Content Indexes From Scratch on Confluence Server, do not replace the backups made in step two or three depending on the plugin you are having problems with enabling. After the rebuild you will be able to enable those plugins, however your Usage and/or Edge data will be lost. Below are the detailed steps:
- Shut down your Confluence server.
Backup <confluence-home>/index/plugin - this is where the Usage Tracking Plugin stores the usage statistics.
Backup <confluence-home>/index/edge - this is where the index of Likes and Popular Content are stored.
- Remove the
<confluence-home>/indexdirectory. - Create
<confluence-home>/index, - Check which plugin you are unable to enable. If it's Usage stats only, copy the backup made in step 3 into the newly created index folder. If it's an edge plugin only, do this action to the backup made in step 2. Lastly, if they are both, DO NOT copy back any of those.
- Restart Confluence.