Update from version 3.11 to 3.14

It is recommended to update from a new installation of the operating system (Ubuntu Server 18.04.x LTS 64bit) and new disk space layout. 

This section describes the process of updating the operating system and ECSS-10 software components, when for some reason a new installation is not possible.

Preparing to update the system

Update the system to the latest versions:

...

sudo apt remove ecss-*-3.11
sudo apt autoremove
sudo apt upgrade

OS upgrade

Version 3.14 is installed on Ubuntu 18.04, and 3.11 is installed on Ubuntu 16.04. It means that OS on the server should be updated before installing a new version of ECSS-10. As soon as old ECSS-10 packages are removed, you can start upgrading the server:

...

After the upgrade is complete, the server needs to be restarted.

ECSS-10 version 3.14 installation

For more information, see ECSS packages installation.

...

sudo sh -c "echo 'deb [arch=amd64] http://archive.eltex.org/ssw/bionic/3.14 stable main extras external' > /etc/apt/sources.list.d/eltex-ecss10-stable.list"
sudo apt update

ecss-mysql installation

First, install ecss-mysql package, during which the databases will be migrated to the new version:

...

sudo systemctl restart apparmor.service
mysql -uroot -p<root_mysql_password> -e 'DROP DATABASE <problematic database>'
sudo apt install ecss-mysql

Configuring ecss-dns-env package

Before installing ecss-mysql package, you will be prompted to configure environment variables for services in dnsmasq. The customizer will prompt you to select the sections to configure. If the system is in a cluster, choose broker and mysql. The address of secondary broker is IP ecss2, mysql address is a "floating" address registered in keepalived.

If the system is not in a cluster, there is no need to select anything.

ecss-node installation

Install the ecss-node package:

...

SSL certificates are generated during package installation. You can leave the answers to the questions that are offered, including empty ones. For more information, see Operating system installation.

Installing the remaining packages

Install packages containing the main subsystems:

...

List of available additional packages:

...

cluster/storage/ds1/ss/update *

Updating the second server if the system is in a cluster

To transfer traffic to the updated server, stop keepalived service on the second server:

...

Further update is similar to the description given above, taking into account the MSR settings for this host.

Building a cluster

After installing ecss-3.14 packages, ecss services should be stopped at this stage:

...

sasha@ecss1:~$ sudo systemctl restart dnsmasq.service 
sasha@ecss1:~$ 
sasha@ecss1:~$ sudo systemctl status dnsmasq.service 
● dnsmasq.service - dnsmasq - A lightweight DHCP and caching DNS server
   Loaded: loaded (/lib/systemd/system/dnsmasq.service; enabled; vendor preset: enabled)
   Active: active (running) since Tue 2021-03-30 15:06:53 +07; 31s ago
  Process: 19252 ExecStop=/etc/init.d/dnsmasq systemd-stop-resolvconf (code=exited, status=0/SUCCESS)
  Process: 19344 ExecStartPost=/etc/init.d/dnsmasq systemd-start-resolvconf (code=exited, status=0/SUCCESS)
  Process: 19325 ExecStart=/etc/init.d/dnsmasq systemd-exec (code=exited, status=0/SUCCESS)
  Process: 19304 ExecStartPre=/usr/sbin/dnsmasq --test (code=exited, status=0/SUCCESS)
 Main PID: 19341 (dnsmasq)
    Tasks: 1 (limit: 4616)
   CGroup: /system.slice/dnsmasq.service
           └─19341 /usr/sbin/dnsmasq -x /run/dnsmasq/dnsmasq.pid -u dnsmasq -r /run/dnsmasq/resolv.conf -7 /etc/dnsmasq.d,.dpkg-dist,.dpkg-old,.dpkg-new --local-service --trust-anchor=.,19036,8,2,49aac11d7b

мар 30 15:06:53 ecss1 systemd[1]: Starting dnsmasq - A lightweight DHCP and caching DNS server...
мар 30 15:06:53 ecss1 dnsmasq[19304]: dnsmasq: syntax check OK.
мар 30 15:06:53 ecss1 systemd[1]: Started dnsmasq - A lightweight DHCP and caching DNS server.

Starting the cluster

Run ecss services on the second host:

...

sasha@ecss1:~/ecss1_3.14$ sudo ecss-control attach
unlock ip: 10.10.0.2, rules: 7
complete
sasha@ecss1:~/ecss1_3.14$ sudo ecss-control status
all nodes attached

Checking operation of the system in the cluster

Check the update progress. system-status CLI command should show that all nodes in the cluster and subsystem versions are the same.

...

journalctl -f

Uninstalling ECSS components

Removing ecss-mysql

To remove ecss-mysql package while preserving the databases, you can use the command:

...

sudo apt purge mysql-*

Removing ecss-node package

To delete a package, use the command:

sudo apt purge ecss-node

Removing ecss-media-server package

To remove the package while saving the configuration files, use the command:

...

sudo apt purge ecss-media-server 

Removing unnecessary packages

To remove the remaining packages that are no longer required, use the autoremove key:

sudo apt autoremove

Removing packages by mask

To remove several packages at once, you can use masks (see man apt).

...

sudo apt purge ecss-*

ECSS full uninstall commands

To completely remove all ECSS components, run 3 commands:

...

Debconf

In some cases, instead of reinstalling the package, only a configuration change is required. In this case, use the dpkg-reconfigure <package name> command. Also, if necessary, you can use the commands of the debconf-utils package.

...