Migration der configs.json von Version 2.x zu Version 3.0.0🔗

Klonen des aktuellen Masterportal Git Repositories (falls noch nicht vorhanden).
```
git clone https://bitbucket.org/geowerkstatt-hamburg/masterportal.git
```
Auschecken des aktuellen Masterportal 3.0.0 Entwicklungsbranches per Git.
```
git checkout dev
```
Eine Hilfe zur Benutzung wird ausgegeben, wenn der Parameter help angegeben ist.
```
npm run migrateConfig help
```
Für die Migration sind gewisse Packages auf gewissen Versionen zwingend erforderlich. Dabei handelt es sich um node und npm mit den in der package.json definierten Versionsnummern. In der Masterportal Version 3.13.0 steht dort:
```
  "engines": {
    "node": "^22.19.0",
    "npm": "^10.5.0"
  }
```
Ob die packages schon installiert sind und auf welcher Version lässt sich über folgende Befehle herausfinden:
```
npm -v
```
```
node -v
```
Falls diese Versionen nicht korrekt sind, lassen sich die korrekten Versionen mit folgenden Befehlen installieren:
```
npm install -g npm@10.5.0
```
```
npm install -g node@20.19.0
```
MigrateConfig script ohne Parameter: Die Angaben in der Konsole leiten durch die Dateikonvertierung. Es wird nach den Pfaden des zu migrierenden Portals gefragt.
```
npm run migrateConfig
```

Zuerst muss der Portalordner des zu migrierenden Portals angegeben werden (hier testportal_v2) mit Pfadangabe. In dem Ordner muss sich die Ausgangsdatei config.json befinden.

masterportal@3.0.0 migrateConfig
node devtools/tasks/migrator/migrate.js

The paths to the portal or folder with portals must start from "[...]/masterportal/")!
? source path to the portal or folder with portals to migrate:
 (portal/master) portal/testportal_v2

Anschließend wird um die Angabe des Zielordners (hier: testportal_v3) gebeten.

? destination path to store the migrated portal(s):
 (portal/destination)portal/testportal_v3

MigrateConfig mit Parametern aufrufen.

Migration eines Portals:

npm run migrateConfig source=portal/testportal_v2 dest=portal/testportal_v3

Migration mehrerer Portale: es wird ein Ordner der mehrere Portale enthält angegeben. ACHTUNG: die config.json-Dateien der Portale werden überschrieben!
```
npm run migrateConfig source=portal dest=portal
```