added warning for migration pages

docs/de/upgrades-und-umzuege/umzug-einer-installation-unter-linux.md

@@ -2,26 +2,25 @@
 
 In diesem Artikel beschreiben wir die generelle Vorgehensweise, um eine Installation von i-doit von einem GNU/Linux zu einem anderen umzuziehen. Der Umzug umfasst sowohl die Datenbanken, als auch die Dateien und Verzeichnisse.
 
-Vorbereitungen und Annahmen
----------------------------
+## Vorbereitungen und Annahmen
+
+??? warning "Beide Systeme müssen auf der gleichen i-doit Version sein!"
 
 Es sind ein paar Dinge zu beachten, um einen möglichst reibungslosen Umzug zu gewährleisten:
 
 1.  i-doit und optional installierte [i-doit pro Add-ons](../i-doit-pro-add-ons/index.md) sollten auf einem [aktuellen Stand](../wartung-und-betrieb/update-einspielen.md) sein.
 2.  Wir verändern das alte System nicht, um im Fall der Fälle schnell wieder in den Ursprungszustand zurückkehren zu können.
 3.  Die gezeigten Befehle passen zu einem aktuellen [Debian GNU/Linux](../installation/manuelle-installation/debian.md) und sollten an die entsprechende Umgebung angepasst werden. Blindes Ausführen der Befehle sollten vermieden werden.
 
-Neues System vorbereiten
-------------------------
+## Neues System vorbereiten
 
 Zunächst gilt es, das neue System so weit wie möglich vorzubereiten:
 
 1.  Das neue Betriebssystem entspricht den [Systemvoraussetzungen](../installation/systemvoraussetzungen.md) und ist auf einem aktuellen Stand.
 2.  Auf dem neuen Betriebssystem sind die [Systemeinstellungen](../installation/manuelle-installation/systemeinstellungen.md) konfiguriert worden.
 3.  Gängige [Sicherheitsmaßnahmen](../wartung-und-betrieb/sicherheit-und-schutz.md) wurden durchgeführt.
 
-Altes System außer Betrieb nehmen
----------------------------------
+## Altes System außer Betrieb nehmen
 
 Das alte System sollte bereits während des Umzugs nicht mehr produktiv verwendet werden:
 
@@ -32,8 +31,7 @@ Das alte System sollte bereits während des Umzugs nicht mehr produktiv verwende
 
         sudo systemctl stop apache2.service
 
-Dateien und Verzeichnisse umziehen
-----------------------------------
+## Dateien und Verzeichnisse umziehen
 
 1.  Wir kopieren das gesamte Installationsverzeichnis von i-doit vom alten auf das neue System. Das Verzeichnis befindet sich in vielen Fällen unter /var/www/html/. Beispiel mit SSH, wobei i-doit im Verzeichnis /var/www/html/i-doit/ zu finden ist:
 
@@ -58,8 +56,7 @@ Dateien und Verzeichnisse umziehen
         ls -lha /var/www/html/i-doit/.htaccess
 
 
-Datenbanken umziehen
---------------------
+## Datenbanken umziehen
 
 1.  i-doit benötigt mindestens 2 [Datenbanken](../software-entwicklung/datenbank-modell/index.md). Von jeder einzelnen sollte auf dem alten System ein Dump erstellt werden:
 
@@ -105,8 +102,8 @@ Datenbanken umziehen
 
     Das obige Passwort für den Benutzer idoit sollte deckungsgleich mit den Angaben in der Datei /var/www/html/i-doit/src/config.inc.php sein.
 
-Nachbereitung
--------------
+## Nachbereitung
+
 
 1.  DNS-Einträge, IP-Adressen, Hostnames etc. sollten im Nachgang angepasst werden, damit i-doit wie gewohnt erreichbar ist.
 2.  Schnittstellen zu Drittsystemen können nun wieder aktiviert werden. Die Funktionen sollten geprüft werden.

docs/de/upgrades-und-umzuege/umzug-von-windows-zu-linux.md

@@ -4,6 +4,8 @@ Es mag gute Gründe geben, i-doit unter [Windows](../installation/manuelle-insta
 
 ## Vorbereitungen und Annahmen
 
+??? warning "Beide Systeme müssen auf der gleichen i-doit Version sein!"
+
 Bevor es los geht, sollten ein paar Dinge beachtet werden. Ziel soll sein, ohne lange Downtime und vor allem ohne Datenverlust den Umzug zu wagen.
 
 Jeder, der mit den Daten von i-doit arbeitet, sollte rechtzeitig über den Umzug informiert werden. Nichts ist schlimmer als wütende Kollegen, deren Arbeit unterbrochen wurde.

docs/en/upgrades-and-migrations/migration-from-windows-to-linux.md

@@ -2,8 +2,9 @@
 
 There may be good reasons to operate i-doit in [Windows](../installation/manual-installation/microsoft-windows-server/index.md). However, due to various reasons we recommend the use of [Linux](../installation/manual-installation/debian.md). But how do we transfer the well-established [IT-documentation](../glossary.md) in an ongoing operation from one system to another as smooth as possible?
 
-Preparation and Assumptions
----------------------------
+## Preparation and Assumptions
+
+??? warning "Both systems have to be on the same i-doit version"
 
 Before starting, a few things should be kept in mind. The objective is to migrate without a long downtime and especially without data loss.
 
@@ -17,8 +18,7 @@ Finally, we assume the new home system of i-doit is already prepared, all [syste
 
 One more thing: You should have all system accounts and passwords ready, which are used on the old as well as on the new system. These include MySQL system users (root) and the i-doit user for MySQL (by default i-doit).
 
-Export Data from Windows
-------------------------
+## Export Data from Windows
 
 First and foremost we take care of securing the data of the old system in order to transfer them to the new system:
 
@@ -35,8 +35,7 @@ First and foremost we take care of securing the data of the old system in order
 4.  Now we stop the MySQL process and hope that neither MySQL nor the Apache Webserver are needed ever again in Windows.
 
 
-Migrate Data to GNU/Linux
--------------------------
+## Migrate Data to GNU/Linux
 
 After copying both the ZIP file, including the i-doit folder, and the SQL file, including the database contents, onto the new server ([WinSCP](http://winscp.net/eng/index.php) serves this purpose well), we connect via SSH (for example via [Putty](http://www.putty.org/)) and operate in the command line from now on. The Apache Webserver, MySQL and PHP are fully configured and all needed packages are properly [installed](../installation/index.md). The only thing missing is i-doit:
 
@@ -75,8 +74,7 @@ After copying both the ZIP file, including the i-doit folder, and the SQL file,
 5.  We close the MySQL client with the exit; command or by pressing CTRL+D .
 
 
-Files
------
+## Files
 
 1.  We extract the ZIP file in the desired location. In [Debian GNU/Linux](../installation/manual-installation/debian.md) this would be in /var/www/html/:
 
@@ -99,8 +97,7 @@ Now it is time for a first big test: Can the new home of i-doit be opened via th
 
 What is left is the transfer of the Windows tasks to Cronjobs. Most of the time the [i-doit controller (CLI)](../automation-and-integration/cli/index.md) has to do recurring tasks. If you didn't set up any Tasks/Cronjobs for i-doit yet, then you should do it now.
 
-Follow-up Work
---------------
+## Follow-up Work
 
 Following this migration, you should run various tests and reactivate the interfaces between i-doit and third-party tools. It is also important to have the [backups](../maintenance-and-operation/backup-and-recovery/index.md) running. If all tests are successful (which can hopefully be presumed), the maintenance mode can be concluded and all colleagues be informed that the IT-documentation is available again.
 

docs/en/upgrades-and-migrations/migration-of-an-installation-under-linux.md

@@ -2,26 +2,25 @@
 
 This article focuses on the general procedure to migrate an i-doit installation from one GNU/Linux to another one. The migration includes databases as well as files and directories.
 
-Preparation and Assumptions
----------------------------
+## Preparation and Assumptions
+
+??? warning "Both systems have to be on the same i-doit version"
 
 You have to observe a few things to guarantee a smooth migration:
 
 1.  i-doit and optional [add-ons](../i-doit-pro-add-ons/index.md) should be [up to date](../maintenance-and-operation/update.md).
 2.  No changes should be made to the old system, so that we are able to return quickly to the original status when trouble strikes.
 3.  The commands shown here apply to a current [Debian GNU/Linux](../installation/manual-installation/debian.md) and should be modified in correspondence with the environment. Avoid a blind approach regarding the execution of commands.
 
-Preparation of the New System
------------------------------
+## Preparation of the New System
 
 First of all, it is necessary to prepare the new systems as far as possible by observing the following:
 
 1.  The new operating system meets the [system requirements](../installation/system-requirements.md) and is up to date.
 2.  The [system settings](../installation/manual-installation/system-settings.md) have been configured on the new operating system.
 3.  The usual [security measures](../maintenance-and-operation/security-and-protection.md) have been carried out.
 
-Closing Down the Old System
----------------------------
+## Closing Down the Old System
 
 The old system should not be used productively during the migration process anymore:
 
@@ -33,8 +32,7 @@ The old system should not be used productively during the migration process anym
         sudo systemctl stop apache2.service
 
 
-Migration of Files and Directories
-----------------------------------
+## Migration of Files and Directories
 
 1.  We copy the complete i-doit installation directory from the old system to the new system. In many cases, the directory is located under /var/www/html/. Here is an example with SSH, where i-doit can be found in the directory /var/www/html/i-doit/.
 
@@ -59,8 +57,7 @@ Migration of Files and Directories
         ls -lha /var/www/html/i-doit/.htaccess
 
 
-Migration of Databases
-----------------------
+## Migration of Databases
 
 1.  i-doit requires at least two [databases](../software-development/database-model/index.md). You should create a dump of each database on the old system:
 
@@ -107,11 +104,10 @@ Migration of Databases
     The above password for the idoit user should be identical with the details in the file /var/www/html/i-doit/src/config.inc.php.
 
 
-Follow-up Work
---------------
+## Follow-up Work
 
 1.  Afterwards, you should adapt DNS entries, IP addresses, host names etc., so that i-doit can be accessed as usual.
 2.  Now interfaces to third-party systems can be reactivated. The functions should be checked.
 3.  Reactivate cronjobs and test them.
 4.  Set up [backups](../maintenance-and-operation/backup-and-recovery/index.md) and test them.
-5.  When the Web GUI reacts as usual and all data are available in i-doit, the migration was successful.
+5.  When the Web GUI reacts as usual and all data are available in i-doit, the migration was successful.