Installation von map.apps

Voraussetzungen

Stellen Sie sicher, dass die folgende Software vor der Installation von map.apps auf Ihrem System installiert ist. Die kompatiblen Versionen finden Sie in den Systemanforderungen.

  • Java: Zum Beispiel von der OpenJDK Download-Seite .

  • Apache Tomcat: Verfügbar auf der Apache Tomcat Download-Seite . Für eine Windows-Installation empfehlen wir den "32-bit/64-bit Windows Service Installer".

    • Weitere Informationen zur Installation finden Sie in der Tomcat Setup-Dokumentation .

    • Falls Ihre Systemumgebung spezielle Proxyserver-Einstellungen benötigt, konfigurieren Sie diese im Tomcat.

  • Datenbank:

    • Für Testzwecke wird standardmäßig eine lokale HSQL-Datenbank erstellt.

    • Für Produktionsumgebungen installieren und konfigurieren Sie eine eigene Datenbank. Details finden Sie unter Datenbank-Konfiguration.

Installationsschritte

Diese Anleitung beschreibt die Erstinstallation von map.apps. Informationen zur Aktualisierung einer bestehenden Installation finden Sie unter Bestehende Installation aktualisieren.

Führen Sie die folgenden Schritte aus, um map.apps zu installieren:

  1. WAR-Datei entpacken: Kopieren Sie die Datei mapapps.war aus dem Auslieferungsverzeichnis von map.apps in ein temporäres Verzeichnis und entpacken Sie sie dort.

  2. Datenverzeichnis festlegen: Passen Sie den Parameter data.directory.location in der Datei WEB-INF\classes\custom-application.properties an, falls Sie das Standarddatenverzeichnis \${user.home}\.mapapps ändern möchten. Der Platzhalter user.home bezieht sich auf das Home-Verzeichnis des Benutzers, unter dem Tomcat läuft.

  3. Konfigurationsdateien kopieren: Kopieren Sie die Dateien application.properties und secrets.properties aus dem Verzeichnis WEB-INF\classes\config-templates in das in Schritt 2 definierte Datenverzeichnis.

  4. Administrationspasswort setzen: Öffnen Sie die Datei <data.directory.location>\secrets.properties und setzen Sie ein Passwort für den Parameter secret.admin.pw.

  5. Webanwendung bereitstellen: Kopieren Sie das angepasste Verzeichnis aus Schritt 1 (oder die angepasste WAR-Datei) in den Ordner %TOMCAT%\webapps. Alternativ können Sie den Tomcat Manager verwenden (häufig unter http://<yourserver>:8080/manager/html), um die WAR-Datei bereitzustellen.

  6. Tomcat-Dienst starten: Starten Sie den Tomcat-Dienst neu, damit die Änderungen wirksam werden.

Für den produktiven Betrieb von map.apps sind zusätzliche Konfigurationsschritte erforderlich. Details dazu finden Sie unter Konfiguration und Authentifizierung.

Die Webanwendung ist jetzt unter https://<yourserver>/mapapps verfügbar und zeigt eine leere App-Übersicht:

empty app overview

Um eine erste App zu erstellen, lesen Sie die Anleitung unter Erste Schritte.