Uploaded image for project: 'Confluence Server'
  1. Confluence Server
  2. CONFSERVER-52749

Cannot start Confluence due to corrupt plugin cache

    XMLWordPrintable

    Details

      Description

      Problem Definition

      Often, on startup, especially on an upgrade, the plugin cache can become corrupted with invalid Add-Ons. This often causes issues for customers and support tickets.

      Please note the similar bug

      In atlassian-confluence.log we can see errors like

      2017-08-24 22:38:17,847 ERROR [FelixDispatchQueue] [osgi.container.felix.FelixOsgiContainerManager] frameworkEvent Framework error in bundle org.randombits.support.core
      org.osgi.framework.BundleException: Unresolved constraint in bundle org.randombits.support.core [270]: Unable to resolve 270.0: missing requirement [270.0]

      Error like these may also appear

      2017-07-30 09:45:48,035 ERROR [localhost-startStop-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'com.atlassian.confluence.extra.bobswift-graphviz'
      2017-07-30 09:45:48,552 ERROR [localhost-startStop-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'com.gliffy.plugin.confluence.gliffy-confluence-plugin'
      2017-07-30 09:45:48,648 ERROR [localhost-startStop-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'net.customware.confluence.plugin.redirection'
      2017-07-30 09:45:48,650 ERROR [localhost-startStop-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'org.randombits.storage.confluence'
      2017-07-30 09:45:48,652 ERROR [localhost-startStop-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'org.randombits.support.confluence'
      2017-07-30 09:45:48,653 ERROR [localhost-startStop-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'org.randombits.support.core'
      

      Suggested Solution

      The directories

      • <confluence.home>/bundled-plugins/
      • <confluence.home>/plugins-cache/
      • <confluence.home>/plugins-osgi-cache/
      • <confluence.home>/plugins-temp/
      • <confluence.home>/bundled-plugins_language/

      should be completely deleted on restart.

      Why this is important

      For support we often have to ask customers to do this when we see OSGI version errors, or other side effects after start up causing instability.

      For example

      • there may be a left over jar file from a removed Add-On still in the plugin directory that Confluence tries to load
      • On upgrade from Java 7 to Java 8 the jar files need to be completely rebuilt

      Support will usually point customers to one of these documents

      This is a related bug, where an Add-On is invalid on upgrade and needs to be removed from the database and disk

      Workaround (the traditional approach)

      1. Shut down Confluence
      2. Delete the all the files and folders in (may need adjusting for your environment)
        • <confluence.home>/bundled-plugins
        • <confluence.home>/plugins-cache
        • <confluence.home>/plugins-osgi-cache
        • <confluence.home>/plugins-temp
        • <confluence.home>/bundled-plugins_language (might not exist)
      3. Restart Confluence

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              nhdang Nhan Dang
              Reporter:
              jrichards@atlassian.com James Richards
              Votes:
              1 Vote for this issue
              Watchers:
              11 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: