Aktualisierung von Mapbender auf eine neuere Version

Um Mapbender zu aktualisieren, müssen Sie die folgenden Schritte durchführen:

  • Laden Sie die neueste Version herunter.

  • Sichern Sie Ihre Konfigurationsdateien (parameters.yml für Versionen < 4.0.0 bzw. .env.local für Versionen >= 4.0.0, und die Dateien im Verzeichnis config/packages) und Ihre alte Mapbender Version (Dateien und Datenbank).

  • Ersetzen Sie die Dateien durch die neuen Mapbender-Dateien.

  • Vergleichen Sie die Konfigurationsdateien und prüfen diese auf neue Parameter und Änderungen.

Warning

Wenn Sie auf die Mapbender-Version 4 umsteigen, beachten Sie vor dem Upgrade der Datenbank unbedingt den Hinweis im Migrationsleitfaden!

  • Aktualisieren Sie Ihre Mapbender-Datenbank.

  • Übernahme Ihrer Screenshots: Kopieren Sie die Dateien Ihrer alten Mapbender Version von /public/uploads/ (web/uploads für Versionen < 4.0.0) in das /public/uploads-Verzeichnis Ihrer neuen Mapbender Version.

  • Wenn Sie Ihre eigenen Templates verwenden sollten, müssen Sie diese mit denen der neuen Version vergleichen (kam es zu Änderungen?).

  • Druck Templates: Kopieren Sie eventuell selbst erstellte Drucktemplates zurück unter config/MapbenderPrintBundle/templates/.

  • Importieren Sie die Demo-Anwendungen: über den Befehl bin/composer run reimport-example-apps oder über die Web-Administration, um sich den neusten Stand der Entwicklungen anzuschauen.

  • Unter Entpacken und im Webserver registrieren ist beschrieben, wie die Konfigurationsdatei für den Apache Alias aussehen sollte.

Das war’s auch schon! Schauen Sie sich Ihre neue Mapbender Version an.

Hint

Folgen Sie bitte zusätzlich den Migrationshinweisen für bestimmte Versionen.

Aktualisierungsbeispiel für Linux

Im Folgenden sind die einzelnen Schritte als Befehle aufgeführt.

# Laden Sie die neue Version herunter
wget https://mapbender.org/builds/mapbender-starter-current.tar.gz /tmp/build_mapbender/

tar xfz /tmp/build_mapbender/mapbender-starter-current.tar.gz

# Sichern Sie die alte Version
mv /var/www/mapbender /var/www/mapbender_save

# Aktivieren Sie den Code der neuen Version
cp -R /tmp/build_mapbender/mapbender-starter-v4.0.0 /var/www/
mv /var/www/mapbender-starter-v4.0.0 /var/www/mapbender

# Übernehmen Sie die Konfigurationsdateien in die neue Version von Mapbender
# Übernehmen Sie die Informationen von der config/parameters.yml nach .env.local bzw. /config/parameters.yaml
# Übernehmen Sie die Informationen die Information der alten config.yml nach /var/www/mapbender/config/packages/doctrine.yaml

# Händisch müssen Sie nun die Konfigurationsdateien auf neue Parameter überprüfen.
# Vergleichen Sie die Dateien parameters.yaml,packages/doctrine.yaml und ggf. andere Dateien aus dem packages-Verzeichnis
# Sofern Sie eigene Templates angelegt haben, vergleichen Sie diese mit der neuen Mapbender Version.
# Sofern Sie Vorschaubilder hochgeladen haben: Kopieren Sie diese von der alten Version wieder nach mapbender/public/uploads.
# Sofern Sie eigene Druckvorlagen verwenden: Kopieren Sie diese wieder nach config/MapbenderPrintBundle/templates/.

# Setzen Sie die Schreibrechte für Besitzer (u), Gruppe (g) und Andere (a). Weisen Sie die Skripte der Apache Gruppe (www-data) zu.
sudo chmod -R ugo+r /var/www/mapbender
sudo chown -R :www-data /var/www/mapbender

# Aktualisieren Sie Ihre Mapbender Datenbank
cd /var/www/mapbender/
bin/console doctrine:schema:update --complete --dump-sql
bin/console doctrine:schema:update --complete --force

# Importieren Sie die Demo-Anwendungen, um sich den neusten Stand der Entwicklungen anzuschauen
bin/composer run reimport-example-apps

# Aufbau der symbolischen Links
bin/console assets:install public --symlink --relative

# Setzen Sie die Schreibrechte für Besitzer (u), Gruppe (g) und Andere (a). Weisen Sie die Skripte der Apache Gruppe (www-data) zu.
sudo chmod -R ug+r /var/www/mapbender
sudo chown -R :www-data /var/www/mapbender

# Sie benötigen Schreibrechte für die Verzeichnisse var/cache und var/log.
sudo chmod -R ug+w /var/www/mapbender/var/cache
sudo chmod -R ug+w /var/www/mapbender/var/log
sudo chmod -R ug+w /var/www/mapbender/public/uploads

Aktualisierungsbeispiel für Windows

# Laden Sie die neue Version herunter https://mapbender.org/builds/

# Sichern Sie die alte Version (Dateien und Datenbank)

# Übernehmen Sie die Konfigurationsdateien in die neue Version von Mapbender.
# Vorher müssen Sie diese händisch auf neue Parameter und Änderungen überprüfen.

# Rufen Sie die bin/console Befehle über die php.exe auf.
# Hierzu müssen Sie ein Standardeingabefenster öffnen.
c:
cd mapbender

# Aktualisieren Sie Ihre Mapbender Datenbank
php.exe bin/console doctrine:schema:update --complete --dump-sql
php.exe bin/console doctrine:schema:update --complete --force

# Importieren Sie die Anwendungen aus der mapbender.yaml Datei, um sich den neusten Stand der Entwicklungen anzuschauen
php.exe bin/composer run reimport-example-apps

# Ausspielen in den web-Bereich
php.exe bin/console assets:install public

# Löschen Sie den Cache und die Logdateien unter mapbender/var/cache und mapbender/var/log

# Sofern Sie eigene Templates angelegt haben, vergleichen Sie diese mit der neuen Mapbender Version.
# Sofern Sie Vorschaubilder hochgeladen haben: Kopieren Sie diese von der alten Version wieder nach mapbender/public/uploads.
# Sofern Sie eigene Druckvorlagen verwenden: Kopieren Sie diese wieder nach config/MapbenderPrintBundle/templates/