Installationsanleitungen

atlasFX

Konvention

In den folgenden Anleitungen werden immer wieder folgende Variablen verwendet, deren Bedeutung wir hier kurz erläutern:

Was

Variable

Umgebung

Beispiel

Basispfad zur Apache Tomcat Installation

{CATALINA_HOME}

Standard unter Windows:

C:\Program Files\Apache Software Foundation\Tomcat 9.0

Basispfad zur atlasFX Installation

{ATLASFX_HOME}

Beispiel Windows

D:\workspace\atlasFX

FQDN oder die IP des Apache Tomcat Servers

<server>

frontendvm02.trier.alta4.com

Portnummer des Apache Tomcat Servers

<port>

8080

{ATLAS_HOME} einrichten

Legen Sie ein lokales Heimverzeichnis für die atlasFX Installation an, z.B. „D:\workspace\atlasFX“. (Später als {ATLASFX_HOME} referenziert)

Kopieren Sie alle Inhalte des Verzeichnisses „ATLASFX_HOME“ aus dem Installation-Paket in das neu erstellte lokale Verzeichnis.

{ATLASFX_HOME} sollte nun folgendes beinhalten:

  • Das Verzeichnis „logs“

  • Die Datei „config.properties“

Fehlerprotokolle

Sollte es während der Installation zu Problemen kommen, finden Sie hilfreiche Informationen in den Protokoll-Dateien von Apache Tomcat und atlasFX. Diese finden Sie in folgenden Verzeichnissen:

Windows

Apache Tomcat

{CATALINA_HOME}\logs\

altasFX

{ATLASFX_HOME}\logs\

Linux

Apache Tomcat

{CATALINA_HOME}/logs/

atlasFX

{ATLASFX_HOME}/logs/

Apache Tomcat

Warnung

Bevor Sie Änderungen an der Konfiguration von Apache Tomcat vornehmen, stellen Sie sicher, dass Apache Tomcat gestoppt ist.

Das folgende Kapitel beschreibt die nötigen Anpassungen basierend auf der Standalone Installation des Apache Tomcat. Sollten Sie die Service Installer unter Windows verwenden, müssen Sie die entsprechenden Änderungen über die GUI durchführen.

Anpassen der server.xml

Öffnen Sie die Apache Tomcat Server-Konfiguration in einem Text-Editor.

Windows

{CATALINA_HOME}\conf\server.xml

Linux

{CATALINA_HOME}/conf/server.xml

Suchen Sie nach folgendem Connector-Eintrag

<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />

und ändern Sie ihn folgendermaßen ab:

<Connector port="8080" protocol="HTTP/1.1"
URIEncoding="utf-8"
connectionTimeout="20000"
redirectPort="8443"
maxPostSize="-1" />

Hinweis: Seit der Tomcat-Version 7.0.63 hat sich die Bedeutung des Wert "0" bezüglich des Parameters maxPostSize geändert.

Beachten Sie, dass hier die Standard-Port-Nummern beschrieben sind. Diese können bei Ihnen abweichen.

Das obige Beispiel beschreibt die Konfiguration des http connector. Falls Sie weitere Anbindungen verwenden, müssen diese entsprechend dazu konfiguriert werden. Das URIEncoding muss in jedem Fall auf utf-8 gesetzt werden.

Anpassen des Start-Skriptes

Öffnen Sie das Apache Tomcat Start-Skript in einem Text-Editor.

Windows

{CATALINA_HOME}\bin\catalina.bat

Linux

{CATALINA_HOME}/bin/catalina.sh

Fügen Sie unterhalb des ersten Kommentar-Blocks folgendes ein:

CATALINA_OPTS="-Xms128m -Xmx512m -DATLASFX_HOME=\"{ATLASFX_HOME}/\""

Bitte achten Sie darauf, dass Sie den Pfad zum Heimverzeichnis von atlasFX mit einem „/“ abschließen.

Windows-Benutzer

Ersetzen Sie alle „\“ im Pfad von {ATLASFX_HOME} durch „/“

Windows-Benutzer: Ersetzen Sie alle „\“ im Pfad von {ATLASFX_HOME} durch „/“

Beispiel:

