• Name: MariaDB
  • Category: Database

​
Configuration

Configu needs to be authorized to access your MariaDB database. Configu utilizes TypeORM under the hood to establish a connection with the database using data source options you need to supply.

​
Usage

​
.configu store declaration

stores:
  my-store:
    type: mariadb
    configuration:
      host: localhost
      username: test
      password: test
      database: test

​
CLI examples

​
Upsert command

configu upsert --store "my-store" --set "test" --schema "./start.cfgu.json" \
    -c "GREETING=hey" \
    -c "SUBJECT=configu"

​
Eval and export commands

configu eval --store "my-store" --set "test" --schema "./start.cfgu.json" \
 | configu export

​
Common errors and solutions

  1. Connection timeout troubleshooting
    • Solution: Increase the connectTimeout or acquireTimeout in the configuration options to handle long-running connection setups. Make sure the database is reachable from your application.
  2. Authentication failures
    • Solution: Verify that the provided username and password are correct, and that the user has the necessary permissions to access the specified database. Use a MariaDB client to manually confirm the credentials.
  3. SSL Certificate issues
    • Solution: Ensure the correct paths for SSL certificates are provided if ssl is enabled. Verify that the certificates match the MariaDB server’s configuration.
  4. Database permissions problems
    • Solution: Ensure that the database user has the required READ and WRITE permissions for the config_store table. Use the following SQL command to grant permissions:
    GRANT ALL PRIVILEGES ON config_store.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;

​
References