-
Notifications
You must be signed in to change notification settings - Fork 213
Installation
- Run locally
- Run tests
- Issues
- [Sam's ubuntu install notes from EC2](Installation#sams ubuntu install notes from ec2)
- [Pair Programming with screen/ec2 notes](Installation#pair Programming with screenec2 notes)
The simplest way to get started is to use Vagrant with VirtualBox. See the Vagrant Install instructions.
Another way to get started is to use Ubuntu with VirtualBox inside virtual machine (similar to VM used in CS169.x). See the Ubuntu Image Install instructions.
In order to work on LocalSupport, please fork and clone the project.
- Install Ruby 1.9.3-p484 (we haven't migrated to Ruby 2 yet)
- Fork the http://github.com/AgileVentures/LocalSupport repo (fork button at top right of github web interface)
- Clone the new forked repo onto your dev machine
cd LocalSupport
- Install Qt webkit headers - see capybara-webkit gem below
- Install postgreSQL - see PostgreSQL install instructions below
- Install X virtual frame buffer
sudo apt-get install xvfb
For Debian 7 users, please follow these instructions to launch Xvfb as daemon : (https://github.com/tansaku/LocalSupport/wiki/Xvfb-on-Debian-7)
git checkout develop
- Run
bundle install
to get the gems - Run the following to get the database set up and import seed data
bundle exec rake db:create
bundle exec rake db:migrate
bundle exec rake db:categories
bundle exec rake db:seed
bundle exec rake db:cat_org_import
bundle exec rake db:pages
bundle exec rake db:import:emails[db/emails.csv]
If you hit problems, review issues below, and ask us on Skype.
[Note that rvm can be extremely helpful for managing ruby versions. Installing rvm on Ubuntu]
and then in principle you can run rails server and see that app running locally.
The db/seeds.rb task that you ran added some organizations and a test user that you can experiment with. Read that file for more information.
Also you should run the specs and cucumber features to make sure your installation is solid. For confidence, you shall prepare the test database first by running
rake db:test:prepare
, then run tests using following commands:
bundle exec rake spec
bundle exec rake cucumber
and then when you start any BDD or TDD ensure autotest is running in the background:
bundle exec rake autotest
####Linux
sudo apt-get install libpq-dev
####OSX
Install the pg gem. You’ll need to include the following options to set your path and include the needed headers:
gem install pg -- --with-pg-config=/Applications/Postgres.app/Contents/Versions/9.3/bin/pg_config --with-pg-include='/Applications/Postgres.app/Contents/Versions/9.3/include/'
Note: before you run this, check that the paths for pg_config
and include
are correct, and adjust them as needed. Example: If your application is named Postgres93, then “Postgres.app” will need to be changed to “Postgres93.app” in both places.
install: http://postgresapp.com/
We recommend installing: http://postgresapp.com/
-
First error is usually "role 'postgres' does not exist (PG::ConnectionBad)"
-
Resolve this by running
CREATE USER postgres CREATEDB;
from the psql prompt (click the elephant icon and select "open psql" ORcreateuser -s -r postgres
from command line if you have psql in your path
Another error occurs on OSX without "host: localhost" in the database.yml
could not connect to server: No such file or directory Is the server running locally and accepting connections on Unix domain socket "/var/pgsql_socket/.s.PGSQL.5432"?
Postgres may have put its socket in an unexpected place, such as /private/tmp
, and it may be a hidden file. In this example below, we symlink it to where it needs to be.
sudo mkdir /var/pgsql_socket/
sudo ln -s /private/tmp/.s.PGSQL.5432 /var/pgsql_socket/
if psql doesn't run from the command line try: add export PATH="/usr/local/bin:$PATH"
to your .bash_profile
to make sure you are talking to the postgres.app that's installed rather than the non-running postgresql that comes with OSX
OSX no longer needs host: localhost in database.yml if you export PG_HOST=localhost
in .bash_profile
####Could not connect to server: No such file or directory
could not connect to server: No such file or directory
Is the server running locally and accepting
connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?
If you receive this error run
sudo apt-get install postgresql
####Peer authentication fails for user postgres
On Ubuntu, you will likely encounter an error with the following message:
authentication failed for user "postgres"
The underlying problem is that postgres is set up to authenticate postgresql usernames based on the Linux usernames. But your Linux user is not likely called "postgres" like the yml configuration is setup to login as on LS.
If you search around, you will likely find links telling you to change authentication methods and use a password. But you can actually stick with peer authentication and the little bit of added security of only having local connections by doing the following:
You must edit the pg_hba.conf file to use a map with peer authentication (more on this here[http://www.postgresql.org/docs/9.1/static/auth-username-maps.html]). The location of this file may vary depending on your installation but may be under /etc/postgresql/9.1/main/pg_hba.conf
(where 9.1 depends on your version). You should change the line in the file that reads as follows:
local all postgres peer
You want to edit it to be :
local all postgres peer map=basic
This will use a map called basic that you will set up next (you can change the name of the map as long as you change it in the next step as well).
Now you want to edit the file pg_ident.conf (same directory as the previous file) to include the following line:
basic saasbook postgres
This will map your Linux system name (in my example saasbook if you're using the VM) to the name expected by postgres.
You now need to restart the postgre service so that it takes to the new configuration. In the terminal run this command:
sudo /etc/init.d/postgresql restart
Now you should be able to locally authenticate with postgres and no password.
Alternatively, if you are not too concerned with security, you can just change the authentication type to trust:
# Database administrative login by Unix domain socket
local all postgres trust
# TYPE DATABASE USER ADDRESS METHOD
# "local" is for Unix domain socket connections only
local all all trust
# IPv4 local connections:
host all all 127.0.0.1/32 trust
# IPv6 local connections:
host all all ::1/128 md5
this will allow any local connection to the database to be established without a password.
You will likely encounter this error:
Installing rdoc (3.12.2) Invalid gemspec in [/usr/local/lib/ruby/gems/1.9.1/specifications/ZenTest-4.9.0.gemspec]: Illformed requirement ["< 2.1, >= 1.8"]
Resolution described here: http://stackoverflow.com/questions/15006181/zentest-errors-preventing-autotest-from-running/15006306#15006306 Also mentioned here with alternate solution https://github.com/seattlerb/zentest/issues/40 NOTE: stable fix appears to involve: "upgrade rubygems, uninstall zentest and reinstall zentest." (If you don't want to edit the gemspec file, you will need rubygems version 1.8.24 or later.)
If you use rvm, then the command to upgrade rubygems is
rvm rubygems current
One issue that someone has encountered is as follows:
I cloned the latest code on the github repo and running bundle install --without production seems to barf with many invalid gemspecs pointing to the 1.9.1 ruby installation seems I had to revert back to rubygem 1.8.24 And to get tests to pass, I had to run it via rake spec, which required editing gemfile to include 'rails-rspec' under :test, :development
As is suggested by starfry's comment on stackoverflow http://stackoverflow.com/questions/12159402/should-i-use-rake-spec-or-rspec-cant-get-rake-spec-to-work
... it seems to use development db when you run via spec
As per the documentation for rspec-rails,
It needs to be in the :development group to expose generators and rake tasks without having to type RAILS_ENV=test.
Another issue that has been encountered is the following:
lack of JS runtime when running rake db:create' to the project 'LocalSupport'.
The following stackoverflow link contains the solution which is to add the execjs and therubyracer gems to the Gemfile, although we are not yet clear why this error sometimes crops up ...
http://stackoverflow.com/questions/9057475/rake-dbcreate-could-not-find-a-javascript-runtime
The capybara-webkit
gem needs the Qt toolchain (including qmake and the webkit library and header files). You want version 4.8 or later. To install them in Ubuntu release 12.04 LTS "precise pangolin", or later, run:
sudo apt-get install libqtwebkit-dev
This command also works on Debian 7.
If you have an older version of Ubuntu, you can install a new version from scratch, or upgrade with sudo do-release-upgrade
. If on Amazon EC2, see (this article)[http://gregrickaby.com/safely-update-an-ubuntu-ec2-instance-on-amazon-aws/]
For other platforms, see http://qt-project.org/downloads.
Note that on Mac, even after performing the aforementioned install, you are likely to need to install something else to get the qmake
build tool. Install Homebrew, if you don't have it already, then run brew install qt
. Then you should be able to run gem install capybara-webkit -v '1.0.0'
successfully.
After that try running bundle install
again.
You will likely encounter this warning while running the specs and features. To solve this you need to run
bundle exec gem pristine nokogiri
What this basically does is that it recompiles the gem's C extensions. While running this, if you face the error ... you dont have write permissions ...
Run the command with sudo
sudo bundle exec gem pristine nokogiri
If, when you try to create database tables, you see errors like this
PG::InvalidParameterValue: ERROR: encoding UTF8 does not match locale en_GB
our notes on PostgreSQL problems in Debian may help you.
In 2014, David came across this error when running bundle install
(under rvm on Debian)
No source for ruby-1.9.3-p545 provided with debugger-ruby_core_source gem.
...
Make sure that `gem install debugger -v '1.6.1'` succeeds before bundling.
The fix seems to be simply to run
gem install debugger
bundle install
and repeat for any other gems that stop your bundle install task.
=======
sudo apt-get install ruby-dev
sudo apt-get install libpq-dev
sudo apt-get install libicu-dev
as well as some things above, and also need some xvfb as well
sudo apt-get install xvfb
Xvfb :1 -screen 0 1280x768x24 &
export DISPLAY=:1
Apparently one can search packages.ubuntu.com to see which packages are missing to run cucumber tests successfully we used:
bundle exec rake cucumber
Also we needed https://www.digitalocean.com/community/articles/how-to-install-ruby-on-rails-on-ubuntu-12-04-lts-precise-pangolin-with-rvm to get rvm sorted