How to migrate your Auvik Collector from Ubuntu 18.04 to Ubuntu 20.04

Disclaimer: Auvik has provided these instructions for a manual install to Ubuntu version 20.04. This method may work with Ubuntu version 22.04 but has not been approved by Auvik yet. Using a scripted installer may create different steps than those outlined below. Please take this into consideration when attempting this upgrade.

Connect to the OVA running your collector, via SSH or by connecting to the VM server running the OVA and launch a bash shell instance (option 6 in the agent-console menu).

The agent-console menu

1. Ensure the VM is up to date with the latest software versions for installed packages.
  1. Update APT package caches: sudo apt update
    auvik:/# sudo apt update Get:1 http://security.ubuntu.com/ubuntu bionic-security InRelease [88.7 kB] Get:2 http://archive.ubuntu.com/ubuntu bionic InRelease [242 kB] Get:3 http://archive.ubuntu.com/ubuntu bionic-updates InRelease [88.7 kB] Get:4 http://archive.ubuntu.com/ubuntu bionic-backports InRelease [83.3 kB] Get:5 http://security.ubuntu.com/ubuntu bionic-security/restricted amd64 Packages [1259 kB] Get:6 http://security.ubuntu.com/ubuntu bionic-security/main amd64 Packages [3069 kB] Get:7 http://security.ubuntu.com/ubuntu bionic-security/universe amd64 Packages [1563 kB] Get:8 http://security.ubuntu.com/ubuntu bionic-security/multiverse amd64 Packages [22.8 kB] Hit:9 https://apt.my.auvik.com/auvik-bionic/agent/master dev InRelease Get:10 http://archive.ubuntu.com/ubuntu bionic/restricted amd64 Packages [13.5 kB] Get:11 http://archive.ubuntu.com/ubuntu bionic/multiverse amd64 Packages [186 kB] Get:12 http://archive.ubuntu.com/ubuntu bionic/universe amd64 Packages [11.3 MB] Get:13 http://archive.ubuntu.com/ubuntu bionic/main amd64 Packages [1344 kB] Get:14 http://archive.ubuntu.com/ubuntu bionic-updates/multiverse amd64 Packages [29.8 kB] Get:15 http://archive.ubuntu.com/ubuntu bionic-updates/main amd64 Packages [3497 kB] Get:16 http://archive.ubuntu.com/ubuntu bionic-updates/universe amd64 Packages [2338 kB] Get:17 http://archive.ubuntu.com/ubuntu bionic-updates/restricted amd64 Packages [1303 kB] Get:18 http://archive.ubuntu.com/ubuntu bionic-backports/universe amd64 Packages [20.5 kB] Get:19 http://archive.ubuntu.com/ubuntu bionic-backports/main amd64 Packages [64.0 kB] Fetched 26.6 MB in 7s (3648 kB/s) Reading package lists... Done Building dependency tree
    Reading state information... Done 252 packages can be upgraded. Run 'apt list --upgradable' to see them.
  2. Upgrade any packages that are out of date: sudo apt upgrade -yauvik:/# sudo apt upgrade -yReading package lists... DoneBuilding dependency treeReading state information... DoneCalculating upgrade... DoneThe following packages will be upgraded:login passwd2 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.Need to get 1124 kB of archives.After this operation, 4096 B of additional disk space will be used.Get:1 http://archive.ubuntu.com/ubuntu bionic-updates/main amd64 login amd64 1:4.5-1ubuntu2.4 [307 kB]Get:2 http://archive.ubuntu.com/ubuntu bionic-updates/main amd64 passwd amd64 1:4.5-1ubuntu2.4 [817 kB]Fetched 1124 kB in 1s (1018 kB/s) 14debconf: delaying package configuration, since apt-utils is not installed(Reading database ... 6633 files and directories currently installed.)Preparing to unpack .../login_1%3a4.5-1ubuntu2.4_amd64.deb ...Unpacking login (1:4.5-1ubuntu2.4) over (1:4.5-1ubuntu2.3) ...Setting up login (1:4.5-1ubuntu2.4) ...(Reading database ... 6633 files and directories currently installed.)Preparing to unpack .../passwd_1%3a4.5-1ubuntu2.4_amd64.deb ...Unpacking passwd (1:4.5-1ubuntu2.4) over (1:4.5-1ubuntu2.3) ...Setting up passwd (1:4.5-1ubuntu2.4) ..

Note: It is recommended that you reboot the VM at this point to ensure any package upgrades take effect. This can be done by issuing the following command: sudo reboot

1. 1. Print current releases version information using: lsb_release -a
    auvik:/# lsb_release -a
    
    lsb_release -a
    
    No LSB modules are available.
    
    Distributor ID: Ubuntu
    
    Description: Ubuntu 18.04.6 LTS
    
    Release: 18.04
    
    Codename: bionic
  2. Run the release upgrade command: do-release-upgrade --allow-third-party
  3. If prompted, press 'y' to begin the release upgrade. The output indicates how much room is approximately needed in order to proceed.
    
    do-release-upgrade prompting for confirmation
  4. When prompted to allow service restarts, use the arrow-keys and enter to select ‘Yes’. Depending on the size of the upgrading
    
    allow restarting of services using core libraries
  5. During installation, you may be prompted to configure which version of LXD version you would like installed. Select version 4.0 using the ‘arrow keys’, and then press ‘enter’ to confirm the s
    
    prompt to upgrade LXD
  6. During the installation, you may be prompted to configure grub-pc. Select ‘ok’ with the enter key. This will bring you to a menu with multiple options, use the ‘arrow keys’ to navigate up and down the list, and the ‘space bar’ to select ‘/dev/sda’. Once selected (denoted by the ‘*') press ‘tab’ to jump to the ‘<Ok>’ button, and press ‘enter’ to confirm selection.
    
    prompt to configure grub
    installing grub on /dev/sda
  7. During installation of various packages, you may be ask to select a configuration to use, select the ‘install the package maintainer’s version' option, using the arrow-keys for navigation and space-bar to select the option. Use tab to jump to the '<Ok>' button, and press enter to accept selection.
    
    inbound package configuration updates
  8. Once all packages are upgraded, the process will then prompt for cleaning up of any obsolete packages currently installed, that are no longer needed. Enter 'y' to continue with the cleanup process.
    removing unneeded packages
  9. Once the obsolete packages are removed, you will be prompted to reboot the system. Enter 'y' to continue with the reboot process.
    reboot required
  10. Once the OVA has rebooted, we can confirm the new release has been applied using:
    lsb_release -a
    
    auvik:/# lsb_release -a lsb_release -a No LSB modules are available. Distributor ID: Ubuntu Description: Ubuntu 20.04.5 LTS Release: 20.04 Codename: focal