The Software update page installs a new Airgate version on the appliance that serves the console. Settings, certificates and the database are kept; the services restart for a minute or two. Platform administrators use it to upload a release file, check its signature, install it, and roll back if needed.
Settings › Platform › Software update shows:
| Card |
Shows |
| Installed |
The installed versions, the version kept for rollback, and which updates the appliance accepts. |
| Install an update |
The file picker and upload progress, then the verified update details. Hidden while an update or rollback runs. |
| Running card |
While an update or rollback runs: the current step and the live log. While the services restart, it reads Airgate is restarting… and the page keeps checking every 2 seconds until the console is back. |
| History |
Past updates and rollbacks on this appliance. |
| Last log |
The log of the last operation, after you select Show the last log. |
If the host has no update agent, the page shows Updates are off on this host with the reason and the running version, and nothing else.
| Field |
Meaning |
| Appliance version |
The version installed on the appliance. |
| Console build |
The version of the running console service. |
| Previous version |
The version kept for rollback, or none kept. |
| Updates accepted |
Signed by the Airgate release key only, or Unsigned allowed (development) on development builds. |
| Field |
Meaning |
| File |
An airgate-update-<version>.tar file from the release. Only updates signed by Airgate are accepted. |
| Upload progress |
Bytes uploaded out of the file size. The file is sent in 8 MiB chunks; each chunk is retried up to three times. |
| Verified update |
After upload, Airgate checks the signature and contents and shows Airgate <version>, signature verified, the build date and commit, size, whether new container images are included, the installed version and any release notes. |
| This version is already installed: reinstall it |
Shown when the file has the same version as the installed one. Turn it on to allow reinstalling. |
| Column |
Meaning |
| Action |
Update or Rollback. |
| Version |
From version → target version. |
| Result |
done, failed or running. |
| Started |
When the operation started. |
| Details |
The error, if the operation failed. |
| Action |
What it does |
| Upload |
Uploads the chosen file, then verifies its signature and contents. If the file cannot be installed, the reason is shown with Choose another file. |
Install <version> |
After confirmation, installs the update. Airgate restarts its services: for a minute or two the console is unavailable and RADIUS and TACACS+ sign-ins pause. Settings and data stay, and the current version is kept for a rollback. |
| Cancel |
Discards the uploaded file. |
| Roll back |
After confirmation, restarts Airgate on the previous version. Database changes made by the newer version are not undone; if the newer version changed the database layout, the older version may not start. |
| Show the last log |
Loads the log of the last update or rollback. |
- View:
platform:admin: Platform Administrator only.
- Change:
platform:admin: Platform Administrator only.