en:xu4_cloudshell2:software_settings [ODROID Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Software Setting Guide for CloudShell-2 ======
This is step-by-step guide based on [[https://forum.odroid.com/viewtopic.php?f=146&t=26007&sid=b9f6d630883062d4f290c35ac7588b2e|Ubuntu 16.04.2 OS image]] for CloudShell-2 software environment.

**0. Download Ubuntu image** [On HOST PC]
<code>
$ 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
</code>

**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]
<code>
$ dd if=ubuntu-16.04.2-mate-odroid-xu4-20170222.img of=</dev/path/of/card> bs=1M conv=fsync
$ sync
</code>

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

**4. Power on the CloudShell-2.**

<WRAP center round important 100%>
**You need [[http://www.hardkernel.com/main/products/prdt_info.php?g_code=G134111883934|USB-UART Module Kit]] or HDMI cable + USB keyboard to access ODROID-XU4 Ubuntu console.**
</WRAP>


**5. Update the Ubuntu to latest.** [On ODROID-XU4]
<code>
$ sudo apt-get update && sudo apt-get upgrade && sudo apt-get dist-upgrade 
</code>

<WRAP center round important 100%>
**This step includes the hard disk formatting. If your hard disk contains important data, please backup the data before trying follow's steps.**
</WRAP>

<WRAP center round important 100%>
**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.**
</WRAP>

**6. Format the hard disks.** In this example, we use the just one partition. [On ODROID-XU4]\\
* RAID 0/RAID 1/SPAN mode
<code>
$ sudo dd if=/dev/zero of=/dev/sda bs=512 count=1
$ sudo mkfs.ext4 /dev/sda
</code>

* PM mode
<code>
$ 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
</code>

**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
<code>
$ sudo mkdir -p /media/hdd
$ sudo nano /etc/fstab
</code>
<code>
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
</code>
* PM mode
<code>
$ sudo mkdir -p /media/hdd1
$ sudo mkdir -p /media/hdd2
$ sudo nano /etc/fstab
</code>
<code>
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
</code>

**8. Create a new account called "cloudshell". This account is to access samba server.** [On ODROID-XU4]\\
* RAID 0/RAID 1/SPAN mode
<code>
$ 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
</code>
* PM mode
<code>
$ 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
</code>

**9. Install samba server.** [On ODROID-XU4]
<code>
$ sudo apt install -y samba
</code>

**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
<code>
[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
</code>
* PM mode
<code>
[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
</code>

<WRAP center round tip 100%>
**11 and 12 step is for samba performance optimization**
</WRAP>

**11. Add the configurations below to the [global] section of the ///etc/samba/smb.conf// file.** [On ODROID-XU4]
<code>
write cache size = 524288
getwd cache = yes
use sendfile = yes
min receivefile size = 16384
socket options = TCP_NODELAY IPTOS_LOWDELAY
</code>

**12. Add the system configurations to ///etc/rc.local// file.** [On ODROID-XU4]
<code>
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
</code>

**13. Install CloudShell-2 specific packages: enable LCD, FAN and IR.**
-> Refer to [[en:xu4_cloudshell2|Cloudshell-2 wiki page]]

**14. Reboot and done!**
<code>
$ sudo reboot
</code>