CATALINA_OPTS="-Xms256m -Xmx1024m -DATLASFX_HOME=D:/workspace/atlasFX/"

Anpassen der tomcat-user.xml

Öffnen Sie die Apache Tomcat Benutzer-Konfiguration in einem Text-Editor.

Windows

{CATALINA_HOME}\conf\tomcat-users.xml

Linux

{CATALINA_HOME}/conf/tomcat-users.xml

Fügen Sie vor dem schließenden Tag „</tomcat-users>“ folgende Zeilen ein:

<role rolename="atlasfx"/>
<user username="atlasfx" password="" roles="atlasfx"/>

Beachten Sie, dass für „password“ ein Wert festgelegt werden muss.

Beispiel:

<role rolename="atlasfx"/>
<user username="atlasfx" password="alta4" roles="atlasfx"/>

Bereitstellen des h2-Treibers

Bitte kopieren Sie die Datei "h2-x.y.z.jar"* aus dem "lib"-Verzeichnis der ZIP-Datei in das "lib"-Verzeichnis Ihrer Tomcat Installation.

Im Anschluss starten Sie den Tomcat bitt neu.

*x.y.z ist ein Platzhalter für die Versionsnummer der h2-Datenbank. z.B. "h2-1.3.174.jar".

atlasFX Lizenzen einspielen

Kopieren Sie Ihre Lizenzdateien, bei denen zumindest die Datei „license.lic“ vorhanden sein muss, nach {ATLASFX_HOME}.

Die Anzahl der Dateien kann je nach lizenziertem Featureumfang variieren.

Starten von atlasFX

Starten Sie den Apache Tomcat unter Verwendung des Start-Skriptes.

Windows

{CATALINA_HOME}\bin\catalina.bat

Linux

{CATALINA_HOME}/bin/catalina.sh

Kopieren Sie die Datei „atlasfx.war“ in das Verzeichnis „webapps“ des Apache Tomcat.

Windows

{CATALINA_HOME}\webapps\

Linux

{CATALINA_HOME}/webapps/

Apache Tomcat beginnt nun mit dem Ausliefern der Applikation. Nach einigen Augenblicken finden Sie im „webapps“-Verzeichnis einen Ordner „atlasfx“

Windows

{CATALINA_HOME}\webapps\atlasfx\

Linux

{CATALINA_HOME}/webapps/atlasfx/

Prüfen Sie ob atlasFX korrekt gestartet wurde. Öffnen Sie dafür einen Web-Browser und rufen Sie die Manager-URL des Apache Tomcat auf: 

http://<server>:<port>/manager/html
 
Beispiel
http://frontendvm02.trier.alta4.com:8080/manager/html

atlasFX ist gestartet, wenn in der Spalte „Running“ ein „true“ steht. Sollte dies nicht der Fall, stoppen Sie Apache Tomcat und starten diesen neu.

images/download/attachments/1149678/atlasFX_-_Installations-_und_Updatehandbuch.jpg

Einrichten eines forward proxy auf dem Server

Um die Verwendung des proxy zu aktivieren, müssen Sie drei Zeilen in der Datei config.properties ergänzen. Nach einer Änderung ist ein Neustart des tomcat erforderlich, den Sie mit der Installation der war-Datei verbinden können.

http.nonProxyHosts = <hier kann eine durch Kommata getrennte Liste der hosts
eingetragen werden, die nicht über den proxy abgefragt werden sollen>
http.proxyHost = <hier den host oder die ip-Adresse des proxy eintragen>
http.proxyPort = <hier den port des proxy eintragen>

Einrichten der Standortsuche

In der Auslieferungskonfiguration muss die atlasFX-webapp (server-seitig) Zugriff auf http://tasks.arcgisonline.com/ArcGIS/rest haben, damit die Lokalisierung funktioniert. Falls es nicht möglich ist, den Zugang zu http://tasks.arcgisonline.com/ArcGIS/rest einzurichten, kann ein eigener Geocode Service verwendet werden. Ein Geocode Service ist standardmäßig bei ArcGIS for Server dabei. Zur Konfiguration müssen folgende Zeilen in der Datei config.properties vorhanden sein:
gis.rest.geometryService.url = http://<host>:<port>/<path>/rest
gis.rest.geometryService.folder = <folder falls vorhanden>
gis.rest.geometryService.serviceName = <serviceName>

