Deprecation of Ubuntu 20.04

Support for Ubuntu 20.04 will stop after December 2025. This means no more updates for signatures and other components will be released for Ubuntu 20.04.

See Migrating to a newer Ubuntu version for more information and help with migrating.

Updating the environment

Keep an eye on our changelog to see any actions that might need to be taken after updating packages.

In order to update the environment, just the following commands will do:

apt update
apt dist-upgrade

# See documentation on Hatching Triage, Hatching Sandbox, and
# Hatching Frontend for the appropriate parameters.
systemctl restart ...

Rather than updating all systemwide packages, one can run the hatching-update tool:

hatching-update

Updating tool

We provide a package that contains a package updating tool: hatching-update. This package can be installed by running:

apt install hatching-onprem-ops

Running the hatching-update tool results in all installed Hatching packages to be upgraded if an upgrade is available. It will not ask for confirmation.

The updated packages will still require additional steps such as service restarts as described below.

Updating processing.deb

Processing contains the signatures and other detections. New versions of this package are released approximately every week.

apt update
apt install hatching-triage-processing

# Have triage reload the new signatures etc.
killall -HUP triage

Updating triage.deb

apt update
apt install hatching-triage

# Safely stop Triage (optional, but recommended)
pidof triage | xargs kill -s TERM 2>/dev/null && while $(pidof triage >/dev/null); do echo "Waiting for exit.." && sleep 2; done

# Restart triage.
systemctl restart hatching-triage

Updating frontend.deb

apt update
apt install hatching-frontend

# Restart frontend.
systemctl restart triage-frontend

Updating sandbox.deb

apt update
apt install hatching-sandbox

# Safely stop sandbox and wait for tasks to complete (optional, but recommended)
pidof sandbox | xargs kill -s INT 2>/dev/null && while $(pidof sandbox >/dev/null); do echo "Waiting for exit.." && sleep 2; done

# Restart sandbox-net and sandbox
systemctl restart hatching-sandbox-net
systemctl restart hatching-sandbox

Updating hatchvm.deb

apt update
apt install hatching-hatchvm

systemctl restart hatching-vms

Updating sandbox-node.deb or sandbox-allos-node.deb

These are metapackages. They exist to simplify installs and version management. This package ensures the install of the sandbox, hatchvm and correct qemu packages and dependencies for all of these.

To update:

apt update
apt install hatching-sandbox-node
# Or
apt install hatching-sandbox-allos-node

After updating:

systemctl restart hatching-sandbox-net
systemctl restart hatching-sandbox
systemctl restart hatching-vms