Upgrading the Console package

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
  • To upgrade to the latest Console version:
    • Run yum update capsule8-console-systemd
  • To upgrade to a specific Console version:
    • Run yum update capsule8-console-systemd-4.7.0

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
  • To upgrade to the latest Console version:
    • Run apt install --upgrade capsule8-console-systemd
  • To upgrade to a specific Console version:
    • Run apt install --upgrade capsule8-console-systemd=4.7.0