Cubbli upgrades and resets are managed by a upgrader script, which completely replaces the existing Linux system directories ( /usr, /var/, /etc ) with a new installation from a premade installation image. In some cases this script can be run by ordinary users. The usual method to update Ubuntu and Debian systems (do-release-upgrade) does not work and is likely to break the Linux system if used.
Installing the Cubbli upgrade will usually take less than 2 hours. The size of the current installation is about 30G when compressed. This means that over a slower network the upgrade might take a long time.
If you want the IT support people to do the upgrade for you:
- Contact email@example.com and ask for a upgrade.
- Negotiate a time slot with the IT support people.
- Bring your machine to the University premises.
- Connect it to a wired network.
- Connect it to a charger.
- Log out of the system at the designated time slot. The upgrade will be started and run remotely.
- After the upgrade is finished remember to login once at the University premises so that your user account will be available also outside University network and offline.
The notable features of the script:
- You need a working network connection to complete first login after the upgrade.
- All wireless Wi-FI connections will be forgotten during the ugrade. If you use Wi-Fi for the upgrade, you need to reconnect to your Wi-Fi network at the first login screen.
- Home directories and anything under the /home/ directory will be saved.
- All mount points for RAID devices, external hard drives and network file shares (NFS and Cifs) will be kept as is.
- Active directory (AD) domain membership will be kept as is.
- Ssh public and private keys will be saved.
- All modifications made with admin rights to the system will be gone.
- Any software installed to the system directories will gone. This is a very good reason to install research and development software to your home directory instead of system directories.
- There are some exceptions to the previous rule, since /opt isn't completely cleared out. Please, don't rely on this.
- For some (mostly Lenovo) hosts the script will also install firmware updates.
- The script will check for some software installations which might cause large data loss if thrown away and refuse to run. These include docker images and virtual machines.
- Currenty the first Linux image download (about 10G bytes) can not be restarted. The image download will start from the beginning if interrupted.
If you want to do the upgrade yourself:
- The upgrade might fail and the laptop might not boot. If that happens you need to bring the laptop to University IT people for inspection.
- Even when that happens, your files are likely safe.
- Use wired network if possible. The first upgrade and first login will work more smoothly with a wired network.
- If you use wireless Wi-Fi for the upgrade, you need to reconfigure your network at the first login screen.
- If the upgrade script refuses to run
or requires administrator (sudo) rights, please contact firstname.lastname@example.org
- It asks for sudo password but will accept your password even if you don't have sudo rights.
How to do the upgrade or reset yourself
- First make a backup of your data. This applies even if you don't want to run the script yourself.
- You don't need administrator (sudo) rights to run the script. Just write your password.
Start your preferred terminal application and run command:
- From the UH-Menu select Upgrade Cubbli version
- Follow instructions.
- The machine will restart automatically after the first download is finished. You should log out of your session before that happens. Upgrade and the download will continue in the background.
- After the upgrade is finished, follow these first login instructions.
Running the upgrade
Edit: 21.02.2022 - Starting from the menu should be available if your computer has the most recent updates. If you don't, you can wait for a while and reboot your computer. Or you can skip →
Starting the script from the UH-Menu
You are currently reading the instructions, so you can click Start Upgrade
New terminal window opens (Just write your password)
First the script asks for sudo password.
Confirm that you really want to upgrade.
Wait for the upgrade to be download.
After the download is finished the script switches Linux installation to the new system image and then restarts the machine. After the first restart old system is removed and missing software (about 20G bytes download) is installed.
Wait for new system install to finish.
Login to your new system for the first time.