Beispiel:
gis.rest.geometryService.url = http://arcgisserver.example.com:6080/arcgis/rest
gis.rest.geometryService.folder = Utilities
gis.rest.geometryService.serviceName = Geometry

Falls eine Zugriffskontrolle per Token eingerichtet ist sind weitere Parameter erforderlich:
gis.rest.geometryService.token.serviceUrl = http://<host>:<port>/<path>/tokens/
gis.rest.geometryService.token.user = <user>
gis.rest.geometryService.token.password = <password>

Beispiel:
gis.rest.geometryService.token.serviceUrl = http://arcgisserver.example.com:6080/arcgis/tokens/
gis.rest.geometryService.token.user = der-benutzer
gis.rest.geometryService.token.password = sicheres-password

Migration der atlasFX Datenbank

Rufen Sie die Manager-URL des Apache Tomcat auf: 

http://<server>:<port>/manager/html

Klicken Sie auf den Link „/atlasfx“, um atlasFX aufzurufen. Sie werden auf die folgende Seite geleitet:

images/download/attachments/1149678/image2015-6-15_15_0_57.png

Gehen Sie zunächst in den Administrations-Bereich von atlasFX, um die Datenbank zu migrieren.
Um Zugriff auf den Administrations-Bereich von atlasFX zu erhalten, geben Sie folgende URL in Ihren Web-Browser ein: 

http://<server>:<port>/atlasfx/cms/admin/
 
Beispiel:
http://frontendvm02.trier.alta4.com:8080/atlasfx/cms/admin/

Es öffnet sich ein neues Fenster, in dem Sie nach einem Login gefragt werden. Geben Sie bei „Benutzername“ „atlasfx“ und bei „Passwort“ das Passwort ein, welches Sie in der „tomcat-user.xml“ eingetragen haben.

Beispiel

Benutzername

atlasfx

Passwort

alta4

Es wird folgende Seite angezeigt:

images/download/attachments/1149678/atlasfx3.bmp

Folgen Sie dem Link „Upgrade the atlasFX Installation“. Es öffnet sich eine neue Seite.

Um die Datenbank auf die aktuelle Version zu migrieren, klicken Sie den Button „Execute Migration“.

images/download/attachments/1149678/atlasfx4.bmp

Nach Abschluss des Migrationsschrittes wird die folgende Meldung angezeigt:

images/download/attachments/1149678/atlasfx5.bmp

Wiederholen Sie diesen Vorgang so oft, bis Button „Execute Migration“ nicht mehr sichtbar ist und am Ende des Abschnitts „Database Migration“ folgender Hinweis zu lesen ist:

„No migration needed. Schema is up to date.“

images/download/attachments/1149678/atlasfx6.bmp

Migration der atlasFX Tools

Rufen Sie die Manager-URL des Apache Tomcat auf: 

http://<server>:<port>/manager/html

Klicken Sie auf den Link „/atlasfx“, um atlasFX aufzurufen. Sie werden auf die folgende Seite geleitet:

images/download/attachments/1149678/atlasfx7.bmp

Gehen Sie zunächst in den Administrations-Bereich von atlasFX, um die Datenbank zu migrieren.
Um Zugriff auf den Administrations-Bereich von atlasFX zu erhalten, geben Sie folgende URL in Ihren Web-Browser ein: 

http://<server>:<port>/atlasfx/cms/admin/

Beispiel:
http://frontendvm02.trier.alta4.com:8080/atlasfx/cms/admin/

Es öffnet sich ein neues Fenster, in dem Sie nach einem Login gefragt werden. Geben Sie bei „Benutzername“ „atlasfx“ und bei „Passwort“ das Passwort ein, welches Sie in der „tomcat-user.xml“ eingetragen haben.

Beispiel

Benutzername

atlasFX

Passwort

alta4

Es wird folgende Seite angezeigt:

images/download/attachments/1149678/atlasfx8.bmp

Folgen Sie dem Link „Upgrade the atlasFX Installation“. Es öffnet sich eine neue Seite.

Um die Tools von atlasFX zu migrieren, klicken Sie den Button „Import Tools“

