This page last changed on Apr 09, 2008 by smaddox.

This page is part of the Confluence Upgrade Guide.

Upgrading a Cluster or Changing your Database?

Before you Start

  1. Note that you need current software maintenance to perform the upgrade.
  2. Confirm that your license support period is still valid before you try to upgrade.
  3. If your current license has expired but you have a new license with you, please update your license in Confluence before performing the upgrade.
    If you forget to do this and your license has expired, you will receive errors during the upgrade process. Refer to the instructions on upgrading beyond current license period.
  4. Check the release notes for the new version of Confluence you are installing, plus the release notes for any major versions you are skipping, to see if there are any upgrade instructions specific to the new version(s).
  5. If you are using Confluence EAR-WAR edition, check the Application Server Configuration Guide for your specific application server, to see if there is anything extra you will need to do to get Confluence running. For example:
  6. Note which plugins are installed/enabled on your current Confluence instance. Please verify whether a compatible version of the plugin is available in the version of Confluence you are upgrading to. This information is available on the respective home pages for these plugins on the Confluence Extension space. Once you have confirmed the availability of compatible versions, you should upgrade your plugins after successfully upgrading Confluence. This can be done via the 'Plugin Repository' in your Administration Console. Please test these first by applying them to the latest Confluence version in a test environment.
  7. If you have made any customisations to Confluence, please verify their compatibility in the latest version. For example, if you have modified any layouts or are using your own custom theme, please test these first by applying them to the latest Confluence version in a test environment.

Backing Up

Before you begin the Confluence upgrade, you must back up the following:

  1. Your Confluence Home directory.
  2. Your Confluence Installation directory (if you are using Confluence Standalone) or your Confluence webapp (if you are using Confluence EAR-WAR edition).
  3. If you are not using the embedded database, perform a manual backup of your external database before proceeding with the upgrade.
    The 'embedded database' is the HSQLDB database supplied with Confluence for evaluation purposes.
RELATED TOPICS

Upgrading Confluence

Document generated by Confluence on Apr 10, 2008 20:52