Upgrade Virtual Appliances
This document describes the process for upgrading the Lumu Virtual Appliance to the latest version available. Please note that the upgrade process requires the appliance to be stopped during the process.
First, check that the root drive free space in the root partition is 2.2 GB or higher. For checking the available space, execute the following command:
df -h
If the available space is lower than 2.2 GB, execute the following command to remove all unused containers, networks, images (both dangling and unreferenced) and accept the process:
docker system prune -a
If after executing the above command, there’s still less than 2.2 GB of free space , contact our support team for assistance.
Once the root drive has enough space, execute the upgrade command and answer yes to the respective prompts :
lumu-appliance upgrade
After starting the VA in the new version, confirm the network settings and confirm.
Be sure to choose the right option for proxy settings according to your environment and for importing the previous configuration (option 3 to apply previous configuration):
Upgrading the OS of an existing VA installation
To upgrade the operating system of an existing appliance to Ubuntu 22.04 LTS:
- First upgrade the appliance’s software to 4.0.3.
- Then upgrade Ubuntu to 22.04 LTS.
- The upgrade process will disable Docker and several python modules. In order to re-enable Docker, edit the appropriate apt file and uncomment the line written by the upgrader:
sudo vi /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt upgrade
4. To re-enable the inactive python modules, run these commands:
python3 -c "import docker" 2> /dev/null || pip3 install docker > /dev/null
python3 -c "import netaddr" 2> /dev/null || pip3 install netaddr > /dev/null
python3 -c "import netifaces" 2> /dev/null || pip3 install netifaces > /dev/null
python3 -c "import psutil" 2> /dev/null || pip3 install psutil > /dev/null
python3 -c "import dialog" 2> /dev/null || pip3 install pythondialog > /dev/null
python3 -c "import requests" 2> /dev/null || pip3 install requests > /dev/null
python3 -c "import simpleeval" 2> /dev/null || pip3 install simpleeval > /dev/null
python3 -c "import dnspython" 2> /dev/null || pip3 install dnspython > /dev/null
python3 -c "import filelock" 2> /dev/null || pip3 install filelock > /dev/null
Alternatively, run this script:
/home/applianceadmin/lva_4.0.3/scripts/rig_u
Version verification
To make sure that the VA has been upgraded correctly, check the current version of the virtual appliance using the following command:
lumu-appliance -v
You can also check the appliance version in the following path of the Lumu Portal: Collectors > Virtual Appliances and clicking in the VA to view its configuration details.
Be aware that some appliance information takes about 5 minutes after activation to be updated on the Lumu portal.
Related Articles
Advanced Settings for Virtual Appliances
The Lumu Virtual Appliance (VA) allows for full visibility into the compromises inside your network and is available for the most commom hypervisors. This document lists and describes procedures for managing advanced settings and troubleshooting for ...Manage Virtual Appliances and Collectors
You have the option to manage Lumu Virtual Appliances (VA) directly from the Lumu Portal. The virtual appliance allows for full visibility into the compromises inside your network and is available for the most commom hypervisors. This document lists ...Introduction to Lumu Virtual Appliances
The Lumu Virtual Appliance (VA) is a pre-configured lightweight virtual machine solution that collects the network metadata of your entire enterprise and forwards it to the Lumu cloud with the lowest impact on the network operation. This document ...Set Lumu as primary network DNS Resolver on Virtual Appliances
The Lumu Virtual Appliance (VA) offers a seamless way to integrate the network metadata of your entire enterprise into the Lumu platform. You can easily deploy and set up a Lumu Virtual appliance to collect DNS network metadata through the Virtual ...Create VA Collectors
The Lumu Virtual Appliance (VA) offers the option to create VA Collectors, a seamless way to collect the network metadata of your entire enterprise and forward it to the Lumu cloud with the lowest impact on the network operation. In this quick guide, ...