Standard upgrade guide

Upgrade BugSnag On-premise on a high availability cluster.

Upgrading your instance

Before upgrading, ensure you have backups of your current installation. See Backup & Restore guide for more information.

It is not necessary to upgrade notifier libraries used by your applications when upgrading BugSnag On-premise, although sometimes new features will require upgrading notifiers.

For more information about the updates see https://enterprise-updates.bugsnag.com.

Update AWS resources

If you provisioned AWS resources with CloudFormation, you should check you are using the latest CloudFormation template version v1.6.2 before upgrading.

Upgrade Replicated KOTS

1. Check KOTS version

   Port-forward to the admin console:

   kubectl kots admin-console --namespace bugsnag
   

   View the admin console at http://localhost:8800 and check the current version at the bottom of the page.

   Get the version of the KOTS CLI installed on your machine:

   kubectl kots version
   

   If the KOTS admin console and CLI versions match the BugSnag supported version of v1.120.3 skip the remaining steps in this section.

2. Update KOTS CLI

   Update the KOTS CLI version on the machine you use to manage your cluster to the supported version:

   curl -sSL https://kots.io/install/1.120.3 | bash
   

3. Upgrade KOTS admin console

   Upgrade the KOTS admin console in your cluster to the same version as the KOTS CLI:

   kubectl kots admin-console upgrade --namespace bugsnag
   

Upgrade BugSnag

1. Access the Replicated KOTS admin console

   Port-forward to the admin console:

   kubectl kots admin-console --namespace bugsnag
   

   View the admin console at http://localhost:8800.

2. Fetch new version of BugSnag

   Press the ‘Check for update’ button to download the latest version of BugSnag and add it to the list of available versions.

3. Deploy new version of BugSnag

   Press the ‘Deploy’ button next to the new version to start upgrading your installation.

4. Upgrade complete

   Once the upgrade has completed the admin console will indicate that it is ‘Ready’.