diff --git a/docs/debug-mysql_aria.md b/docs/debug-mysql_aria.md new file mode 100644 index 000000000..eb5ebad75 --- /dev/null +++ b/docs/debug-mysql_aria.md @@ -0,0 +1,22 @@ +## MariaDB: Aria recovery after crash + +If your server crashed and MariaDB logs an error similar to `[ERROR] mysqld: Aria recovery failed. Please run aria_chk -r on all Aria tables (*.MAI) and delete all aria_log.######## files` you may want to try the following to recover the database to a healthy state: + +Start the stack and wait until mysql-mailcow begins to report a restarting state. Check by running `docker-compose ps`. + +Now run the following commands: + +``` +# Stop the stack, don't run "down" +docker-compose stop +# Run a bash in the stopped container as user mysql +docker-compose run --rm --entrypoint '/bin/sh -c "gosu mysql bash"' mysql-mailcow +# cd to the SQL data directory +cd /var/lib/mysql +# Run aria_chk +aria_chk --check --force */*.MAI +# Delete aria log files +rm aria_log.* +``` + +Now run `docker-compose down` followed by `docker-compose up -d`. diff --git a/mkdocs.yml b/mkdocs.yml index aa3351e2d..2faf71486 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -52,6 +52,7 @@ nav: - 'Attach a Container': 'debug-attach_service.md' - 'Reset Passwords (incl. SQL)': 'debug-reset_pw.md' - 'Manual MySQL upgrade': 'debug-mysql_upgrade.md' + - 'Recover crashed Aria storage engine': 'debug-mysql_aria.md' - 'Remove Persistent Data': 'debug-rm_volumes.md' - 'Common Problems': 'debug-common_problems.md' - 'Admin login to SOGo': 'debug-admin_login_sogo.md'