This document describes the procedure for upgrading to the latest version of Confluence on Windows or Linux manually (not using the upgrade wizard).  See Upgrading Confluence to upgrade using the installer and upgrade wizard. 

Step 1 Determine your upgrade path and method

There are several factors that will determine the upgrade method you should use. If you:

• Are moving to a different database you should upgrade first and then follow the procedure outlined in Migrating to Another Database.
• Are running Confluence in a cluster you should follow the procedure outlined in Upgrading Confluence Data Center.
• Are using the embedded (trial) database you should migrate to a different database before upgrading. This database is supplied for evaluation purposes only and is not recommended for production environments. See Embedded H2 Database for more information.

Step 2 Upgrade Confluence in a test environment

Step 3 Back up

Step 4 Upgrade Confluence in your production environment

1. Download the appropriate archive file from the Confluence Download Center.
2. Shut down Confluence.
3. Extract (unzip) the files to a directory (this will be your new installation directory, and must be different to your existing installation directory)
   Note: There are some known issues with unzipping the archive on Windows. We recommend using 7Zip or Winzip.

4. Update the following line in the <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties file to point to your existing Confluence home directory.

   # confluence.home=c:/confluence/data

    For example if your existing Confluence home directory is c:\confluence\myhome the file will read:

   confluence.home=c:/confluence/myhome

5. Copy the JDBC driver jar file from your existing Confluence installation directory to  confluence/WEB-INF/lib in your new installation directory. 
   The JDBC driver will be located in either the <Install-Directory>/common/lib or <Installation-Directory>/confluence/WEB-INF/lib directories. 
6. There are some additional steps you make need to take if:
   

   • you are running Confluence as a Windows Service

     If you are running Confluence as a Windows service, go to the command prompt and type:   <Installation-Directory>\bin\service.bat remove Confluence It is vital that you stop and remove the existing service prior to uninstalling the old instance of Confluence. For more information on running Confluence as Windows service, please refer to Start Confluence Automatically on Windows as a Service.  To remove the service installed by the Confluence installer, you'll need to run <confluence auto installer installation folder>\UninstallService.bat.

   • you use a JIRA application or LDAP for user management

     If you use JIRA or LDAP for user management, copy the following files from your existing installation directory to your new installation directory: <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml

   • you use Crowd for user management

     If you are using Crowd for user management, copy the following files from your existing installation directory to your new installation directory: <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml (if you are upgrading from Confluence 2.2 or later). <Installation-Directory>/confluence/WEB-INF/classes/crowd.properties

   • you are upgrading from Confluence 2.5 or earlier

     If you are upgrading from Confluence 2.5.5 or earlier and are copying the existing atlassian-user.xml file from your previous instance, make sure the hibernate cache parameter in this file is enabled, to avoid performance issues.  <hibernate name="Hibernate Repository" key="hibernateRepository" description="Hibernate Repository" cache="true" /> If you use Crowd for your user management, you do not need to do this.

   • You are running Confluence on a different port (not the default 8090)

     If you are not running Confluence on port 8090 update  <Installation-Directory>\conf\server.xml file to include your ports

7. Start your new Confluence. You should not see the setup wizard.  

Additional steps if further customisations are present

If you have customised Confluence (such as an SSL configuration in the server.xml file, or CATALINA_OPTS or JAVA_OPTS parameters in your confluence-init.properties file), you'll need to perform the following steps after the upgrade is complete:

1. Stop the upgraded Confluence instance.
2. Reapply the customisations to the relevant files in the newly upgraded Confluence Installation directory.
3. Restart the upgraded Confluence instance.

We strongly recommend you test your customisations in a test instance prior to upgrading your production instance as changes may have been made to Confluence that make your customisations unsuable.

Troubleshooting

You can also refer to the Upgrade Troubleshooting guide in the Confluence Knowledge Base, or check for answers from the community at Atlassian Answers.