Sensorgnome Installation for the Raspberry Pi Model 2 B

DANGER!!! DANGER!!! DANGER!!! DANGER!!! DANGER!!! DANGER!!! DANGER!!!
See the security note at the bottom of this file.

For this installation, your internet set-up must permit both:

A. logging into the Raspberry Pi from your computer, via ssh.
   You can use the putty program, available here:

       http://www.putty.org/

   for Windows, or the standard ssh client for OS X and Linux.
   Your Pi is probably reachable using the host name "pi.local"

-- and --

B. the Pi must have access to the internet.  You can verify this
   by logging into the Pi, then typing

       ping www.google.com

   You should get something like this:

       PING www.google.com (142.176.121.216) 56(84) bytes of data.

   (the numeric address isn't important).

   But if instead, you get:

       ping: unknown host google.com

   Then the Pi cannot reach the internet, and the installation won't
   work.

Here are two ways you can set up your network for this installation:

   Pi  <--- ethernet ---> router <--- ethernet or wifi ---> laptop


   Pi  <--- ethernet ---> laptop (*) <--- wifi ---> router

(*) means the laptop is set to share its internet connection to the router with the Pi,
or is set to bridge the ethernet and wifi networks.  Google "XXX internet connection sharing"
or "XXX network bridging" where XXX is either "Windows" or "OS X", to find instructions
for this.

Once you have a network set-up that permits both A. and B. above, you can proceed.

1. create a micro SD card with the jessie lite release from this file:

     http://public.sensorgnome.org/RaspberryPi2_Sensorgnome_Images/2016-03-18-raspbian-jessie-lite.img.7z

   using the instructions here:

     https://www.raspberrypi.org/documentation/installation/installing-images/README.md

2. login to your raspberry pi (search raspberrypi.org for instructions)
   You can do this via ssh.  UNTESTED: you might also be able to do it
   locally with a monitor and keyboard attached to the Pi.
   Login credentials are:

      user:     pi
      password: raspberry

3. Once logged into the Pi, do:

   sudo su

4. Then do:

   . <(curl http://public.sensorgnome.org/rpi2inst.sh)

   Note that there is a space between the period (".") and the less-than
   symbol ("<").

5. This will start the installer script.  If you have already resized
   your root filesystem to make full use of the SD card, then skip to
   step 10.  Otherwise, if you have inaccessible free space on your SD
   card, the raspi-config scripts is launched.  This permits you to
   resize the root partition to use all available space.  We don't
   recommend changing any other options from this menu, because we
   haven't tested them.

6. After resizing, reboot the system.

7. Login again as

     user:     pi
     password: raspberry

8. Once logged in, do (again):

     sudo su

9. Then do (again, so hit cursor up to retrieve this line):

   . <(curl http://public.sensorgnome.org/rpi2inst.sh)

10.This will load several packages from the raspbian repository, and
   will then install the sensorgnome software.  Depending on the speed
   of your internet, this should take around 15 minutes.

11.When all has been installed, the script will prompt you to agree
   to a regoot.

After the reboot, you will find your SG-Pi here:

   http://192.168.7.2   - web interface

    ftp://192.168.7.2   - FTP file server

Most computers will also be able to find it here:

   http://sgpi.local   - web interface

    ftp://sgpi.local   - FTP file server

To edit deployment.txt or to install SG_tag_database.csv, you can just
place this microSD card into another computer and copy files directly
onto the first drive.  DO NOT LET WINDOWS or OS X reformat this card!

To conveniently download entire folders at once, use an FTP client
such as FireFTP:

     http://fireftp.net

which can most easily be installed via the FireFox Tools | Addons menu.

You can also connect to your SG via ssh:

     ssh pi@sgpi.local
or
     ssh pi@192.168.7.2

with password "raspberry".  Alternatively, use "bone" as username
and password.

DANGER!!! DANGER!!! DANGER!!! DANGER!!! DANGER!!! DANGER!!! DANGER!!!

SECURITY NOTE: do not put an SG on an unprotected network - use a
firewall which blocks access to port 22 on your SG.  Otherwise, anyone
on the planet with an internet connection can login to your SG and
work with root privileges.  This would for example let them snoop
all your local ethernet traffic.