Skip to content
This repository has been archived by the owner on Jan 23, 2024. It is now read-only.

Home

Jump to bottom
dantehicks edited this page Jul 31, 2013 · 13 revisions

Welcome to the code-for-america wiki!

Ubuntu Installation

Capybara webkit

The biggest issue Ubuntu users face is building the capybara-webkit gem. This continues to be discussed as issue 513 at the capybara-webkit page here. A common solution is to compile the QT libraries from source. Please note that the following process can take 3 - 4 hours.

Download Qt libraries 4.8.5 for Linux/X11 here.

Follow instructions here and complete steps 1 - 3.

For step 4, before the following lines are added to ~/.profile

PATH=/usr/local/Trolltech/Qt-4.8.5/bin:$PATH
export PATH

verify if ~/.bash_profile or ~/.bash_login exist. If they do, then the lines belong there since the system is not reading ~/.profile

Deploying the Application

In addition to the typical push to heroku and db setup. The following must be done:

  1. Run the rake task, cache_civic_commons_application_data. This task retrieves application data from civic commons.
  2. Create a remote heroku instance, heroku create. Then deploy to the heroku instance, git push heroku master.
  3. Create an admin user via the sign up page. Then toggle that user's admin flag manually via the heroku console.
  4. Setup the heroku add-on Heroku Scheduler: For running the rake task, cache_civic_commons_application_data. The frequency of running it is based on how often you may think data on civic commons is updated.
  5. Setup the heroku add-on Sendgrid: For allowing the system to send out emails
  6. Setup the heroku add-on Websolr: For enabling full text search on a variety of forms.
  7. Edit the facebook_app_id in config/social_networks.yml under production with your facebook application id.
  8. You can change the twitter account that is mentioned by default by going to app/views/deployed_applications/_social_network_modal.html.erb and editing the data-via attribute of the twitter link.

You must also be sure that the S3_SECRET environment variable is set as well.

Administering the Application

You cannot add a deployed application in the admin panel. The 'Add New' button is on the deployed application but it will not work because a deployed application needs to have the context of what application its deploying.

Clone this wiki locally