Installation Instructions

On this page:

Installation Instructions

Install and Set up Postgres

Install postgres and libpq-dev:

$ sudo apt-get install postgresql
$ sudo apt-get install libpq-dev

Set up access control:
- Find the pg_hba.conf file:
```
$ sudo -u postgres psql
> show hba_file;
> \q
```
- Edit the pg_hba.conf file, and change the line starting with "local" to "local" "all" "all" "trust"
Restart postgres:
```
$ sudo /etc/init.d/postgresql restart
```

Create the Django DB user (right now it’s 'ampcrowd'):

$ sudo -su postgres
$ createuser --superuser ampcrowd
$ exit
$ psql -u sampleclean
> \password
> (Enter 'ampcrowd')
> \q

Create a database (right now it’s 'ampcrowd'):
```
$ createdb -O ampcrowd -U ampcrowd ampcrowd
```

Install RabbitMQ

$ sudo apt-get install rabbitmq-server

Set up your python environment and install requirements

Set up a vritual environment for python development (I like virtualenvwrapper).
Install the python requirements:
```
$ pip install -r requirements.txt
```

Set up Amazon Mechanical Turk access

(Skip this step if you don’t want to run tasks on AMT.)

Create your own private settings file:

$ cp ampcrowd/crowd_server/private_settings.py.default ampcrowd/crowd_server/private_settings.py

Sign up for a mechanical turk account, and put the credentials in private_settings.py NEVER CHECK THIS FILE INTO THE REPO.

Set up the database and run the server

Reset the database:
```
$ ./scripts/reset_db.sh
```

Run the server:

$ ./scripts/run.sh    # Daemon mode
$ ./scripts.run.sh -d # Debug mode
$ ./scripts.run.sh -s # Use ssl (can be combined with -d)

Make sure it works:
1. Run the sample script to create a couple of sample HITs on AMT, and a couple of hits locally:
```
$ ./scripts/post.py -c amt internal -t TASK_TYPES
```
  TASK_TYPES can be 1 or more of ‘sa’, ‘er’, ‘ft’, as described in the User API documentation.
2. Log into the AMT management interface (https://requestersandbox.mturk.com/mturk/manageHITs) and verify that you have just created the sample HITs.
3. Log in as a worker (https://workersandbox.mturk.com/mturk/searchbar) and verify that you can accept the HIT and that it displays correctly in AMT’s iframe. (Note: crowd server must be running with SSL in order to view tasks on AMT).
4. Pull up the internal crowd interface to verify that the tasks have been created and can be completed.

To stop the server:

$ CTRL-C             # if you ran in debug mode
$ ./scripts/stop.sh  # to clean up stray processes regardless