Installation
Voraussetzungen
- MapEdit Server Installation (siehe Installation MapEdit Server)
- WildFly Installation (siehe Installation WildFly)
Deployment
Vorab muss die mapedit-core.ear, welche Sie aus dem Software Repository herunterladen können, auf dem WildFly deployed werden. Mehr zum Thema Deployments findet sich unter WildFly - Deployments. Nach einem erfolgreichen Deployment ist MapEdit Core bereits installiert, muss jedoch noch konfiguriert werden, um voll genutzt werden zu können.
WildFly System Properties
Zur Konfiguration von mapedit-core müssen im WildFly sogenannte System Properties hinterlegt werden. Die System Properties können entweder in der standalone.xml des WildFlys im XML-Format hinterlegt werden oder über die Management Console im Browsers eingefügt werden. Diese befindet sich auf dem Server unter localhost:9990 -> Configuration -> System Properties -> View. Sofern Sie sich auf dem Server befinden, können Sie auch diesen Link nutzen. Über Add können Sie einen neuen Eintrag erstellen.
Die Properties werden in der nachfolgenden Tabelle aufgeführt und erläutert.
| Name | Beispiel-Value | Beschreibung |
|---|---|---|
MapEdit.LicensePath | C:\licenses | Pfad zum Verzeichnis, in welchem Ihre Lizenzdateien liegen |
MapEdit.RepositoryUrl | https://{IHRSERVER}.de/mum.geo.services/ | URL zum MapEdit Repository |
MapEdit.RepositoryPath | C:\inetpub\wwwroot\MumGeoData | Pfad zum MapEdit Repository |
Bitte beachten Sie, dass Sie auf Ihrem Server entweder MapEdit.RepositoryUrl oder MapEdit.RepositoryPath ausfüllen. MapEdit.RepositoryUrl ist die bevorzugte Methode, welche bis auf wenige Ausnahmen immer gewählt werden sollte.
MapEdit.RepositoryPath wird nur für lokale Systeme oder Testsysteme genutzt. Diese Property wird hier nur aus Gründen der Vollständigkeit aufgeführt.
Installationsprüfung
Falls bei der Installation oder im Betrieb Probleme auftreten, prüfen Sie die MapEdit Logdatei auf Fehler.
Core Version prüfen
Rufen Sie die Versionsseite im Webbrowser auf, um die installierte MapEdit Core Version zu verifizieren:
http://localhost:8080/mapedit-core/version(lokal)http://SERVERNAME:8080/mapedit-core/version(auf dem Server)
REST-API prüfen
Rufen Sie die Swagger-Oberfläche im Webbrowser auf, um die Funktionalität der REST-API zu testen:
http://localhost:8080/mapedit-core/swagger-ui/(lokal)http://SERVERNAME:8080/mapedit-core/swagger-ui/(auf dem Server)
Webserver- und Reverse-Proxy-Einrichtung
Um die passenden Einstellungen für Ihren Webserver und Ihren Reverse-Proxy zu treffen, können Sie der Anleitung URL Rewrite / Reverse Proxy einrichten und Reverse Proxy folgen.