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 in allen Browsern ohne aktives Löschen des 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.

Eigene Entwicklungen

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