2020-09-14 17:18:08 +00:00
|
|
|
---
|
|
|
|
|
layout: docs
|
|
|
|
|
page_title: Upgrade Instructions
|
|
|
|
|
description: >-
|
|
|
|
|
Specific versions of Consul may have additional information about the upgrade
|
|
|
|
|
process beyond the standard flow.
|
|
|
|
|
---
|
|
|
|
|
|
2024-02-26 20:27:59 +00:00
|
|
|
# Upgrade instructions
|
2020-09-14 17:18:08 +00:00
|
|
|
|
2020-09-18 20:18:46 +00:00
|
|
|
This document is intended to help users who find themselves many versions behind to upgrade safely.
|
2022-07-01 12:47:24 +00:00
|
|
|
|
2024-02-26 20:27:59 +00:00
|
|
|
## General upgrade path
|
2023-04-07 20:47:15 +00:00
|
|
|
|
2024-02-26 20:27:59 +00:00
|
|
|
If you are not running a Consul Enterprise
|
|
|
|
|
[Long Term Support](/consul/docs/enterprise/long-term-support)
|
|
|
|
|
release, each upgrade should jump at most 2 major versions, except where
|
2023-04-07 20:47:15 +00:00
|
|
|
[dedicated instructions](#dedicated-instructions-for-specific-upgrade-paths)
|
|
|
|
|
are provided for a larger jump between specific versions.
|
|
|
|
|
If your upgrade path has no applicable [dedicated instructions](#dedicated-instructions-for-specific-upgrade-paths),
|
|
|
|
|
review the [version-specific upgrade details](/consul/docs/upgrading/upgrade-specific)
|
|
|
|
|
to plan your upgrade, starting from the next version and working
|
|
|
|
|
upwards to your target version.
|
|
|
|
|
|
|
|
|
|
For example, to upgrade from Consul 1.12 to Consul 1.15:
|
|
|
|
|
|
|
|
|
|
1. Upgrade to Consul 1.14 as an intermediate step.
|
|
|
|
|
To plan, review the upgrade details for
|
|
|
|
|
[1.13](/consul/docs/upgrading/upgrade-specific#consul-1-13-x) and
|
|
|
|
|
[1.14](/consul/docs/upgrading/upgrade-specific#consul-1-14-x).
|
|
|
|
|
1. Upgrade to Consul 1.15.
|
|
|
|
|
To plan, review the upgrade details for
|
|
|
|
|
[1.15](/consul/docs/upgrading/upgrade-specific#consul-1-15-x).
|
|
|
|
|
|
2024-02-26 20:27:59 +00:00
|
|
|
## Long Term Support releases
|
|
|
|
|
|
|
|
|
|
Consul Enterprise [Long Term Support (LTS)](/consul/docs/enterprise/long-term-support)
|
|
|
|
|
releases allow jumping at most 3 major versions by upgrading from one LTS release to the next.
|
|
|
|
|
Review the [version-specific upgrade details](/consul/docs/upgrading/upgrade-specific)
|
|
|
|
|
to plan your upgrade, starting from the next major version and working upwards to your target version.
|
|
|
|
|
|
|
|
|
|
## Dedicated instructions for specific upgrade paths
|
2023-04-07 20:47:15 +00:00
|
|
|
|
|
|
|
|
The following table provides links to dedicated instructions
|
|
|
|
|
for directly upgrading from a version in the starting range
|
|
|
|
|
to a destination version.
|
|
|
|
|
|
|
|
|
|
| Starting Version Range | Destination Version | Upgrade Instructions |
|
|
|
|
|
| ---------------------- | ------------------- | -------------------- |
|
|
|
|
|
| 1.8.0 - 1.9.17 | 1.10.12 | Refer to [upgrading to latest 1.10.x](/consul/docs/upgrading/instructions/upgrade-to-1-10-x) |
|
|
|
|
|
| 1.6.9 - 1.8.18 | 1.8.19 | Refer to [upgrading to latest 1.8.x](/consul/docs/upgrading/instructions/upgrade-to-1-8-x) |
|
|
|
|
|
| 1.2.4 - 1.6.9 | 1.6.10 | Refer to [upgrading to latest 1.6.x](/consul/docs/upgrading/instructions/upgrade-to-1-6-x) |
|
|
|
|
|
| 0.8.5 - 1.2.3 | 1.2.4 | Refer to [upgrading to latest 1.2.x](/consul/docs/upgrading/instructions/upgrade-to-1-2-x) |
|
|
|
|
|
|
|
|
|
|
For example, to upgrade from Consul 1.3.1 to latest 1.12:
|
|
|
|
|
1. Upgrade to Consul 1.6.10 using the dedicated instructions.
|
|
|
|
|
1. Upgrade to Consul 1.8.19 using the dedicated instructions.
|
|
|
|
|
1. Upgrade to Consul 1.10.12 using the dedicated instructions.
|
|
|
|
|
1. Upgrade to latest Consul 1.12.x after consulting the
|
|
|
|
|
[version-specific upgrade details](/consul/docs/upgrading/upgrade-specific)
|
|
|
|
|
for 1.11 and 1.12.
|
