2. Advanced options

Congratulations! You are done setting up a LivingLabs API including database, dashboard, sites and clients. Now, we will show some more advanced options to customize your environment.

2.1. Create users

If there is a Dashboard running, you can create participants by choosing Register on the Dashboard. It is also possible to create users via the command line, this also enables you to create site and admin users.

To create an example participant and a site (for development/testing purposes), you can run the following script (without -c config/db.ini for an unauthenticated setup):

$ ./bin/admin user -c config/db.ini config/example-data/site.ini --password CHOOSEAPASSWORD
$ ./bin/admin user -c config/db.ini config/example-data/user.1.ini --password CHOOSEAPASSWORD

The passwords are used for the Dasboard.

In return, you will see two API keys, one for a site and one for a participant. Record the keys as SITEKEY and PARTICIPANTKEY, you’ll need them for the clients.

Instead, you can also provide your own details, or perform actions like deleting users and making users admin. See the help on how to do that:

$ ./bin/admin user -h

Do not forget to supply the configuration file as an argument, this gives the API the credentials to log in to the MongoDB database.

2.2. Export the database

You can export the database to create a human-readable json fixture, like the one we use to fill the database. To create a fixture in the dump directory, issue (without -c config/db.ini for an unauthenticated setup):

$ ./bin/admin db --export-json dump -c config/db.ini

2.3. Reset the Database

In case you need a reset, you can simply run this (without -c config/db.ini for an unauthenticated setup). But, BE CAREFUL, it can not be undone (or, probably it can, the MongoDB is journalled, but it will not be trivial).

$ ./bin/admin db --clear -c config/db.ini

Do not forget to recreate users (see above).

2.4. Remove all runs for a participant

There can be cases where you may want to remove all runs for a certain participant. For example, if a participant has a ranking algorithm which is not competitive, it will only take user impressions from the other participants. The participant could then request you as administrator to remove the runs.

The admin tool has a --remove-runs option to accomplish this. Supply the key of the participant for which you want to remove all runs. (without -c config/db.ini for an unauthenticated setup)


All runs for the given participant will be removed from the query collection! Sites will thus not be able to find rankings from this participant when looking for a query. The runs are still available in the run collection, but they are not easy to look up from there.

$ ./bin/admin user --remove-runs -c config/db.ini --key KEY