*`MariaDB Client 10.1`, `MySQL Client 5.5`, or later versions. In the case of
*`MariaDB Client 10.1`, `MySQL Client 5.5`, or later versions. MySQL 5.6 is recommended.
MySQL, version 5.6 is recommended.
## Configuration
## Create the configuration
* Run `./configure`. For the default values and the meaning of these default values see [config.defaults](config.defaults). The `configure` script also promts for a (new) user password. Remember that one, since it will be the password of the mysql user which is used by the caosdb server.
* Run `./configure`. For the default values and the meaning of these default
* If there is no `mysql-config-editor` (`MySQL 5.5`. and `MariaDB`) then the user is promted for the `MYSQL_USER_PASSWORD`, that is the password of the `MYSQL_USER`. The plain password is stored in the `.config` file. So make sure nobody else can read it.
values see [config.defaults](config.defaults). The `configure` script also
* If you are using MariaDB and your `root` user uses pam authentication, no pasword string is required. When promted for the `MYSQL_USER_PASSWORD` just leave it blank and hit enter. But you need be login as root for the installation and upgrade process.
prompts for a (new) user password. Remember that one, since it will be the
password of the mysql user which is used by the caosdb server. Upon succesful
## Install
completion, the `configure` script writes the configuration to `.config`.
* If there is no `mysql-config-editor` (`MySQL 5.5`. and `MariaDB`) then the
* Run `make install`. If a there is a database with the name you have choosen during the configuration, you need to reconfigure or delete the database first.
user is prompted for the `MYSQL_USER_PASSWORD`, that is the password of
the `MYSQL_USER`. The plain password is stored in the `.config` file. So
## Upgrade
make sure nobody else can read it.
* If you are using MariaDB and the `root` database user uses pam authentication,
* Run `make upgrade`. Upgrades the database to the last version.
no pasword string is required. When prompted for the `MYSQL_USER_PASSWORD`
just leave it blank and hit enter. But you need be login as root for the
installation and upgrade process.
## Setup the SQL database for CaosDB
* Run `make install`. If a there is a database with the name you have choosen
during the configuration, you need to reconfigure or delete the database
first.
## Upgrade the SQL database
* Run `make upgrade`. This upgrades the database to the last version.
## Drop Database
## Drop Database
* If you want to delete your database, run `make drop-$DATABASE_NAME`. **Use this with caution!!!** If you did not backup your database, **everything will be lost afterwards.** And no, there is no addional promt "Are you sure, that you want to do this?". If you do this, you *actually* do this.
* If you want to delete your database, run `make drop-$DATABASE_NAME`. **Use
this with caution!!!** If you did not backup your database, **everything will
be lost afterwards.** And no, there is *no* additional prompt to ask if you
are sure. If you `make drop-...`, you *actually* delete the database.
