Long Term Support Releases

What is a Tyk Long Term Support (LTS) release

A Tyk LTS release is usually aimed at customers who want predictability and stability. It means that throughout the lifetime of the release, there will be a commitment to update, fix and maintain the elements that are part of the release. Tyk’s LTS releases are scheduled for Q1 release annually.

How do we support LTS releases?

Here’s what you need to know about how we support an LTS release at Tyk:

An LTS release at Tyk is left on production for 3 months in Hypercare - a period immediately after a release where an elevated period of support is available, patches are run based on need and criticality, and single fix patching is done whenever needed. During this period, the release is carefully monitored and anything that needs fixing is fixed then and there to ensure stability.

During the Hypercare period, measures are taken to stabilise the release, and breaking changes are released. All this is done while also aiming for backward compatibility.

After the Hypercare 3 month period, this release is labelled as a recommended release to customers. This is followed by full support for 12 months. This means that the release will be on full support for 15 months.

After 12 months, there is a new LTS release, and the previous version remains in full support for a further 3 months before it moves into extended support.

If you are on an LTS release (RX.0), you can directly put any minor release on top of that( RX.1, RX.2, etc) instead of installing the previous version of the minor release.

LTS release timetable

What Happens To Our Patches When We Release A LTS Release?

Our procedure for handling patches during LTS release is straightforward. Upon release of a new long-term support version (usually in March), we allow it some time to settle (until the end of May), and then make it our recommended release.

Therefore, from March to May, we continue to issue patches for both the previous LTS branch and the new one. In June, we only provide patches for the new LTS, while the previous one enters extended support which only covers critical fixes.

Here’s an illustration:

Our current LTS release is version 4, and our new LTS release 5 is expected in March.

During April and May, we will release these patches:

• For version 4 LTS - versions 4.0.13 and 4.0.14
• For the new version 5 - versions 5.0.1 and 5.0.2

In June, version 5 becomes the recommended version; we will release the next major version of release 5 (5.1) and a patch for the new LTS (5.0.3).

At this point, release 4 LTS will enter into extended support which only covers critical fixes.

Enterprise Portal

We strive to avoid any long term support arrangements for our enterprise portal. We run a regular 6 week release cadence which delivers new capability, extension of existing capability, and bug fix. Our policy is that we aim to avoid any breaking changes, so in effect the entire enterprise portal is supported. Here we’d increment our version as a minor version - 1.3.0, 1.4.0, 1.5.0 etc.

Occasionally, we may see a need to issue a critical fix if there is a systems down or a critical security defect. Here we would release this as soon as is physically possible, and the semantic versioning would reflect a patch (1.3.1, 1.4.1 etc).

The only exception to this policy is if we ever need to release a breaking change. This would mean that we have to release a new major version (i.e. releasing version 2.0). In this exceptional circumstance we would support both the old major version and the new one concurrently for six months - please note that the old version only gets supported in terms of critical fixes, not new functionality. After the six months is up, the previous major version falls out of support.

If you are using the Enterprise Portal on Tyk Cloud, we recommend you use the latest version at all times. When a new release is launched, older versions are immediately deprecated. This gives you the best, latest and most secure capability. If a customer wants to use a previous version, we won’t enforce an upgrade unless there are operational or security reasons to do so. However, if an issue arises on an older version, we wouldn’t patch that version; we’d advise you to upgrade to latest version.

Other Components

Minor updates to Tyk Pump, Tyk Identity Broker (TIB), MDCB, and Operator are deployable quickly with low risk and no breaking changes, Tyk will support the latest major.minor version (e.g. Pump 1.7) until the next major.minor version (1.8) is released. Then we’d support that version.

To help assure backward compatibility we ensure that each version of Pump and other components we release works with the gateway and dashboard versions which are under LTS (long-term support) at that time. For example, we’d ensure Pump v1.7 is compatible with release v4 of Tyk gateway and Tyk Dashboard, and this increments with the LTS model.

Following semver convention, if we need to patch a minor Pump version , we would number that as a patch version (e.g. 1.7.1).

What is Hypercare?

Hypercare is a period immediately after a release where an elevated period of support is available. We run patches based on need and criticality, and single fix patching can be done if the severity and impact of a bug denotes that a fix is critical.

What Is Extended Support?

In the extended support period Tyk will continue to patch any production critical patches and security issues, we will not add new features to the platform during this period.

How do we support minor releases?

We only patch minor releases (4.1. 4.2, 4.3, etc) until the next minor is out.

Example for release 4

• Tyk’s next LTS patch release will be 4.0.3, and a minor release (4.1) will have all of the 4.0.3 patches
• The following LTS patch release will be 4.0.4 and the minor release 4.1 will be patched, becoming 4.1.1
• The following LTS patch will be 4.0.5 and the minor release 4.1.1 will be patched, becoming 4.1.2
• The following LTS patch will be 4.0.6 and a new minor release (4.2) will have all of the 4.0.6 patches
• At this point we stop supporting minor release 4.1 and only patch 4.2
• This schedule is repeated until the next LTS release