16. How to


August 17th, 2017: Everything below this point is outdated.

16.1. Populate PostgreSQL Database

Load Socorro schema plus test products:

socorro setupdb --database_name=breakpad --fakedata --createdb

16.2. Create partitioned tables

Normally this is handled automatically by the cronjob scheduler crontabber but can be run as a one-off:

python socorro/cron/crontabber_app.py --job=weekly-reports-partitions --force

16.3. Populate Elasticsearch database


See the chapter about Elasticsearch for more information.

Once you have populated your PostgreSQL database with “fake data”, you can migrate that data into Elasticsearch:

python socorro/external/postgresql/crash_migration_app.py

16.4. Sync Django database

Django needs to write its ORM tables:

export SECRET_KEY="..."
cd webapp-django
./manage.py migrate auth
./manage.py migrate

16.5. Adding new products and releases

Each product you wish to have reports on must be added via the Socorro admin UI:


All products must have one or more releases:


Make sure to restart memcached so you see your changes right away:

sudo systemctl restart memcached

Now go to the front page for your application. For example, if your application was named “KillerApp” then it will appear at: