Skip to content

Latest commit

 

History

History
104 lines (63 loc) · 3.45 KB

INSTALL.md

File metadata and controls

104 lines (63 loc) · 3.45 KB
Raw

Setup and installation

First of all, make a clone or fork of this repository and replace all occurrences of gatordata with a name of your choice.

Launch an EC2 instance

Start a "micro" Amazon EC2 instance and use one of the following AMIs, depending on where you chose to launch it:

  • US west: ami-ad7e2ee8
  • US east: ami-ccf405a5
  • EU west: ami-fb9ca98f
  • Asia Pacific (Singapore): ami-0c423c5e

These AMIs where taken from http://uec-images.ubuntu.com/releases/10.10/release/

Go with the defaults in the "wizard" presented. Chose to create a new key pair when asked and be sure to make a secure backup of the private key that you will download. A good place to put your private key is in ~/.ssh/gatordata.pem and then chmod 0600 ~/.ssh/gatordata.pem so no one else can read it but you.

When the instance is green and "started", log in to the machine:

ssh -i ~/.ssh/gatordata.pem ubuntu@XXX.amazonaws.com

Note: Replace XXX.amazonaws.com with the hostname or address of your instance.

Note: If you are running Microsoft Windows, which lacks an SSH client, see WINDOWS-SSH.md.

Install software

sudo apt-get update
sudo apt-get install nginx git-core daemon
sudo chown -R www-data:www-data /var/www

Node.js:

sudo apt-get install build-essential libssl-dev
cd
mkdir src
git clone https://github.com/joyent/node.git src/node
cd src/node
git checkout v0.4.11
./configure
JOBS=2 make
sudo make install

NPM:

sudo true && curl http://npmjs.org/install.sh | sudo sh

Checkout your source

sudo mkdir /var/gatordata
sudo chown www-data:www-data /var/gatordata
sudo chown -R www-data:www-data /var/gatordata

If your git repository is public (i.e. viewable by anyone):

sudo -Hu www-data git clone https://hirenj@github.com/hirenj/gator-data.git /var/gatordata

cd /var/gatordata

sudo -Hu www-data npm install

sudo apt-get install sqlite3

sudo -Hu www-data sqlite3 cached.db "select *"

Configure & start your services

Your Node.js web server:

sudo ln -s /var/gatordata/init.d/gatordata-httpd /etc/init.d/
sudo update-rc.d gatordata-httpd defaults
sudo invoke-rc.d gatordata-httpd start

Optional gatordata-processor:

sudo ln -s /var/gatordata/init.d/gatordata-processor /etc/init.d/
sudo update-rc.d gatordata-processor defaults
sudo invoke-rc.d gatordata-processor start

Configure Nginx

There are three different kinds of setups to chose from:

  1. gatordata-http -- HTTP only
  2. gatordata-https -- HTTPS with HTTP redirecting to HTTPS
  3. gatordata-https-http -- HTTPS and HTTP

If you are using HTTPS, make sure you have added your SSL certificate and key at /var/gatordata/ssl/ssl.crt and /var/gatordata/ssl/ssl.key.

Replace gatordata-https below with the configuration of your choice:

sudo ln -sf /var/gatordata/etc/nginx/sites-available/gatordata-https \
            /etc/nginx/sites-enabled/default
sudo invoke-rc.d nginx restart

Done

Your web app should now be operational.

Note that the programs gatordata-httpd and gatordata-processor are written in the Move programming language (like JavaScript but simpler). Learn more at movelang.org.

If everything works, continue by reading WORKFLOW.md