From 5b6f47eb8994e5c1826d1d6aff98703aafb94057 Mon Sep 17 00:00:00 2001
From: andryyy <andre.peters@debinux.de>
Date: Sun, 10 Oct 2021 15:35:13 +0200
Subject: [PATCH] add debug-mysql_aria.md

---
 docs/debug-mysql_aria.md | 22 ++++++++++++++++++++++
 mkdocs.yml               |  1 +
 2 files changed, 23 insertions(+)
 create mode 100644 docs/debug-mysql_aria.md

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'