2. 1. Introduction
2. Preparing SD card
i. Download base image
ii. Burn to SD card
iii. Update kernel.img & start.elf
3. Powering up Rpi
i. Check IP Address of Rpi
ii. Login via SSH
iii. Change password & assign Static IP
4. Update Packages
5. Install Node.js
6. Install Git
7. Install Local Cloud Repo
8. Fire up Local Cloud!
9. Setup init.d script
10. Misc Instructions
Table of Contents

3. Outline
This Tutorial documents the process from the beginning of how to setup a Raspberry Pi with Rasbian image and
eventually run a Local Spark Cloud.
The API server + COAP protocol is written on node.js and the repos are available at:
1. https://github.com/spark/spark-server
2. https://github.com/spark/spark-protocol
Future chapters to be added
1. Install Local Cloud in Docker
2. Dynamic DNS system
3. Boot on startup
You can view the tutorial online at: http://kennethlimcp.gitbooks.io/spark-local-cloud-on-raspberry-pi
Written by: kennethlimcp
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)

4. Let's start fresh and bake some pies ;)
Preparing SD card

5. Go to: http://www.raspberrypi.org/downloads/
Download the RASPBIAN image
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Download base image

6. The Raspberry Pi website has great documentation to setup the SD card properly.
1. Linux
2. Mac OSx
3. Windows
Tips for mac:
To speed up the copying, we should use the raw disk drive instead. Some have gotten 10x improved performance by
doing the following:
*adding r to /dev/disknumber to become /dev/rdisknumber which will use it as a raw disk
The full command will look like:
New:
sudo dd bs=1m if=path_of_your_image.img of=/dev/rdisknumber
Old:
sudo dd bs=1m if=path_of_your_image.img of=/dev/disknumber
It was indeed faster (the previous took forever)
2825+0 records in
2825+0 records out
2962227200 bytes transferred in 257.177468 secs (11518222 bytes/sec)
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Burn to SD card

7. The .img file from the raspbian image does not contain the latest files and upgrading this files before powering up will
save us some updating time later.
1.) Download the latest Rpi firmware from: https://github.com/raspberrypi/firmware/blob/master/boot/start.elf
2.) Download the latest Rpi kernel from: https://github.com/raspberrypi/firmware/tree/master/boot/kernel.img
Overwrite the files on the SD and eject the card!
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Update kernel.img & start.elf

8. Now that the SD card has been prepared, plug it into the Raspberry Pi and power up with a good power supply.
Don't forget the Ethernet cable.
You should notice some LED activity on the Tx and Rx.
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Powering up Rpi

9. 1. Login to your router console and look at the list of devices
2. Sometimes, the raspberry pi does not present a hostname and becomes a challenge to identify the IP!
3. Fortunately, we know that the Rpi MAC add prefix is: B8:27:EB
Once you have retrieved the IP Address, we are good to go!
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Check IP Address of Rpi

10. Launch your favourite Terminal program (eg. Putty) and login with the following details:
IP Address: from your router
Port (SSH): 22
username: pi
password: raspberry
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Login via SSH

11. 1.) Enter the command: passwd
You should see:
Changing password for pi.
(current) UNIX password:
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
2.) Next up, we will modify assign a static IP address.
Enter the command: ifconfig
We will need to note down the following:
INSERT Screenshot
inet addr – 192.168.1.100 (current IP Address)
Bcast – 192.168.1.255 (broadcast IP Range)
Mask – 255.255.255.0 (subnet Mask Address)
3.) Now, we will grab the Gateway info with netstat -nr
Write down:
Gateway Address
Destination Address
Great! We can now modify the settings with:
sudo nano /etc/network/interfaces
Change the following line:
iface eth0 inet dhcp to iface eth0 inet static
The mappings are as such:
`address` --> the_ip_you_prefer
`netmask` --> Mask
`network` --> Destination
broadcast --> Bcast
gateway ----> Gateway
What you will see after adding is like:
auto lo
iface lo inet loopback
iface eth0 inet static
Change password & assign static IP

12. address 192.168.1.200
netmask 255.255.255.0
network 192.168.1.0
broadcast 192.168.1.255
gateway 192.168.1.1
allow-hotplug wlan0
iface wlan0 inet manual
wpa-roam /etc/wpa_supplicant/wpa_supplicant.conf
iface default inet dhcp
Double-check the parameters and save! (CTRL+X)
To make sure things are working ok, let's restart the machine with sudo reboot
If you managed to connect to the Rpi with the new IP address, congratulations!
Let's make sure things are indeed loading correctly:
ifconfig
To be super-sure things are ok, we will perform a ping to the gateway!
ping gateway_ip_add -c 4
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)

