Migration of configs.json from version 2.x to version 3.0.0🔗

Clone the current master portal Git repository (if not yet available).

git clone https://bitbucket.org/geowerkstatt-hamburg/masterportal.git

Check out the current Masterportal 3.0.0 development branch via Git.
```
git checkout dev
```
Help for use is displayed if the help parameter is specified.
```
npm run migrateConfig help
```
Certain packages with specific versions are mandatory for the migration. These include Node.js and npm with the version numbers defined in the package.json. In Masterportal version 3.13.0, it states::
```
  "engines": {
    "node": "^22.19.0",
    "npm": "^10.5.0"
  }
```
To check whether the packages are already installed and which versions are being used, the following commands can be executed:
```
npm -v
```
```
node -v
```
If these versions are not correct, the correct versions can be installed using the following commands:
```
npm install -g npm@10.5.0
```
```
npm install -g node@22.19.0
```
MigrateConfig script without parameters: The information in the console guides you through the file conversion. You will be asked for the paths of the portal to be migrated.
```
npm run migrateConfig
```

First, the portal folder of the portal to be migrated must be specified (here testportal_v2) with path.The source file config.json must be located in the folder.

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

You will then be asked to enter the destination folder (here: testportal_v3).

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

Call MigrateConfig with parameters.

Migration of one portal:

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

Migration of several portals: a folder containing several portals is specified. ATTENTION: the config.json files of the portals will be overwritten!
```
npm run migrateConfig source=portal dest=portal
```