Updating

Keep your panel, your nodes and your clusters up to date.

The panel updates itself from the admin area. Nodes and orchestrators update from a page of their own.

Update the panel

When a new version is out, a banner appears across the top of the admin area. It reads Update Available: vX.Y.Z. For a security release the banner is red and reads Security Update.

1. Click the small arrow next to the banner text to read the list of changes.
2. Click Update Panel.
3. Read the confirmation dialog, then click Update.

The banner then shows Pulling new images... with the progress of the image download. It changes to Restarting panel... while the containers come back. The page reloads on its own when the new version answers.

The whole update usually takes about a minute. The panel is unreachable for part of that time. Your game servers keep running, and the daemons reconnect on their own.

TIP

The X on the banner hides it until the next release. It does not install anything.

If the update does not finish inside 5 minutes, the banner reports a timeout. Refresh the page. The panel is often already back.

Update the daemons and the orchestrators

Go to Admin > Settings > System Updates, or open /admin/system/updates. This page covers the daemons and the orchestrators only. It does not update the panel.

The four cards at the top show the latest released version and how many components are connected. They also show how many components have an update waiting, and how many of each kind you run.

The Components list holds one row per daemon and per orchestrator. Each row shows the name, the connection state, the current version, and the platform. A row with a newer version available reads Update to vX.Y.Z.

To update one component, click Update on its row.

To update several at once:

1. Tick the checkbox on each row that you want.
2. Click Update Selected.

The shortcuts above the list select many rows at once: Select All, Daemons Only, Orchestrators Only, and Clear Selection. Update All starts every waiting update without a selection.

WARNING

Only a connected component with an update available can be selected. An offline daemon has no checkbox and no Update button. Bring it back online first.

An Update Progress panel appears while updates run. It counts the components that are pending, updating, completed, failed, and skipped, and it shows the error text for a failure. Clear removes the finished list.

A daemon restarts to apply its new binary. The game servers on that node keep running. The panel shows the node offline for a few seconds.

Read the release notes

Go to Admin > Settings > System Updates, then click the Changelog tab. The page lists each release with its date and its changes.

The update banner also holds a short list of changes for the release that it offers.

If the In-Panel update fails

You can update from the command line instead. Run the same activation command that you used for the installation:

curl -sSL https://activate.badgerpanel.com/activate/BP-XXXX-XXXX-XXXX-XXXX | bash

The installer finds your existing installation and offers three options. Choose 1) Update. It pulls the latest images and restarts the services. Your data, your servers, and your configuration stay as they are.

WARNING

Never choose 2) Fresh install to update. That option deletes the containers, the volumes, and the installation directory. All data is lost.

Good practice

• Back up first. An update keeps your data, but a database backup before a large update costs little. Read the Migration guide for the backup steps.
• Update when the panel is quiet. The panel is unreachable for part of the update.
• Update the daemons after the panel. Open the System Updates page after each panel update and apply what is waiting.