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.

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.

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.

Aktualisierungs-Schritte

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. Prüfen Sie, welche Einstellungen in der vorherigen Installation von map.apps in der Datei WEB-INF\classes\custom-application.properties vorgenommen worden sind. Stellen Sie diese Einstellungen in der Datei %TOMCAT%\webapps\mapapps\WEB-INF\classes\custom-application.properties wieder her:

    • data.directory.location: Setzen Sie diese Einstellung auf den Pfad des Arbeitsverzeichnisses Ihrer vorherigen map.apps Version.

    • config.directory.location: Setzen Sie diese Einstellung auf den Pfad des Datenverzeichnisses Ihrer vorherigen map.apps Version. Diese Einstellung ist nur notwendig, wenn Arbeitsverzeichnis und Datenverzeichnis voneinander abweichen.

  5. Falls Sie eine Datenbankverbindung über JNDI verwenden, öffnen Sie die Datei %TOMCAT%\webapps\mapapps\META-INF\context.xml und entfernen Sie die Kommentare um das Element <ResourceLink name="jdbc/mapapps" global="mapappsdb" type="javax.sql.DataSource"/>, um es erneut zu aktivieren.

  6. Starten Sie den Apache Tomcat-Dienst.

Caching

Nach dem Update muss der Browser-Cache auf jedem Endgerät gelöscht werden, um sicherzugehen, dass Ä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.

Eigene Entwicklungen

Wenn Sie in Ihrer map.apps-Installation eigene Bundles verwenden, die das ArcGIS Maps SDK for JavaScript nutzen, prüfen Sie, ob es zwischen der bislang und der aktuell von map.apps genutzten Version Breaking Changes gibt, die Ihre Implementierung betreffen.