Before you upgrade
- Capsule8 attempts to avoid breaking changes but occasionally they are necessary, e.g. for security fixes. To avoid downtime, please be aware of any required changes and known limitations for the version you are upgrading to. This information is found in our Release Notes. Please review all releases between your current version and the new version. When necessary, the Release Notes will call out specific configuration changes that are required for that version and later versions. They may also call out behavior changes that could affect your decision to upgrade.
- Users with more than 100,000 stored alerts or more than 1000 resources may experience a delay on the first startup after upgrading, as the Console processes its database. In extreme cases this may take hours.
- Upgrading the console requires exactly one running Console instance. If you are running a load balanced configuration, scale it down to a single instance before proceeding.
- Optionally, make a backup of your Console configuration file
/etc/capsule8/capsule8-console.yaml
. - Follow the appropriate instructions below, depending on your system package manager type:
Upgrading
For rpm
package installs:
-
- Make any required changes (as per release notes) to your Console configuration file
/etc/capsule8/capsule8-console.yaml
. - If upgrading to version 4.6.2 or earlier:
- uninstall the Console with
yum remove capsule8-console-systemd
- install the version you want with e.g.
yum install capsule8-console-systemd-4.6.2
- uninstall the Console with
- To upgrade to the latest Console version:
- Run
yum update capsule8-console-systemd
- Run
- To upgrade to a specific Console version:
- Run
yum update capsule8-console-systemd-4.10.0
- Run
- Make any required changes (as per release notes) to your Console configuration file
For debian package installs:
-
- Make any required changes (as per release notes) to your Console configuration file
/etc/capsule8/capsule8-console.yaml
. - If upgrading to version 4.6.2 or earlier:
- uninstall the Console with
apt remove capsule8-console-systemd
- install the version you want with e.g.
apt install capsule8-console-systemd=4.6.2
- uninstall the Console with
- To upgrade to the latest Console version:
- Run
apt install --upgrade capsule8-console-systemd
- Run
- To upgrade to a specific Console version:
- Run
apt install --upgrade capsule8-console-systemd=4.10.0
- Run
- Make any required changes (as per release notes) to your Console configuration file
Comments
0 comments
Please sign in to leave a comment.