Konradodocs

Update the Konrado plugin

Update the Konrado plugin on your servers from the console, or with one command.

When a new version of the Konrado plugin is out, the server's row on the Integrations page shows Update to v… under its type, and the row menu (three dots) offers Update plugin. An update usually takes 1 to 2 minutes. Agents cannot use a server while it updates.

Before you start

  • A server connected with the Konrado plugin.
  • For an update from the console: the server is Connected, and you answered Yes to the upgrade question when you installed the plugin.
  • For an update by hand: root SSH access to the server.

Update one server from the console

Open the update

Open Workspace SettingsIntegrations and click Update to v… on the server's row, or Update plugin in its row menu.

Run it

The window offers two ways: Command Line Upgrade, with the command to run yourself, and Automatic Upgrade. Click Run Automatic Upgrade. Konrado starts the update on the server. The row reads Updating..., then Connected with the new version.

Update every outdated server

When servers are behind, the top of the Integrations page shows Update N servers, with the number. Click it. The window lists each server with its current and new version, and skips any server that is Not working. Confirm with Update N servers. All servers update at the same time.

Update by hand

Log in to the server as root and run:

bash /opt/KonradoAi/scripts/update.sh

The script builds the new version next to the old one and tests it. Only then does it switch over and restart both services. If the test or the restart fails, it keeps or brings back the previous version and stops with an error. It ends with [update] success. Only one update runs at a time.

Check it works

On the server, both services run:

systemctl status konrado-server konrado-root

Each shows Active: active (running). In the console, the row reads Connected with the new version.

If something is wrong

What you seeWhat to do
Panel upgrades are disabledYou answered No to the upgrade question at install. Update by hand
Konrado panel is outdated (< 0.4.4)The console cannot update a version older than 0.4.4. Update by hand once
[bootstrap] another update is already runningAn update is still running. Wait for it, then check the version
[update] SMOKE TEST FAILED - active services were not restartedThe new version did not pass its test, and the old one keeps running. Read the output above it, fix the cause, run the script again
Not working after the updateWait for the restart, then read the logs: journalctl -u konrado-server -u konrado-root --since "10 minutes ago"
update.sh is missingThe plugin is not installed in /opt/KonradoAi. Install it again from the console

Last updated on

On this page