images/download/attachments/1149678/atlasfx9.bmp

Nach erfolgreichem Abschluss der Migration:

images/download/attachments/1149678/atlasfx10.bmp

Server-Status von atlasFX

Um nach erfolgreicher Installation und Migration den Status von atlasFX zu prüfen, rufen Sie die Manager-URL des Apache Tomcat auf: 

http://<server>:<port>/manager/html

Klicken Sie auf den Link „/atlasfx“, um atlasFX aufzurufen. Sie werden auf die folgende Seite geleitet:

images/download/attachments/1149678/atlasfx11.bmp

Gehen Sie zunächst in den Administrations-Bereich von atlasFX, um die Datenbank zu migrieren.
Um Zugriff auf den Administrations-Bereich von atlasFX zu erhalten, geben Sie folgende URL in Ihren Web-Browser ein: 

http://<server>:<port>/atlasfx/cms/admin/

Beispiel:
http://frontendvm02.trier.alta4.com:8080/atlasfx/cms/admin/

Es öffnet sich ein neues Fenster, in dem Sie nach einem Login gefragt werden. Geben Sie bei „Benutzername“ „atlasfx“ und bei „Passwort“ das Passwort ein, welches Sie in der „tomcat-user.xml“ eingetragen haben.

Beispiel

Benutzername

atlasfx

Passwort

alta4

Es wird folgende Seite angezeigt:

images/download/attachments/1149678/atlasfx12.bmp

Folgen Sie dem Link „Server Status“. Es wird eine neue Seite mit den Status-Informationen von atlasFX angezeigt.

images/download/attachments/1149678/atlasfx13.bmp

Typo3 Plugins

Das Installieren der Typo3 Plugins geschieht immer gleich. Diese Anleitung und die benötigten Dateien sind im Download zusammengefasst.

Hinweis: Verwechseln sie die Heruntergeladene ZIP-Datei nicht mit der enthaltenen Installationsdatei.

Die Download-Datei enthält..

  • Eine Installationsanleitung: install.txt

  • Eine Installationsdatei für Typo3 4.5: alta4_<pluginname>_<versionsnummer>.t3x

  • Eine Installationsdatei für Typo3 6.x: alta4_<pluginname>_<versionsnummer>.zip

Typo3 Version 6.x

  1. Loggen Sie sich im Typo3 Backend ein.

  2. Im Bereich „Adminwerkzeuge“ wählen Sie den Punkt „Erweiterungsmanager“

  3. Nun erscheint im oben Bereich ein Dropdown Menü.

  4. Hier wählen Sie bitte „Erweiterungen verwalten“

  5. Direkt unter dem Dropdown sollte nun ein Upload Button erscheinen. Drücken Sie diesen.

  6. Es erscheint ein Formular zum Hochladen der Erweiterung.

  7. Wählen Sie hier die Installationsdatei (alta4_<pluginname>_<versionsnummer>.zip) und fahren Sie mit dem Button „Hochladen“ fort.

  8. Bei Erfolg erscheint eine Nachricht „Erweiterung hochgeladen!“.

  9. Die Installation ist damit abgeschlossen. Sie können nun das Plugin zu Ihren Inhaltsseiten hinzufügen.

Typo3 Version 4.5

  1. Loggen Sie sich im Typo3 Backend ein.

  2. Im Bereich „Adminwerkzeuge“ wählen Sie den Punkt „Erweiterungen“

  3. Nun erscheint oben ein Dropdown Menü. Hier wählen Sie bitte „Erweiterungen Importieren“

  4. Ganz unten findet sich der Punkt „Erweiterungsdatei direkt hochladen“. Hier bitte die Installationsdatei auswählen. (alta4_<pluginname>_<versionsnummer>.t3x)

  5. Wählen Sie „Erweiterungsdatei hochladen“.

  6. Bei Erfolg erscheint ein Text „Erweiterung importiert“.

  7. Klicken Sie auf „Erweiterung installieren“.

  8. Es erscheint der Text: „Die Erweiterung "..." wurde installiert.“

  9. Die Installation ist damit abgeschlossen. Sie können nun das Plugin zu Ihren Inhaltsseiten hinzufügen.