Eine bestehende Installation aktualisieren

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.

  • Wir empfehlen, 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, gehen Sie folgendermaßen vor:

  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 sicherzugehen, 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-Datei für diese App (default-app-4.zip) liegt im map.apps Arbeitsverzeichnis. Um den Pfad zu diesem Verzeichnis zu definieren, setzen Sie den Parameter data.directory.location in der Datei %TOMCAT%\webapps\mapapps\WEB-INF\classes\custom-application.properties.

Wenn Sie keine Anpassungen an der Standard-App vorgenommen haben, entfernen Sie diese aus dem Arbeitsverzeichnis, damit aktualisierte Versionen der Standard-App aus der neuen Version von map.apps übernommen werden.

Produkterweiterungen

Wenn Sie map.apps Produkterweiterungen betreiben, die mit dem aktuellen map.apps Manager nicht kompatibel sind, beachten Sie den Abschnitt Kompatibilitätsmodus map.apps Manager 3.x.

Eigene Entwicklungen

Wenn Sie in Ihrer map.apps-Installation benutzerdefinierte Bundles verwenden, die die ArcGIS-API für JavaScript nutzen, überprüfen Sie, ob es Breaking Changes gibt, die Ihre Implementierung beeinflussen könnten.

Aktualisierung bestehender Apps

Nach einem Update von map.apps 3.x auf 4.x müssen Apps, die weiterhin die 3.x-Version von Bundles verwenden sollen, angepasst werden. Gehen Sie dazu folgendermaßen vor:

  1. Markieren Sie in der App-Liste alle Apps, die 3.x Bundles nutzen sollen und rufen Sie das Werkzeug Produktversionen in ausgewählten Apps verwalten auf.

  2. Wählen Sie im ersten Dialog das Produkt map.apps aus.

  3. Im nächsten Dialog wählen Sie map.apps Version 3.10.10.

  4. 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.10 kompatibel.

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

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

Bundles der Version 4.12.3 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.