Configuring the database

About MongoDB

MongoDB is a database used for its schema flexibility.

DB Specific Features

AVAA Toolkit has many features unlocked by connecting a database:

• Users management
• DB auth and logging
• Files upload
• Session persistence
• Server documents
• Shared corpus
• Versioning
• Conversions history

DB Configuration

By default, AVAA will try to connect to the mongodb server on localhost.

A specific avaa-toolkit database is used to hold the necessary collections:

• users contains the different users
• documents stores the server documents
• tickets keeps all results of conversions
• rpc holds the logs of calls to the server
• tokens for token related activity such as upload requests

There is actually nothing to configure as it is automatically handled.

DB Admin User

However currently, setting up a first admin user is required, to create and manage other users.

Use the mongoshell utility to connect to the mongodb server, and select the database:

> use avaa-tookit

switched to db avaa-toolkit

then create a new user:

> db.users.insert({id:'admin', admin:true})

WriteResult({ "nInserted" : 1 })

After the toolkit is restarted (and configured for db login), it should be possible to login as admin, and then set a password in the profile section.