Upgrading or reseting a Cubbli installation

**Upgrading or resetting a Cubbli installation**

Cubbli upgrades and resets are managed by an upgrade-script which completely replaces the existing Linux system directories (/usr, /var/, /etc.) with a new installation from a premade installation image. This script can be run by ordinary users. 

4

5

**Please note**:

6

7

* __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. __

8

* __If your system partition (root) size is ~~80G (you can check from the terminal with: //$ df -h//), you should contact [[cubbli-upgrade@helsinki.fi>>mailto:cubbli-upgrade@helsinki.fi||shape="rect"]] and book a time to do a clean install instead of an upgrade.__

9

10

Upgrading Cubbli will usually take less than two hours. The size of the current installation is about 30GB when compressed. This means that over a slower network the upgrade might take a long time. 

11

12

13

**~1. If you want to install the upgrade yourself:**

14

15

* The upgrade might fail and the computer might not boot. If this occurs, you must bring the computer to the university IT support for inspection. Should this occur, your files are most likely safe.

16

* **Use a wired network connection. USB connected mobile phone works too. **

17

* If the upgrade script refuses to run, please contact [[cubbli-upgrade@helsinki.fi>>mailto:cubbli-upgrade@helsinki.fi||shape="rect"]].

18

* The upgrade script will ask for your sudo password, **but will accept your university password even if you do not have sudo rights**.

19

20

21

**Please note the following about the upgrade installation**:

22

23

* You need a working wired network connection to complete your first login to the computer after the upgrade. 

24

* All wireless connections will be forgotten during the upgrade.

25

* Home directories and any files or folders under the /home/ directory will be saved.

26

* All mount points for RAID devices, external hard drives and network file shares (NFS and Cifs) will be kept as is.

27

* Active directory (AD) domain membership will be kept as is.

28

* SSH public and private keys will be saved. 

29

* All system modifications made with admin rights will be lost.

30

* Any software installed in system directories will be gone. For this reason, you should install your research and development software under your **/**home directory instead of system directories.

31

* There are some exceptions to the aforementioned rule, since /opt is not completely cleared out during the installation. However, please do not rely on this.

32

* For some hosts (mostly Lenovo computers), the script will also install firmware updates.

33

* The script will check for certain software installations which might cause significant data loss if deleted. In these instances, the installation script will refuse to run. Such instances include e.g. docker images and virtual machines. 

34

* The first Linux image download (about 10GB) cannot be restarted. The image download will start from the beginning if interrupted. 

35

36

37

**How to upgrade or reset the installation**:

38

39

Please make sure to back up your data before beginning the installation/reset process!

40

41

* You do not need administrator (sudo) rights to run the installation script. Just write your **university password**.

42

* Start your preferred terminal application and run the command: **cubbli-upgrade **or select //Upgrade Cubbli version// from the University Menu.

43

* Follow the instructions.

44

* The computer will restart automatically after the first download has finished. You should log out of your session before that happens. The upgrade installation process and the download will continue in the background. 

45

* After the upgrade has finished, follow the [[first login instructions.>>url:https://wiki.helsinki.fi/display/it4sci/First+login+to+a+Cubbli+Linux+host||shape="rect"]]

46

47

48

**2. If you want our IT support to install the upgrade for you:**

49

50

Please make sure to back up your data before beginning the installation/reset process!

51

52

* Contact [[cubbli-upgrade@helsinki.fi>>mailto:cubbli-upgrade@helsinki.fi||shape="rect"]] and request the upgrade. 

53

* Arrange a time slot for the installation with IT support.

54

* Bring your computer to the university premises.

55

* Connect the computer to the wired network.

56

* Connect the computer to a charger.

57

* Log out of the system before the agreed time slot. We will initiate and run the upgrade remotely for you. 

58

* After the upgrade has completed, remember to login to the computer once while connected to the university network via wired connection to ensure that your user account will also be available outside the university network and offline. 

59

60

61

**Running the upgrade**

62

63

The shortcut in the University Menu should be available for all Cubbli distributions. If you cannot see it in the menu, you can skip to the next step //Installing the upgrade from a terminal window//.

64

65

=== Starting the upgrade from the University Menu: ===

66

67

[[image:attach:upgrade_cubbli_version.png]]

68

69

Starting the script from the UH-Menu

70

71

72

[[image:attach:system_upgrade.png]]

73

74

You are currently reading the instructions, so you can click //Start Upgrade//

75

76

77

//[[image:attach:upgrade_terminal.png]]//

78

79

//New terminal window opens (Just write your password if asked)//

80

81

=== Starting the upgrade from the terminal: ===

82

83

[[image:attach:Screenshot_Cubbli16-wvm-2_2021-04-06_12:40:19.png]]

84

85

First the script asks for sudo password or just password.

86

87

[[image:attach:Screenshot_Cubbli16-wvm-2_2021-04-06_12:40:42.png]]

88

89

Confirm that you really want to upgrade.

90

91

92

[[image:attach:Screenshot_Cubbli16-wvm-2_2021-04-06_12:41:38.png]]

93

94

Wait for the upgrade to be downloaded.

95

96

97

(% class="auto-cursor-target" %)

98

(% class="BCX8 BCX8 NormalTextRun SCXW149916677 SCXW149916677 TextRun" style="color:#000000" %)After the download has finished the script will switch the Linux installation to the new system image and restart the computer. After the first restart, the previous (% class="BCX8 BCX8 NormalTextRun SCXW149916677 SCXW149916677 TextRun" style="color:#538135" %)operating (% class="BCX8 BCX8 NormalTextRun SCXW149916677 SCXW149916677 TextRun" style="color:#000000" %)system will be removed, and (% class="BCX8 BCX8 ContextualSpellingAndGrammarErrorV2Themed NormalTextRun SCXW149916677 SCXW149916677 TextRun" style="color:#538135" %)remaining(% class="BCX8 BCX8 NormalTextRun SCXW149916677 SCXW149916677 TextRun" style="color:#000000" %) software (about 20GB) will be downloaded and installed.(% class="BCX8 EOP SCXW149916677" style="color:#000000" %)

99

100

(% class="auto-cursor-target" %)

101

(% class="BCX8 EOP SCXW149916677" style="color:#000000" %)[[image:attach:1st-boot.png]]

102

103

104

(% class="auto-cursor-target" %)

105

(% class="BCX8 EOP SCXW149916677" style="color:#000000" %)[[image:attach:Screenshot_Cubbli16-wvm-2_2021-04-06_13:23:11.png]]

106