This is an old revision of the document!

Software Setting Guide for CloudShell-2

This is step-by-step guide based on Ubuntu 16.04.2 OS image for CloudShell-2 software environment.

0. Download Ubuntu image [On HOST PC]

$ wget http://deb.odroid.in/trial_4.9/ubuntu-16.04.2-mate-odroid-xu4-20170222.img.xz
$ wget http://deb.odroid.in/trial_4.9/ubuntu-16.04.2-mate-odroid-xu4-20170222.img.xz.md5sum
$ md5sum -c ubuntu-16.04.2-mate-odroid-xu4-20170222.img.xz.md5sum
ubuntu-16.04-server-odroid-xu3-20161028.img.xz: OK
$ unxz ubuntu-16.04.2-mate-odroid-xu4-20170222.img.xz

1. Insert micro SD card to micro SD card slot in your PC. (* If your HOST PC does not have micro SD card slot, then you need micro SD card reader.) [On HOST PC]

2. Flash Ubuntu image to micro SD card. [On HOST PC]

We recommand unmount your micro SD card before execute dd command, if the micro SD card mounted.
```
$ sudo umount /dev/path/of/card
```

$ sudo dd if=ubuntu-16.04.2-mate-odroid-xu4-20170222.img of=</dev/path/of/card> bs=1M conv=fsync
$ sudo sync

3. Insert micro SD card to micro SD card slot in ODROID-XU4. [On ODROID-XU4]

4. Power on the CloudShell-2.

You need USB-UART Module Kit or HDMI cable + USB keyboard to access ODROID-XU4 Ubuntu console.

5. Update the Ubuntu to latest. [On ODROID-XU4]

$ sudo apt-get update && sudo apt-get upgrade && sudo apt-get dist-upgrade

This step includes the hard disk formatting. If your hard disk contains important data, please backup the data before trying follow's steps.

If you want to avoid the hard disk formatting. Please use the JBOD/PM mode and skip the step 6.
On other mode (RAID 0/RAID 1/SPAN), the two hard disks are detected one logical storage. So, it is necessary to format the logical storage(/dev/sda) before using it.

6. Format the hard disks. In this example, we use the just one partition. [On ODROID-XU4]
* RAID 0/RAID 1/SPAN mode

$ sudo dd if=/dev/zero of=/dev/sda bs=512 count=1
$ sudo mkfs.ext4 /dev/sda

* PM mode

$ sudo dd if=/dev/zero of=/dev/sda bs=512 count=1
$ sudo mkfs.ext4 /dev/sda
$ sudo dd if=/dev/zero of=/dev/sdb bs=512 count=1
$ sudo mkfs.ext4 /dev/sdb

7. Create the mount points and edit /etc/fstab file for auto-mount on system start-up. [On ODROID-XU4]
* RAID 0/RAID 1/SPAN mode

$ sudo mkdir -p /media/hdd
$ sudo nano /etc/fstab

UUID=e139ce78-9841-40fe-8823-96a304a09859 / ext4 errors=remount-ro,noatime 0 1
LABEL=boot /media/boot vfat defaults 0 1
/dev/sda       /media/hdd ext4 defaults    0 1

* PM mode

$ sudo mkdir -p /media/hdd1
$ sudo mkdir -p /media/hdd2
$ sudo nano /etc/fstab

UUID=e139ce78-9841-40fe-8823-96a304a09859 / ext4 errors=remount-ro,noatime 0 1
LABEL=boot /media/boot vfat defaults 0 1
/dev/sda       /media/hdd1 ext4 defaults    0 1
/dev/sdb       /media/hdd2 ext4 defaults    0 1

8. Create a new account called “cloudshell”. This account is to access samba server. [On ODROID-XU4]
* RAID 0/RAID 1/SPAN mode

$ su -
# echo "/bin/false" >> /etc/shells
# useradd cloudshell-d /media/hdd -s /bin/false
# passwd cloudshell
(Set the password of cloudshell)
# chown cloudshell.cloudshell –R /media/hdd/
# chmod 755 -R /media/hdd/
# reboot

* PM mode

$ su -
# echo "/bin/false" >> /etc/shells
# useradd cloudshell-d /media/hdd1 -s /bin/false
# useradd cloudshell-d /media/hdd2 -s /bin/false
# passwd cloudshell
(Set the password of cloudshell)
# chown cloudshell.cloudshell –R /media/hdd1/
# chown cloudshell.cloudshell –R /media/hdd2/
# chmod 755 -R /media/hdd1/
# chmod 755 -R /media/hdd2/
# reboot

9. Install samba server. [On ODROID-XU4]

$ sudo apt install -y samba

10. Edit /etc/samba/smb.conf file. Add the following configuration options to the end of the /etc/samba/smb.conf file. [On ODROID-XU4]
* RAID 0/RAID 1/SPAN mode

[Shared]
comment = CloudShell-2 File Server
path = /media/hdd
guest ok = yes
browseable = yes
create mask = 0644
directory mask = 0755
read only = no
writable = yes
force user = cloudshell

* PM mode

[Shared1]
comment = CloudShell-2 File Server 1
path = /media/hdd1
guest ok = yes
browseable = yes
create mask = 0644
directory mask = 0755
read only = no
writable = yes
force user = cloudshell

[Shared2]
comment = CloudShell-2 File Server 2
path = /media/hdd2
guest ok = yes
browseable = yes
create mask = 0644
directory mask = 0755
read only = no
writable = yes
force user = cloudshell

11 and 12 step is for samba performance optimization

11. Add the configurations below to the [global] section of the /etc/samba/smb.conf file. [On ODROID-XU4]

write cache size = 524288
getwd cache = yes
use sendfile = yes
min receivefile size = 16384
socket options = TCP_NODELAY IPTOS_LOWDELAY

12. Add the system configurations to /etc/rc.local file. [On ODROID-XU4]

ifconfig eth0 mtu 6975
echo 5 > /proc/irq/143/smp_affinity_list
echo 6 > /proc/irq/144/smp_affinity_list
echo f > /sys/class/net/eth0/queues/rx-0/rps_cpus

13. Install CloudShell-2 specific packages: enable LCD, FAN and IR. → Refer to Cloudshell-2 wiki page

14. Reboot and done!

$ sudo reboot