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

Cannot start Confluence due to corrupt plugin cache

    XMLWordPrintable

    Details

    • Symptom Severity:
      Severity 2 - Major
    • UIS:
      49
    • Support reference count:
      16
    • Epic Link:
    • Sprint:
      Forever Young, Halloween, Jambalaya, Knocking on Heavens Door
    • Occurrence Factor:
      50%
    • QA Demo Status:
      Not Done
    • QA Kickoff Status:
      Not Done

      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
                Participants:
                Last Touched By:
                Katherine Yabut
              • Votes:
                1 Vote for this issue
                Watchers:
                10 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:
                  Last commented:
                  2 years, 6 weeks, 5 days ago