Skip to main content

Ubuntu

Major distributions on which UCS is supported. Ubuntu 24.04 version of Jammy (amd64) is required. To install, follow these steps:

  • Download server version and start the installation. Install only OpenSSH server, in the Featured Server Snaps section do not select any option.

  • Download the INSOFT UCS installation package and install it:

#!/bin/bash

timedatectl set-timezone Europe/Prague
apt install postfix

wget http://repo.insoft.cz/apt/pool/stable/i/insoft-repo-noble/insoft-repo-noble_1.0.0-0~ubuntu-noble_amd64.deb
dpkg -i insoft-repo-noble_1.0.0-0~ubuntu-noble_amd64.deb
apt update
apt install insoft-ucs
warning

unattended-upgrades are enabled in the default installation of Ubuntu. During the update, there is a service outage, according to the updated components.

How to turn off automatic updates:

#!/bin/bash

apt purge unattended-upgrades

# To be sure, when reinstalling it will be necessary to confirm the overwriting of the config
cat /etc/apt/apt.conf.d/20auto-upgrades >/dev/null <<EOF
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "0";
EOF
info

The observability stack (Grafana, Loki, Tempo, Prometheus, OpenTelemetry Collector) is not installed automatically. Install it per host where you want local telemetry collection:

apt install insoft-telemetry

This pulls in all five components and configures them. Grafana then becomes available at https://<server-address>/grafana/ — see Observability for details on access, configuration, and telemetry ingestion.

Operation​

Locking the UCS version​

If regular OS updates are required, but UCS should only be updated on demand, then it is possible to lock the installed version of UCS:

Lock the currently installed version of UCS:

apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'

Unlock to update UCS:

apt-mark unhold 'insoft-*'
apt-mark unhold 'ucs-*'

Check which packages are locked:

apt-mark showhold

# list versions
apt list --installed 'ucs-*' 'insoft-*'

Update examples:

# After the initial UCS installation, the following was entered:
apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'

Updating only system packages​

apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'
apt update
apt upgrade

Updating INSOFT and UCS packages (incl. system packages) and locking them again​

apt-mark unhold 'insoft-*'
apt-mark unhold 'ucs-*'
apt update
apt upgrade
apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'