Sysdig Documentation

On-Premises Upgrades

This section describes how to upgrade an on-premise installation, depending on whether it was installed using a Kubernetes or a Replicated orchestrator.

As needed, version-specific upgrade or migration instructions will be added to this section.

Warning

It is recommended to follow upgrade best practices:

  • Keep upgrades current

  • Test upgrades in a non-mission-critical or staging environment before rolling into production.

Upgrade with the Installer (v. 2.5.0 and above)

As of version 2.5.0, the Sysdig platform on Kubernetes or OpenShift should be upgraded using the Installer tool. See v2.5.0+ Upgrade (Installer: Kubernetes) for details.

Supported Migration Paths

In general, Sysdig tests and supports direct upgrade from five releases back to the current version.

However, in the case of:

  • Required migration tools and/or

  • Significant architecture changes

it is required to apply significant interim releases.

(Significant interim releases shaded green in the tables.)

For Kubernetes Upgrades

Install Version

Incl. Hotfixes

Notes

Baseline Documentation

2.5.0

New Installer tool for upgrading; new documentation site; inline scanning for Secure, other enhancements

v2.5.0+ Upgrade (Installer: Kubernetes)

2.4.1

Report service added; upgrade to Anchore license required

Upgrade v 2.4.1

2.3.0

Ability to secure Elasticsearch and the Cassandra DB with password authentication or SSL/TLS protection.

Expanded Upgrade

Mandatory Install

2435

(2304) (2266) (2172)

Architecture changes to Dashboards

& API pods.

Expanded Upgrade

Note that this replaces 2172, 2266, and 2304.

1929

Basic Upgrade

Mandatory Install

1765

Migration Tool (MySQL Connector)

Architecture & Port 443 change

Migration Tool for Connector +

Expanded Upgrade

1630

(1586)

Basic Upgrade

1511

(1472) (1402)

Basic Upgrade

1245

Basic Upgrade

Mandatory Install

1149

Migration Tool (Unified Events)

v1149+ Migration Tool for Unified Events + Basic Upgrade

1091

Basic Upgrade

Example

To upgrade from v. 1091 > v. 2435, you would:

  • Upgrade to v. 1149, using the Migration Tool for Unified Events and the Basic Upgrade instructions.

  • Then upgrade to v. 1765, using the Migration Tool for Connector and the appropriate Expanded Upgrade instructions.

  • Finally upgrade to v. 2435, using the Basic Upgrade (including the note about Dashboard migration on that page)

For Replicated Upgrades

Most Replicated environments can be upgraded directly to the current version.

Install Version

Incl. Hotfixes

Notes

Documentation

Current

2435

(2304) (2266)(2172)

Architecture changes to Dashboards

and API pods.

Upgrade Replicated (with note)

(Note that this replaces 2172, 2266, and 2304.)

(Can be installed or skipped) 1929, 1765, 1630, (1586), 1511, (1472) (1402), 1245

Mandatory Install

1149

Migration Tool (Unified Events

Migration Tool for Unified Events +

Upgrade Replicated