Ubuntu 12.04 Setup Issues

[ldodds]

Notes/issues on getting setup on Ubuntu 12.04. Can later be turned into improvements in setup.rb.

Mongo

• Install mongodb using up to date packages
• Import a copy of mongo database for development, download and unpack a mongo export into a dump directory, then:

cd dump
mongorestore --db govuk_assets_development --drop ./govuk_assets_development
mongorestore --db govuk_content_development --drop ./govuk_content_publisher

Prax

• Use [Prax|(https://github.com/ysbaddaden/prax) instead of Pow. It installs a system service which will route .dev domains to prax, but you must also run prax manually, e.g:

PRAX_LOG_ROOT=/tmp PRAX_DEBUG=1 /path/to/prax/bin/prax start --foreground.

Logs go into ~/.prax/_logs

• For capybara-webkit to install properly (in bundle install publisher) run:

sudo apt-get install qt4-qmake libqtwebkit-dev

• Install a JS runtime for asset-manager

sudo apt-get install nodejs

Installation

• Remove people, frontend, frontend-news, frontend-www, frontend-courses from projects hash in setup.rb.
• Edit the make_env. script and remove the IP lookup, you want DOMAIN="dev" not a xip.io based address. If you don't do this then you will need to fix up the application urls in the sign on app (Doorkeeper::Application)
• You'll need to capture the sign-up urls for the alice and bob users which should be output to the console during the setup. You'll need these later
• The Quirkafleeg setup.rb script will install all the apps as system services (config in /etc/init) on Ubuntu, but we don't want that, so best to remove those afterwards
• setup.rb assumes non-Mac hosts are using nginx, so there will be some errors unless you have it installed. Looks like these are safe to ignore though as we will be using Prax.
• Change quirkafleeg/env so that vars have following values:

GOVUK_APP_DOMAIN=dev
DEV_DOMAIN=dev
STATIC_DEV=http://static.dev
GOVUK_ASSET_ROOT=static.dev

Prax Config

• Prax has trouble starting apps unless it can determine the gemset, I've found setting a .ruby-version seems to work, e.g. each project directory run: rvm-prompt >.ruby-version
• From each project directory call:

/path/to/prax/bin/prax link .

• Visit the invitation links to finish setting up alice and bob users. If you didn't have these then grab the invitation_code from the sign-on database for those Users using the rails console and visit signon.dev/users/invitation/accept?invitation_token=THE_CODE

All that appears to be working. The initial hit to www.dev seems slow which may be caused by this.

[mnowster]

Need to also:

$ sudo apt-get install imagemagick

else image uploading in asset-manager won't work, it'll fail silently leaving you wondering what's not working.