Preparation

✅A Ubuntu 20.04.2 server for supOS
✅A USB dongle with authorization file

Install and configure Ubuntu Server

Installing Server

1. Get Ubuntu 20.04.2 Server iso

2. Proceed installation and create 3 logical volumes for mount points.

Mount Point	Minimum Disk Size	Recommended Disk Size	Function	Mount Name	Description
/volumes	200 G	1200 G	supOS system data storage	lv00	If data volume is large, increase the disk mount size.
/home/supos/supos	100 G	200 G	supOS installation package	lv01	-
/backup	200 G	200 G	Backup file storage path	lv02	Adjust the disk size based on actual backup file size.

Configuring Server

1. Enable root account

   1. Open SSH configuration file.

      sudo vi /etc/ssh/sshd_config

      

   2. Press ESC to exit editing and then enter :wq to save the file.

   3. Restart the service.

      service sshd restart

   4. Set the password of the root account.

      sudo passwd

   5. Switch to root account.

      sudo su

2. Modify time zone and server time.

info

Configure time zone accordingly.

1. Copy time zone file.

cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

2. Use date command to check the current time and time zone.
3. (optional) Set date and time.

• Set date: date -s 06/03/2019

• Set time: date -s 17:55:54

4. Write system time to hardware.

hwclock -w

5. Check whether the system time (date) matches the hardware time (hwclock).

3. Turn off the swap partition of the server

1. Execute swapoff /swap.img to turn off swap.
2. Execute free -h to check whether the swap partition is successfully turned off.

3. Open the configuration file.

vi /etc/fstab

4. Comment out the line with swap (add a #)

5. Press ESC to exit editing and then enter :wq to save the file.

3. (optional) Install tools.

   apt install sysstat net-tools sysbench fio zip

4. Configure the static DNS.

   1. Delete /etc/resolv.conf.

      rm -f /etc/resolv.conf

   2. Open the /etc/resolv.conf file, press i to start editing and add a nameserver.

      sudo vi /etc/resolv.conf

      

5. Turn off the default firewall.

   sudo ufw disable

Installing supOS Platform

1. Create directories under /home on the server for supOS installation package and the platform.

   • /home/supos/supos/downloads: For the installation package.

   • /home/supos/supos/opt/supos: For supOS platform.

2. Copy the installation package to the created directory.

   cp xxx/supOS-V4.xx.xx.xx-C-xxxxxx.zip /home/supos/supos/downloads

3. Decompress the package to /home/supos/supos/opt/supos.

   cd /home/supos/supos/downloads

   unzip supOS-V4.xx.xx.xx-C-xxxxxx.zip -d /home/supos/supos/opt/supos

4. Set supOS language.

   cd /home/supos/supos/opt/supos/bin

   cp env.sh.tmpl env.sh

   vim env.sh

   

5. Install supOS.

   cd /home/supos/supos/opt/supos

   sudo bash install.sh

6. Check the service status after installation.

   kubectl get po

info

• supOS will automatically start after installation. You can also manually start by sudo bash start.sh under home/supos/supos/bin folder. It takes at least 300 seconds to start the whole system.
• You can ONLY stop supOS system using sudo bash stop.sh under home/supos/supos/bin folder.

7. Insert the authorization dongle into supOS server.

Uninstalling supOS Platform

You can select to only delete the programme file without clearing data or delete all data when uninstalling the platform from the server.

info

Once you uninstall the programme, the original configuration files such as “env.sh” and “dlake.json” will be backed up and renamed to “env-xxxxxxxx.sh” and “dlake-xxxxxxxx.json” respectively. Rename them to the original names when installing the platform with the original configurations.

• Uninstall supOS platform.

1. Switch to the bin directory under the supOS platform installation path.

   cd /home/supos/supos/opt/supos/bin

2. Uninstall the programme and wait for it to finish.

   sudo bash uninstall.sh

• Uninstall the programme and clear all data.

1. Switch to the bin directory under the supOS platform installation path.

   cd /home/supos/supos/opt/supos/bin

2. Uninstall the programme and clear all data.

   sudo bash clean-all.sh