====== Software Setting Guide for CloudShell-2 ======
This is step-by-step guide based on [[http://odroid.com/dokuwiki/doku.php?id=en:xu3_release_linux_ubuntu_k49|Ubuntu 16.04.2 minimal image]] for CloudShell-2 software environment.

**0. Download Ubuntu image** [On HOST PC]
<code>
$ wget https://odroid.in/ubuntu_16.04lts/ubuntu-16.04.2-minimal-odroid-xu4-20170516.img.xz
$ wget https://odroid.in/ubuntu_16.04lts/ubuntu-16.04.2-minimal-odroid-xu4-20170516.img.xz.md5sum
$ md5sum -c ubuntu-16.04.2-minimal-odroid-xu4-20170516.img.xz.md5sum
ubuntu-16.04.2-minimal-odroid-xu4-20170516.img.xz: OK
$ unxz ubuntu-16.04.2-minimal-odroid-xu4-20170516.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]
     * We recommand unmount your micro SD card before execute dd command, if the micro SD card mounted.
     * <code>$ sudo umount /dev/path/of/card</code>
<code>
$ sudo dd if=ubuntu-16.04.2-minimal-odroid-xu4-20170516.img of=</dev/path/of/card> bs=1M conv=fsync
$ sudo sync
</code>

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

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

**4.2 Power off and on again the CloudShell-2** when the booting process is finished.

**5. Login 'root' (password: 'odroid')**

<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>


**6. Update the Ubuntu to latest.** [On ODROID-XU4]
<code>
# apt-get update && apt-get upgrade && apt-get dist-upgrade 
</code>
   * If your meta kernel package is kept back, manually update it with the blow.
   * <code> # apt-get install linux-image-xu3 
 # reboot 
(Login 'root' again after boot sequences are done.)</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>

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

* PM mode
<code>
# dd if=/dev/zero of=/dev/sda bs=512 count=1
# mkfs.ext4 /dev/sda
# dd if=/dev/zero of=/dev/sdb bs=512 count=1
# mkfs.ext4 /dev/sdb
</code>

**8. 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>
# mkdir -p /media/hdd
# 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>
<code>
# mount /media/hdd
</code>
* PM mode
<code>
# mkdir -p /media/hdd1
# mkdir -p /media/hdd2
# 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>
<code>
# mount /media/hdd1
# mount /media/hdd2
</code>

**9. Create a new account called "cloudshell". This account is to access samba server.** [On ODROID-XU4]\\
* RAID 0/RAID 1/SPAN mode
<code>
# 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/
</code>
* PM mode
<code>
# echo "/bin/false" >> /etc/shells
# useradd cloudshell -d /media/hdd1 -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/
</code>

**10. Install samba server.** [On ODROID-XU4]
<code>
# apt install -y samba
</code>

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

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


**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>
# reboot
</code>