Migration des données de mm_wiki : procédure détaillée

Bien que la majorité de mes notes soient conservées sur des plateformes de blogs statiques, j’utilise un wiki auto-hébergé pour capturer rapidement certaines idées éphémères. Après plusieurs essais, j’ai adopté mm_wiki comme solution principale grâce à sa simplicité d’installation et d’utilisation.

mm_wiki stocke les contenus au format Markdown directement sur le disque, tandis que les métadonnées (utilisateurs, permissions, structuer du wiki, etc.) sont gérées via une base MySQL. Afin de garantir la pérennité des données en cas de panne serveur ou de corruption de la base, il est essentiel de sauvegarder régulièrement ces deux composants.

Sauvegarde des données existantes

  1. Export de la base MySQL
    Utilisez mysqldump pour exporter l’intégralité de la base, y compris la structure et les données : ``` mysqldump -u [utilisateur] -p [nom_base] > chemin/vers/sauvegarde.sql
    
     Exemple concret : ```
    $ mysqldump -u root -p mm_wiki > /backup/mm_wiki_bak.sql
    
  2. Archivage des documents Markdown
    Les fichiers du wiki sont stockés dans un répertoire dédié. Il suffit de le compresser : ``` $ tar -czf mm_wiki_docs.tar.gz /chemin/vers/mm_wiki_data
    
    

Installation de mm_wiki sur le nouvel hôte

Installez mm_wiki sur la machine cible en suivant la documentation officielle. Pour simplifier la restauration, veillez à utiliser :

  • le même nom de base de données,
  • le même chemin pour le répertoire de données.

L’installation se fait via une interface web interactive. Une fois terminée, vous obtenez une commande de lencement similaire à :

./mm-wiki --conf conf/mm-wiki.conf

et un accès via http://localhost:9898 (le port étant configurable lors de l’installation).

Restauration des données

La migration s’effectue en deux étapes :

  1. Restauration de la base de données
    Importez le dump SQL dans une base nouvellement créée (ou existante) : ``` $ mysql -u root -p mm_wiki < /backup/mm_wiki_bak.sql
    
     Assurez-vous que la base `mm_wiki` existe avant l’import.
    
  2. Déploiement des fichiers Markdown
    Extrayez l’archive dans le répertoire de données configuré dans mm-wiki.conf : ``` $ tar -xzf mm_wiki_docs.tar.gz -C /opt/mm_wiki/data/
    
     Vérifiez que les permissions du répertoire permettent à l’utilisateur exécutant mm\_wiki d’y accéder en lecture/écriture.
    
    

Lancez ensuite l’application :

./mm-wiki --conf conf/mm-wiki.conf

Pour un démarrage en arrière-plan :

nohup ./mm-wiki --conf conf/mm-wiki.conf > /dev/null 2>&1 &

Connectez-vous avec vos identifiants administrateur : tous les contenus et paramètres précédents devraient être présents.

Étiquettes: mm_wiki MySQL migration de données auto-hébergement Markdown

Publié le 13 août à 09h37