🚀 How-To update from < 0.6.0 to 0.6.x

The latest release of AtomOS completely revolutionizes how it operates and is installed. However, it is important to understand what will be changed before updating your installation. :::warning In order to execute this update you will need to shutdown and delete all the virtual machines running and reboot the host at least two times
To not loose any data backup all your disks before starting the procedure :::

📦️ New packages introduced

Starting from AtomOS 0.6.0, we changed the way we package our hypervisor, now leveraging the full power of the official RPM and DEB repositories. In this version, you will install 3 different packages (atomos-common, atomos-storage, atomos-compute) that replace the old atomos package.

🖲️ CLI introduction

AtomOS 0.6.x introduces nucleus CLI, the new way to interact with your AtomOS installation. Refer to this document to learn how to use it to its full potential.

⬇️ New installation method

To install the newer versions of AtomOS, you must first install nucleus. Follow this guide to learn how to do it.

🔃 How to update

Uninstalling the old version is required before installing the new packages: :::warning Make sure to back up all your important configurations, licenses, and disks
Licenses are stored in /etc/elemento
Disks are stored in /mnt/*/ where '*' is a configured vault
Move these aside before uninstalling :::

1.⚠️ Backup sample procedure

Backup licenses

sudo mkdir /var/elemento-backup/licenses                 # Create backup folder
sudo cp /etc/elemento/* /var/elemento-backup/licenses    # Copy all the licenses

Backup Volumes

This will show you how to do this with a sample vault elemento-vault , repeat this process to backup all the vaults you have created Make sure to select a folder/mount point with enough free space to accomodate all the disks

mkdir /var/elemento-backup/elemento-vault                                             # Create backup folder
sudo rsync -avhp /mnt/elemento-vault/vid.* /var/elemento-backup/elemento-vault/       # Copy all the disks
sudo find /var/elemento-backup/ -type f -name "iqn*" -exec rm -rf {} +                # Remove export lock from the copies

2.❌️ Uninstall the `atomos` package

sudo dnf remove atomos

Make sure to uninstall docker🐋 and all of its components

sudo dnf remove docker-ce docker-ce-cli

3.🗑️ Remove all AtomOS-related folders

sudo rm -rf /var/elemento
sudo rm -rf /etc/elemento
sudo rm -rf /opt/elemento
sudo rm -rf /mnt/<vault name>

4.❌️ Remove the old Elemento repository

sudo rm -rf /etc/yum.repos.d/*elemento*

5.🧾 Follow the installation guide to install the latest AtomOS version

6.🪪 Import your licenses into `/etc/elemento`

sudo cp <path-to-backed-up-licenses>/<license-name>.license /etc/elemento/

Repeat the step for every valid license you backed-up

7.📦️ Create new vaults with the CLI utility

and move your volumes back (move the vid.<uuid>.elimg file back to a newly created vault)
Use the integrated vault-creator utility embedded in nucleus

sudo nucleus --vault-creator

8.🔃 Restart the services with `nucleus`

sudo nucleus --restart-all --force

9.🔄 Recovery

License recover:

# after the new installation
sudo mv /var/elemento-backup/licenses/* /etc/elemento/   # Copy back the licenses
sudo rm -rf /var/elemento-backup/licenses                # Remove the backup folder

Volume recover:

# after the creation of the new vault
sudo rsync -avhp /var/elemento-backup/elemento-vault/* /mnt/elemento-vault/           # Copy back to a functional vault
sudo rm -rf /var/elemento-backup/elemento-vault                                       # Remove backup folder