Administering Aggregate

Click the Log In link in the upper right corner of the screen to be presented with the Log onto Aggregate screen. Choose the Sign in with Aggregate password button and enter the super-user username you specified within the installer. The initial password for this account is aggregate. When you log in, Site Admin will be visible to you.

Tip

When signing in with this method, if you do not enter the password correctly, you may need to close all your browser windows and quit your browser before you can try again.

Warning

If the instance name of the server changes (the installer asks for this name), then the passwords for all ODK Aggregate usernames will no longer be valid and the super-user username's password will be reset to aggregate. In this case, you should log in, change the super-user's password, and change the passwords for all of your ODK Aggregate usernames.

Permissions

Warning

Remember to change the default password of your super-user account. Otherwise, anyone can take complete control of your server!

You can manage the credentials to access Aggregate in the Site Admin > Permissions sub-tab.

Privileges are as follows:

  • Data Collector: able to download forms to ODK Collect and submit data from ODK Collect to ODK Aggregate.
  • Data Viewer: able to log onto the ODK Aggregate website, filter, view, and export submissions.
  • Form Manager: all the capabilities of a Data Viewer plus the abilities to upload a form definition, delete a form and its data, and upload submissions manually through the ODK Aggregate website.
  • Site Administrator: all the capabilities of a Form Manager plus the ability to add users, set passwords, and grant these capabilities to other users.

You can also download a .csv template file with all the credentials and upload it to make changes in bulk.

Remember to click Save Changes to make these changes take effect. You can also edit the privileges for current users.

Preferences

In the Preferences sub-tab under Site Admin tab, you can manage:

  • Google API credentials: These credentials are used when publishing into Google services. For details on this, see Aggregate OAuth2 info.
  • Enketo credentials: These credentials are used for Enketo webforms integration. To link Enketo with Aggregate, see this.
  • Aggregate features: These settings affect the operations of the server.
    • Skip malformed submissions - check this to ignore corrupted submissions.