Upgrading a modern version of Octopus
A modern version of Octopus Deploy is any version running on SQL Server. When Octopus Deploy was originally introduced, it ran on RavenDB. Octopus Deploy 3.x migrated from RavenDB to Microsoft SQL Server. This section contains guides to covering various use cases you might encounter when upgrading a modern version of Octopus Deploy.
Upgrade Scenarios
The default upgrade scenario is an in-place upgrade. Thousands of customers upgrade every month without errors. However, no upgrade process is ever 100% error-free 100% of the time. The typical errors we see are:
- Compatability Errors: Upgrading to a new version isn't supported by a license limitation, host OS version deprecation or SQL Server version deprecation.
- Hyper-specific use cases: Windows runs a specific version of Windows without a random patch of .NET Framework installed.
- Breaking changes introduced in the product: we do our best to minimize these, but they can happen. For example, Octopus Deploy 2019.1.0 introduced spaces and how teams and roles were assigned. Any API scripts manipulating teams had to be updated.
Please choose from one of five common upgrade scenarios:
- Upgrading minor and patch releases
- Upgrading major releases
- Upgrading from Octopus 4.x or 2018.x to latest version
- Upgrading from Octopus 3.x to latest version
- Upgrading host OS or .NET version
Mitigating Risk
The best way to mitigate risk is to automate the upgrade and/or creating a test instance. Automation ensures all steps, including backups, are followed for every upgrade. A test instance allows you to test out upgrades and new features without affecting your main instance.
In this section
The following topics are explained further in this section:
- Upgrading minor and patch releases of Octopus Deploy
- Upgrading major releases of Octopus Deploy
- How to automate Octopus Deploy upgrades
- Upgrading from Octopus 4.x / 2018.x to latest version
- Upgrading from Octopus 3.x to the latest version
- Upgrading host OS or .NET
- Creating a test instance
Need support? We're here to help.