====== Icubsrv configuration previous to the installation ======

Please follow this instructions if the laptop is going to be reformatted.

===== Creation of iCub user =====
You need to create the icub user. For nfs (see later) to work this user has to have the id 1000.

  adduser icub --uid 1000
in LINUX starting procedure, it is asked to create the first user. By default uid is set at 1000. 
to make sure it is done do:
  id -u icub
you should get 1000 if NOT, manage the possible different number uid (int he case you have more 
than one user on your pc). In order to get it, use this following command to manage the uid of the 
users

  usermod -u [UID number] [username]
for example in our case: usermod -u 1000 icub

===== Software Repository =====

The laptop hosts two directories and export them using nfs. 
One of these directories is mounted by the pc104 (/exports/code-pc104), 
the other is mounted by the other machines on the network and by the laptop iteself (/exports/code) (in the past this directory was named code-64, but the 64 bit suffix is no longer important).

For this to work you need:

1) install nfs server on the laptop:
  sudo apt-get install nfs-kernel-server nfs-common portmap
  
2) create the directories that will be exported:
  mkdir -p /exports/code
  mkdir -p /exports/code-pc104
  
Respectively for the laptop/other machines and the pc104 
4) Set appropriate permissions to the icub user:

  sudo chown icub:icub -R /exports/code-pc104
  sudo chown icub:icub -R /exports/code
  
5) Now configure the nfs-kernel-server:
Add these lines to /etc/exports:

  /exports/code 10.0.0.0/255.255.255.0(rw,sync,no_root_squash,no_subtree_check)
  /exports/code-pc104 10.0.0.0/255.255.255.0(rw,sync,no_root_squash,no_subtree_check)

You might need to restart the nfs server.

  /etc/init.d/nfs-kernel-server restart 

Or just reboot the machine.

6) Now configure the laptop to mount /exports/code to /usr/local/src/robot
Edit /etc/fstab and add:

  /exports/code   /usr/local/src/robot  none bind
Reboot or type:

  sudo mount -a
  
===== Configuration of the icub user =====

Install the ssh keys for password-less login, on the laptop:
Log in as icub and create an ssh key.

  ssh-keygen -t rsa
copy this key as default key on your own system (used mainly for yarpserver and iCubCluster 
programs)

  cp /home/icub/.ssh/id_rsa.pub /home/icub/.ssh/authorized_keys
give this key file to pc104

  mkdir /exports/code-pc104/.ssh
  cp /home/icub/.ssh/id_rsa.pub /exports/code-pc104/.ssh/  
  
Configure bashrc. Add these lines in /home/icub/.bashrc:
  export ICUB_ROOT=/usr/local/src/robot/iCub
  export ICUB_DIR=$ICUB_ROOT/main/build
  export YARP_ROOT=/usr/local/src/robot/yarp2
  export YARP_DIR=$YARP_ROOT/build
  export ICUB_ROBOTNAME=iCubMunich01
  export PATH=$PATH:$ICUB_DIR/bin:$YARP_DIR/bin
  
===== Network configurations =====

This step is important, because the laptop (icubsrv) will connect to the pc104 through ssh
* Install ssh-server package:
  apt-get install openssh-server
* Install python-tk package:
  apt-get install python-tk
* It is handy to enable icub user to the sudoers
  edit /etc/sudoers and add, note: useless if you are working on Ubuntu
  icub  ALL=(ALL) ALL
  
* Enable NAT and port forwarding so that the pc104 (and other machines on the network) have 
internet access (using wlan0 as external network interface).

 Add these lines in /etc/rc.local:
  iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE
  echo 1 > /proc/sys/net/ipv4/ip_forward
where wlan0 is the name of your system wireless communication so check if it is correct on the file /etc/udev/rules.d/70-persistent-net.rules you should get something like that:
  # PCI device 0x14e4:0x4359 (wl)
  SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="c0:f8:da:76:23:8b", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="wlan0"
  
* Fix IP and Gateway
On the same file as prior you should see another PCI device, it is the ethernet port, it looks like that
  # PCI device 0x8086:0x1502 (e1000e)
  SUBSYSTEM=="net", ACTION=="add",DRIVERS=="?*", ATTR{address}=="5c:26:0a:5d:77:2d", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0"
where eth0 is the number given by the system for the PCI board, use this number to set the file /etc/network/interfaces by removing everything and copy those lines
  allow-hotplug eth0
  iface eth0 inet static
  address 10.0.0.1
        netmask 255.255.255.0
        gateway 10.0.0.1
  #dns config - example for IIT configuration
  #dns-search humanoids.iit.it
        dns-nameservers 8.8.8.8
  auto eth0
  
*  Clock synchronization:
Download the ntp package
  sudo apt-get install ntp
Your Laptop has to be the clock of the connection with the pc104 in case of no internet access so replace those lines from the file /etc/ntp.conf

  server 0.ubuntu.pool.ntp.org
  server 1.ubuntu.pool.ntp.org
  server 2.ubuntu.pool.ntp.org
  server 3.ubuntu.pool.ntp.org
or comment them by adding a # in front each lines and add those lines instead
  server 127.127.1.1
  fudge 127.127.1.1 stratum 8 refid NIST
The internal clock of the pc104 resets every time the pc104 is restarted. It is important you configure your local network so that the pc104 has the correct time. In general it is a good idea if all the machines on the iCub network have synchronized clock. 
This page explains how to do this: [[http://eris.liralab.it/wiki/Clock_synchronization| Clock synchronization]].

If your network does not have a dns it is a good idea to add the pc104 to /etc/hosts by adding the line:
  10.0.0.10    pc104
(note that in the past the pc104 ip address was 10.0.0.2. This it has been recently changed)