Support

Documentation

The databaseInfo section

Required: Yes; this section is mandatory

Scope: UNITE needs to know how to connect to your MySQL database so that it can restore the database(s) dumped during backup time. The databaseInfo section does exactly that.

This section has subsections, one subsection per database you are restoring.

They key of each subsection corresponds to the base name of the database SQL dump file. For the main database of your site the key is always site:

databaseInfo:
  site:
    # Your database configuration goes here.

The extra databases are dumped using short UUID's as their base name which typically look like ABCD123-databasename.sql. In this case, the key needs to be the base name of the dump file, i.e. ABCD123-databasename in this example.

The best way to figure out which database is dumped under which name is to take a look at the databases.ini file in the installation/sql directory inside the archive. To do that, simply take one backup of the site and extract it using Kickstart on a secondary server or your computer, without clicking on the Run the Installer button. Then, navigate to the extracted installation/sql directory and open the databases.json file in your text editor. Each top level key is the base name of a dump file. You can use that as your “cheat sheet” when creating the subsections of the databaseInfo section for UNiTE.

Each subsection contains the configuration keys you see in the database options reference.