Upgrade Confluence Server 7.15.2 to 8.6.2

Ahmet Kasım Erbay
2 min readMar 7, 2024

--

As the documentation is not clear for unexperienced engineer, I will share the steps to upgrade Atlassian Confluence 7.15.2 to 8.6.2, which was the final version at that time I have upgraded. They are versioning so fast :)

Note: If you have any update on your licence, please complete it before upgrade.

Pre-Upgrade Checks

In this step, you will take a note of all your User-Installed applications along with vendor and version numbers.

Your applications might be lost during the upgrade.

Also copy your company specific SSL certificates and MySQL Connector 5.47.xx to the server.

Backup

As we will take full backup of the application, we can disable the automatic generation of an upgrade recovery file.

Why is this step important?

In the backup step, after I press the backup button from the UI, I realized that there are two files being created on the server. At first glance, I could not understand the reason but when check the automatic backup section from the scheduled jobs, it was there. Like a shining Kebap! Confluence automated backup job has been triggered at the same time with my backup. A job that would normally take 2 hours maximum, ended on 5 a.m. :( Just close the backup.

This is also recommended by the Atlassian Team as well, here. I guess there will be some further fix in a future version.

Copy your /Atlassian folder to another directory for backup.

Install the Installer

My local computer is windows but I run this command from MobXterm.

Go to this address and download specific version of Confluence

wget https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-8.6.2-x64.exe

After download is complete, send it to the Windows server.

Run the Installer

“Run as Administrator” the installer.

Follow the prompts to upgrade Confluence:

  1. When prompted choose Upgrade an existing Confluence installation
  2. Make sure the Existing Confluence installation directory suggested by the wizard is correct
  3. Disable the Backupo home directory because we have already taken it.
  4. If Installer can not, Stop your Confluence service.

Start the new Confluence

After the installation is complete, you will be prompted to start the Confluence service.

  • Update conf/server.xml
  • Update keystore if necessary!

Copy Database Connector,

  • Under confluence /WEB-INF/lib

Some Errors I Faced

First,

This error is a version specific. In this version, we need more seat to connect the database. You can reach the solution here.

Second,

If there is a network error while connecting to Jira, please follow this paper to add the necessary certificates to the system.

We are done with the upgrade!

Please share your thoughts and do not hesitate to be in contact!

--

--