Update einer bestehenden Installation

Diese Seite beschreibt, wie Sie eine bestehende Installation auf eine neuere Version aktualisieren. Bereits erstellte Apps, App-Vorlagen und Bericht-Vorlagen sowie hochgeladene Bundles bleiben dabei erhalten.

Vor dem Update

  • Beachten Sie die Update-Hinweise in den Release Notes der aktuellen Version sowie aller Versionen die zwischen der aktuellen und der bislang bei Ihnen installierten Version liegen.

  • Es wird empfohlen vor dem Update Ihrer Installation eine Sicherung der Datenbank durchzuführen.

Ermitteln der aktuell verwendeten Version

Um die Versionsnummer einer bestehenden Installation zu prüfen, geben Sie /info.txt hinter dem Basis-Pfad der Installation ein, z.B. https://<yourserver>/mapapps/info.txt.

Aktualisierung der Installation

Um map.apps auf eine neuere Version zu aktualisieren, führen Sie die folgenden Schritte durch:

  1. Stoppen Sie den Apache Tomcat-Dienst.

  2. Entfernen Sie die alte map.apps Webanwendung unter %TOMCAT%\webapps\ (verschieben Sie sie zunächst in ein Backup-Verzeichnis, bevor Sie sie komplett löschen).

  3. Entpacken Sie die neue map.apps Version in den Ordner %TOMCAT%\webapps\.

  4. Editieren Sie Datei %TOMCAT%\webapps\mapapps\WEB-INF\classes\custom-application.properties und passen Sie die data.directory.location Einstellung an (prüfen Sie ggf. welche Angaben in der vorherigen Version von map.apps in dieser Datei standen). Hier wird auf den Ordner verwiesen, in dem sich die angepasste application.properties-Datei befindet. Befindet sich diese im Standard-Verzeichnis, entfällt dieser Schritt.

  5. Starten Sie den Apache Tomcat-Dienst neu.

Vereinfachtes Update mit externer application.properties Datei
Führen Sie keine Änderung an der Datei %TOMCAT%\webapps\mapapps\WEB-INF\classes\application.properties durch. Verwenden Sie stattdessen eine externe application.properties Datei. Details dazu sind in Konfiguration beschrieben.

Caching

Falls Sie nach dem Update denselben Namen für die Webanwendung nutzen wie zuvor (z.B. %TOMCAT%\webapps\mapapps), muss der Browser-Cache auf jedem Endgerät gelöscht werden, um sicher zu gehen, dass die Änderungen wirksam werden. Spätestens nach einer definierten Zeit von standardmäßig einem halben Tag, werden die Änderungen bei allen Nutzern ohne aktives Löschen des Browser-Caches wirksam.

Standard-Apps

Beim Erstellen einer neuen App kann eine sog. Standard-App angelegt werden. Die Vorlagen für diese Apps liegen im map.apps Arbeitsverzeichnis (Dateien: default-app-*.zip). Der Pfad zu diesem Verzeichnis wird über den Parameter data.directory.location in der Datei %TOMCAT%\webapps\mapapps\WEB-INF\classes\custom-application.properties definiert. Wenn Sie keine Anpassungen an den map.apps Standard-Apps vorgenommen haben, wird empfohlen, diese aus dem Arbeitsverzeichnis zu entfernen, damit evtl. aktualisierte Versionen der Standard-Apps aus der neuen Version von map.apps übernommen werden.

Produkterweiterungen

Wenn Sie map.apps Produkterweiterungen betreiben, beachten Sie den Abschnitt "Kompatibilitätsmodus map.apps Manager 3.x" in Installation von Produkterweiterungen.

Eigene Entwicklungen

Wenn sie selbstentwickelte Bundle verwenden, prüfen Sie in den Release Notes der ArcGIS API for JavaScript, ob es Breaking Changes gibt, die Auswirkungen auf Ihre Implementierung haben.

Aktualisierung bestehender Apps

Nach dem Update von map.apps 3.x auf 4.x ist es notwendig, bestehende Apps die weiterhin die 3.x-Version von Bundles verwenden sollen, anzupassen.

Markieren Sie dazu in der App-Liste alle Apps und rufen Sie das Werkzeug "Produktversionen in ausgewählten Apps verwalten" auf. Wählen Sie im ersten Dialog das Produkt "map.apps" aus. Im nächsten Dialog wählen Sie map.apps Version 3.10.9. Legen Sie anschließend die Update-Richtlinie fest, die definiert, wie Apps mit zukünftigen Versionen von 3.x umgehen:

  • keine: Die Apps sind exakt mit map.apps Version 3.10.9 kompatibel.

  • Bugfix: Die Apps sind ebenfalls mit allen Bugfix-Releases ab Version 3.10.9 kompatibel.

  • Minor: Die Apps sind ebenfalls mit allen Minor-Releases ab Version 3.10.9 kompatibel (empfohlen).

Bundles der Version 4.11.1 werden somit nicht für Ihre Apps verwendet. Nachdem Sie die Einstellungen angewandt haben, wird Ihnen eine Zusammenfassung aller Apps angezeigt, die bearbeitet wurden. Für jede App ist zudem eine detaillierte Liste aller angepassten Bundles einsehbar.

Ihre Apps sind nun für die 3.x-Version der map.apps Bundles eingestellt und können verwendet werden.

Verwendung von älteren App-Vorlagen

Existierende App-Vorlagen müssen manuell aktualisiert und erneut hochgeladen werden. Ansonsten muss nach jedem Erstellen einer neuen App basierend auf einer map.apps 3.x App-Vorlage obiger Prozess für diese App durchgeführt werden.

Zu diesem Zweck können Sie eine App auf Basis der Vorlage erstellen, die Aktualisierung durchführen, dann die App ohne Änderung exportieren und damit die App-Vorlage überschreiben.