Please read our guide for upgrading older versions of Octopus before continuing.
This guide will walk you through the steps to upgrade from Octopus 2.6.5 to 2018.10 LTS. This is the only supported upgrade path from Octopus 2.x and requires careful attention to detail. That being said, the vast majority of our customers have already upgraded using this battle hardened guide, so it should be a smooth experience if plan your upgrade and follow the steps carefully.
Planning your upgrade
There are two main parts to the upgrade:
- Install the Octopus Server and migrate your data - we changed our data persistence to use Microsoft SQL Server so we need to migrate the data from your existing Octopus Server to the new database.
- Upgrade all your Tentacles - we changed the communications protocol significantly, but we’ve provided an easy way for you to upgrade all your Tentacles using your existing Octopus Server. See below.
We recommend choosing from two different approaches for upgrading from Octopus 2.6.5:
- Create a new Octopus Server and migrate to it. We recommend this approach.
- Install over the top of your existing Octopus Server.
Approach 1: Install the new version of Octopus on a new server, and migrate to it (recommended)
If you are able to provision a new Octopus Server, this is the safest option. That way, if something goes wrong in the upgrade, it will be easy to discard the new server and start the process again. And when it works, you can decommission the old Octopus Server.
Read the full guide: Upgrade with a new Server instance
Approach 2: In-place (Over the Top) upgrade of an existing server
It is possible to install newer versions of Octopus over the top of a Octopus 2.6 instance. You’ll upgrade the Tentacles, then upgrade the Octopus Server.
Read the full guide: In place (over the top) upgrade
Upgrading your existing Tentacles
We have significantly change the communications protocol used by Tentacle. This means your 2.6 Tentacles won’t be able to communicate to your new Octopus Server. Likewise, new Tentacles won’t be able to communicate with your old Octopus Server. Once you upgrade, going back can be difficult. Please take time to plan your upgrade carefully using this guide.
Small number of Tentacles
“I have an Octopus Server and a handful of Tentacles. I don’t mind manually running the new Tentacle MSI’s on each of my Tentacle machines.”
If you only have a small number of Tentacles, it’s easiest to just download the new Octopus and Tentacle MSI’s and install them manually.
Read the full guide: Manual upgrades for smaller instances
Lots of Tentacles
“I have lots of Tentacles; there’s no way I’m manually updating them all!”
Don’t worry, we’ve got you covered! We build a tool called Hydra to help you upgrade all your Tentacles during the upgrade process.
Please pay careful attention to the instructions in these guides; if you skip ahead and do the upgrade in the wrong order, you might be stuck upgrading all Tentacles manually!
Help us continuously improve
Please let us know if you have any feedback about this page.
Page updated on Sunday, January 1, 2023