Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

125 lines (84 sloc) 4.08 KB
Installation Notes
These are currently slightly cryptic, and are for Ubuntu 9.10
If you are browsing this on the web, you'll first need to grab the code
$ sudo apt-get install git
$ git clone
Install the database. We're using postgres
$ sudo apt-get install postgresql
$ sudo -u postgres -i
Create a user and three databases needed for the rails app. Remember the password you pick, you'll need it later.
$ createuser sensory -s -P
$ createdb -E UTF8 -O sensory sensory_dev
$ createdb -E UTF8 -O sensory sensory_test
$ createdb -E UTF8 -O sensory sensory_prod
$ exit
Install rubygems, and use rubygems to install rails and all the libraries needed for it.
$ sudo apt-get install ruby1.8 rdoc1.8 ri1.8 ruby irb libxml2-dev ruby1.8-dev \
apache2-threaded-dev libmagick9-dev build-essential libopenssl-ruby \
apache2 libxml-ruby
$ wget
$ tar -xzvf rubygems-1.3.6.tgz
$ cd rubygems-1.3.6/
$ sudo ruby setup.rb
$ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
$ sudo gem install -v=2.3.8 rails
$ sudo gem install pg
$ sudo gem install libxml-ruby
Go into the project source code, and set up the database configuration
$ cd Sensory-Journeys/web/config
$ cp postgres.example.database.yml database.yml
$ nano database.yml # you need to edit this with the database username (sensory) and password (you picked one earlier)
$ cp example.environment.rb environment.rb
$ nano environment.rb # you need to set the walking papers url and change the default passwords
Setup the database with all the correct tables, columns etc for our project.
$ rake db:migrate
Install passenger. This is the apache module that deals with rails code.
$ sudo gem install passenger
$ sudo apt-get install libcurl4-openssl-dev
$ sudo passenger-install-apache2-module # keep a note of the stuff it outputs at the end regarding LoadModule. You'll want to copy it somewhere.
Edit the following file
$ sudo nano /etc/apache2/conf.d/passenger
Add the contents you copied earlier. The exact version numbers will have changed slightly from what's written here.
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-2.2.11/ext/apache2/
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.2.11
PassengerRuby /usr/bin/ruby1.8
Save the file.
Now you will need to set up your apache config files for the various virtual hosts you want to set up. An example would be as follows:
<VirtualHost *:80>
DocumentRoot /home/andy/production-multi/web/public
RailsEnv production
You'll need to know enough about this stuff to sort it out!
sudo /etc/init.d/apache2 restart
======== walking papers ===========
$ sudo apt-get install curl python-imaging python-numpy openjdk-6-jre-headless
$ sudo apt-get install libapache2-mod-php5 php5-gd php5-pgsql php-pear
$ sudo pear install Crypt_HMAC HTTP_Request DB
$ sudo pear install Crypt_HMAC2 MDB2 MDB2#pgsql
$ sudo -u postgres -i
$ createdb -E UTF8 -O sensory paperwalking
$ exit
Go into the Sensory-Journeys top level folder
$ cd /path/to/Sensory-Journeys
# Add the tables to the paperwalking database
$ psql -U sensory -h localhost -f wp/site/doc/create.postgres paperwalking
Set up the rest of walking papers
$ git submodule init && git submodule update
$ cd wp/site && make
$ cd ../decoder && make
Set up the walking papers configuration
$ cd ../site/lib
$ cp init.php.txt init.php
$ nano init.php (change dsn and final_destination)
PHP limits the size of uploaded files and POST requests in general. We need to increase these dramatically given the size of scans
$ sudo nano /etc/php5/apache2/php.ini # find and change these two values
upload_max_filesize = 25M
post_max_size = 25M
========= ==========
This is the utility that compiles the individual scans into slippy maps.
sudo apt-get install python-psycopg2
cd /path/to/Sensory-Journeys/wp
nano # set the password
Jump to Line
Something went wrong with that request. Please try again.