Notes for running non-default Goiardi setups
============================================

By default, the goiardi Debian package will start the chef server without
a RDB storage backend. Data is stored in memory and, unless it's dumped to
disk, it is lost when goiardi is terminated.

Goiardi can use PostgreSQL or MariaDB/MySQL to store data. This is recommended
on production environments.

Setting up Goiardi with PostgreSQL
----------------------------------

To get Goiardi to use PostgreSQL as its storage backend, do the following:

 * Install "postgresql"
 * Create a user and a database for goiardi ("goiardi" assumed from now on).
 * Use the `psql` client to populate the database with the provided schemas
   in /usr/share/goiardi/sql-files.
 * Edit /etc/goiardi/goiardi.conf, and set `use-postgresql` to true.
   Update the [postgresql] section with your username, password and database
   name.
 * Restart Goiardi via `service goiardi restart`.

Setting up Goiardi with MariaDB/MySQL
-------------------------------------

To get Goiardi to use MariaDB/MySQL as its storage backend, do the following:

 * Install "default-mysql-server"
 * Create a user and a database for goiardi ("goiardi" assumed from now on).
 * Use the `mysql` client to populate the database with the provided schemas
   in /usr/share/goiardi/sql-files.
 * Edit /etc/goiardi/goiardi.conf, and set `use-mysql` to true.
   Update the [mysql] section with your username, password and database
   name.
 * Restart Goiardi via `service goiardi restart`.