13. 1.) Run sudo apt-get update to ensure we have all the latest packages
pi@raspberrypi ~ $ sudo apt-get update
Get:1 http://raspberrypi.collabora.com wheezy Release.gpg [836 B]
Hit http://repository.wolfram.com stable Release.gpg
Get:2 http://archive.raspberrypi.org wheezy Release.gpg [490 B]
Hit http://repository.wolfram.com stable Release
2.) Next will be upgrading with sudo apt-get upgrade
pi@raspberrypi ~ $ sudo apt-get upgrade
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following packages will be upgraded:
dbus dbus-x11 gnupg gpgv libdbus-1-3 libsmbclient libwbclient0 libxml2
rpi-update samba-common smbclient
11 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Need to get 9673 kB of archives.
After this operation, 42.0 kB of additional disk space will be used.
Do you want to continue [Y/n]? y
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Update Packages

14. Original reference from: https://learn.adafruit.com/raspberry-pi-hosting-node-red/setting-up-node-dot-js
1.) Download the package made compatible for Pi with:
sudo wget http://node-arm.herokuapp.com/node_latest_armhf.deb
2.) Install the debian package:
sudo dpkg -i node_latest_armhf.deb
3.) Check the node.js version for a success install!
pi@raspberrypi ~ $ node -v
v0.10.29
4.) the package manager for Node.js will also be required.
So: `sudo apt-get install npm
pi@raspberrypi ~ $ sudo apt-get install npm
Reading package lists... Done
Building dependency tree
Reading state information... Done
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Install Node.js & npm

15. 1.) Run sudo apt-get install git
It should install fairly quickly.
pi@raspberrypi ~ $ sudo apt-get install git
Reading package lists... Done
Building dependency tree
Reading state information... Done
git is already the newest version.
git set to manually installed.
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Next, check the version of git just to be sure.
pi@raspberrypi ~ $ git --version
git version 1.7.10.4
pi@raspberrypi ~ $
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Install Git

16. With the basic setup ready, we are now ready to install Spark-server!
1.) run cd just to be sure we are in the base directory. Otherwise, you can choose where you want to git clone the repo.
2.) Download the spark-server repo:
git clone https://github.com/spark/spark-server.git
pi@raspberrypi ~ $ git clone https://github.com/spark/spark-server.git
Cloning into 'spark-server'...
remote: Reusing existing pack: 272, done.
remote: Total 272 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (272/272), 61.07 KiB | 80 KiB/s, done.
Resolving deltas: 100% (155/155), done.
3.) go to the spark-server folder
cd spark-server
4) Install the module!
`npm install --verbose`
You usually won't need --verbose but things are a little slow on the Rpi and it would be nice to see what's going on.
ALERT:
The URSA node module is not installing correctly with the install.js script from spark-server .
I am not sure why but it managed to build from source when i tried to find out the issue.
So we have to manually build it instead by:
cd node_modules
git clone https://github.com/Medium/ursa.git
cd ursa
npm install -verbose
Another issue came up with the express module so...
cd
cd spark-server
npm install express -verbose`
Install Local Cloud Repo

17. WOOHOO! We now have a shiny new server which talks COAP protocol and responses to API calls !!
Commands summary list:
git clone git@github.com:spark/spark-server.git
cd spark-server
npm install
node main.js
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)

18. 1.) fire up the server, baby!
node main.js in the spark-server folder
This will have some lag for the first time when the Rpi creates a new key.
pi@raspberrypi ~/spark-server $ node main.js
-------
No users exist, you should create some users!
-------
connect.multipart() will be removed in connect 3.0
visit https://github.com/senchalabs/connect/wiki/Connect-3.0 for alternatives
connect.limit() will be removed in connect 3.0
Starting server, listening on 8080
static class init!
Loading server key from default_key.pem
set server key
server public key is: -----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0Gv5evNQCYusK+TnLy2B
lt7WLkSMcjKDzf/JQIkA7azKpJ8iYo8/W2ZTVQYHGxzglvPThkAkwjINpEEKHmQg
199tUDFMo46+FpYFa4A4pOVgF765Uhr84eKSMqCkJ4vzcV7mmrDUTFcmq8ERAOee
802deTBRBRoA7vey1ZjOBrP5WBzTfRAsnmX/ysWBAEe+ikE/4dtIeNlGmp1Z12ne
S1BTomc7d2LJZisJjQ3IszOguvW7DpwovMWxXIJjUy6Uh02zHaEth6ljjUaAeTPU
FZyt6FxWKnNubv8fFM59Ma9eFxKHvIZxCoVabYrilvXNqmraG2rHmrvaqE4lM2eN
3QIDAQAB
-----END PUBLIC KEY-----
Your server IP address is: 192.168.1.200
server started { host: 'localhost', port: 5683 }
The next tutorial to help you connect Spark Cores to your local cloud can be found at:
https://community.spark.io/t/tutorial-local-cloud-1st-time-instructions/5589
Have fun!
k
Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Fire up Local Cloud!

19. Licensed under: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Setup init.d script

20. 1.) Copy server public key to own machine
scp pi@192.168.1.200:spark-server/default_key.pub.pem Desktop
2.) Send core public key to server
scp core_keys/55ff6e065075555329461687.pub.pem pi@192.168.1.200:spark-server/core_keys
Misc Instructions