Installation

Hinweis: Ab GMSC-K 2018 muss weder am Client noch am Server separat Java installiert werden. Dafür muss am Client einmalig der Hexagon App Launcher installiert werden. Installationseinweisung siehe unten.

Reihenfolge der Installation

1. Installation GeoMedia SmartClient
2. Installation Zusatzpakete (entfällt ab GMSC-K 2018)
3. Installation GeoMedia SmartClient Kommunal
4. Installation PGSST (optional bis GMSC-K 2015, ab GMSC-K 2016 im Setup enthalten, entfällt ab GMSC-K 2018)
5. Installation GeoMedia WebMap (optional, für Anbindung WMS ab GMSC-K 2016 nicht mehr nötig)
6. Installation von Hexagon App Launcher an allen Clients (ab GMSC-K 2018)

Installation Zusatzpakete

Achtung: entfällt ab GMSC-K 2018

Installieren Sie folgende Zusatzpakete, falls diese auf Ihrem System noch nicht vorhanden sind:

• Microsoft InteropForms Toolkit: microsoft.interopformsredist.msi
• Microsoft C++ redistributable 2010 x86: vcredist_2010_x86.exe
• SQLSysClrTypes x86: SQLSysClrTypes_x86.msi
• ODP.NET (nur notwendig wenn Oracle verwendet wird): ODAC112021Xcopy_32bit.zip auspacken und ODAC.bat starten

Startfenster Setup GeoMedia SmartClient Kommunal

Wie im Kapitel Systemvoraussetzungen dargestellt, ist für GeoMedia SmartClient Kommunal die Installation des GeoMedia SmartClients und dessen Update-Komponenten erforderlich. Stellen Sie sicher, dass dieser erfolgreich installiert wurde und gestartet werden kann.

Hinweis: Um GeoMedia SmartClient Kommunal zu installieren müssen Sie am Server als Administrator angemeldet sein! Es müssen alle Rechte vorhanden sein! Während des Installtionsprozesses wird auf diverse Ordner zugegriffen, sodass hier Schreibrechte vorhanden sein müssen. Außerdem werden durch das Setup die benötigten Dienste installiert.

Als ersten Schritt führen Sie die Datei GeoMedia Kommunal.msi (Windows-installer-Paket) aus, indem Sie per Rechtsklick auf die Datei klicken und "als Administrator ausführen" auswählen. Nach der Berechnung der Speicherplatzkapazität öffnet sich der Willkommens-Dialog. Fehlt eine Komponente der Systemvoraussetzungen, weist Sie ein Popup-Fenster an dieser Stelle darauf hin. Holen Sie die Installation der jeweiligen Systemvoraussetzung nach und starten Sie anschließend das Setup neu.

Hoch zum Seitenanfang

Lizenzbedingungen

Hier finden Sie den vollständigen Endnutzer-Lizenzvertrag. Aus dem Setup-Dialog lässt sich dieser auch drucken. Informationen zum Freischalten Ihres Produkts nach erfolgter Installation erhalten Sie im Kapitel Lizensierung .

Hoch zum Seitenanfang

Zielordner auswählen

Standardmäßig wird GeoMedia SmartClient Kommunal unter C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\ gespeichert. Hier befindet sich auch das Installationsverzeichnis von GeoMedia SmartClient. Über den Button "Ändern" lässt sich ein anderer Speicherort festlegen.

Hoch zum Seitenanfang

Definition der Datenbankparameter

Datenbankparameter Teil 1

An dieser Stelle kann der Name der Site festgelegt werden. Standardmäßig ist die Bezeichnung GMSC.

Der Speicherort, an dem später Dokumente und Uploads am Server abgelegt werden, kann ebenfalls definiert werden. Standardmäßig wird C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal verwendet.

Datenbankparameter Teil 2

• Datenbanktyp: Oracle oder Microsoft SQL Server
• Datenbankserver: Namen oder IP Adresse (z.B.: 127.0.0.1, falls die Datenbank am Installationsserver installiert ist.)
• Port: Standardmäßig wird 1521 (Oracle) bzw. 1433 (Microsoft SQL Server)verwendet

Datenbankparameter Teil 3

Hier werden die Informationen des zuvor angelegten Adminschemas abgefragt und zu einem Connection String aufgelöst.

• Datenbankname: Standardmäßig wird hier orcl verwendet. Geben Sie hier bitte die Instanz-Bezeichnung der DB an.
• Datenbank-Nutzername: Verwendete Benutzer-Bezeichnung.
• Datenbank-Kennwort: Verwendetes Passwort des Adminschemas.

Klicken Sie auf "Weiter" um die Eingaben zu testen. War der Verbindungsversuch erfolgreich, gelangen Sie zum nächsten Schritt.

Waren die Datenbankparameter nicht korrekt, werden Sie darauf hingewiesen. Sie sollten auf "Zurück" klicken und Ihre Angaben erneut prüfen.

Hinweis: Achtung! Momentan kann es vorkommen, dass trotz korrekter DB Parameter das Fenster 'Es konnte keine Verbindung hergestellt werden' erscheint. Überprüfen Sie nochmals ihre Eingaben und klicken Sie auf Weiter, wenn Sie sich ihrer Angaben sicher sind. Nach der automatischen Installtion kann der Connectionstring unter C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Server\spring.properties angepasst werden.

Beispiel SQL Sever:
adminDSmode=update
adminDSClassName=net.sourceforge.jtds.jdbc.Driver
adminDSURL=jdbc:jtds:sqlserver://MUC-SGIV-PGQS04:1433/DBTest
adminDSUser=User
adminDSPass=Passwort

Beispiel Oracle:
adminDSmode=update
adminDSClassName=oracle.jdbc.OracleDriver
adminDSURL=jdbc:oracle:thin:User/Passwort@//muc-sgiv-pgqs04:1521/orcl
adminDSUser=User
adminDSPass=Passwort

Hoch zum Seitenanfang

Wichtige Informationen nach der Installation

Dieses Fenster weist Sie darauf hin, dass nach Beendigung des Setup-Assistenten die Lizensierung ausgeführt werden muss.

Anschließend müssen folgende Dienste gestartet werden (Start > Verwaltung > Dienste):

• Intergraph InteropService
• Jetty6 Service
• Intergraph GMSC Kommunal

Überprüfen Sie außerdem ob der Starttyp der Dienste auf "Automatisch" gestellt ist.

Hoch zum Seitenanfang

Installation

Hoch zum Seitenanfang

Fertigstellen des Setups

Nach Abschluss des Setups sollte am ausgewählten Verzeichnis (standardmäßig C:\Program Files\Intergraph\GeoMedia Kommunal) der Ordner GeoMedia Kommunal angelegt worden sein. Fahren Sie nun mit dem Kapitel Lizenzierung fort.

Hinweis: Achtung! Momentan wird der CSF Ordner (dieser Ordner beeinhaltet die einzelnen Koordinatensytem-Definitionen) noch nicht automatisch kopiert. Sind diese Koordinaten_Sytemdateien noch nicht im Warhouse Ordner des GeoMedia SmartClients vorhanden, so können diese aus dem Verzeichnis C:\Program Files\Intergraph\GeoMedia Kommunal\GMSC\CSF kopiert und im Warehouse Ordner abgelegt. Der Warehouse Ordner des SmartClient wurde bei dessen Installation angelegt. Standardmäßig liegt dieses auf C:\.

Hoch zum Seitenanfang

Portfreischaltung

Falls Sie Probleme haben, von einem anderen Computer auf den Server, auf dem GeoMedia SmartClient Kommunal installiert ist, zugreifen zu können, dann wird dies wahrscheinlich an den noch nicht geöffneten Ports liegen.

Um dieses Problem zu beheben, begeben Sie sich auf die Windowsoberfläche des Servers und öffnen die Windows-Firewall. Diese finden Sie beispielsweise, indem Sie in die Windows-Suche in der Startleiste "Firewall" eingeben.

1. Wählen Sie im linken Abschnitt des Fensters "Eingehende Regeln" an und klicken Sie dann weiter rechts auf "Neue Regel... ".

2. Wählen Sie bei "Regeltyp" den Punkt "Port" aus. Klicken Sie dann auf "Weiter".

3. Bei "Protokoll und Ports" lassen Sie "TCP" ausgewählt und geben bei "Bestimmte lokale Ports" "8081,18091,18093" ein. Klicken Sie dann auf "Weiter".

4. Im nächsten Schritt wählen Sie "Verbindung zulassen" und klicken Sie auf "Weiter".

5. Nun können Sie auswählen, wann diese Regel angewendet werden soll. Lassen Sie "Domäne", "Privat" und "Öffentlich" alle ausgewählt.

6. Im letzten Schritt geben Sie einen beliebigen Namen ein, z.B. GeoMedia SmartClient Kommunal. Dann können Sie auf "Fertig stellen" klicken.

7. Wiederholen Sie Schritt 1-6 für "Ausgehende Regeln".

Installation eines zweiten GMSC-K-Dienstes

bis GMSC-K 2016

Speziell beim Hosting kann es erforderlich werden, die Dienste von GMSC-K zu trennen um z.B. jedem Kunden eine "eigene" Umgebung zur Verfügung zu stellen. Vorgehen nach einer Standardinstallation.

1. Alle Dienste stoppen.
2. In der Datenbank ein weiteren USER (Adminschema) anlegen.
3. Regedit aufrufen und die Site GMSC exportieren. In der exportierten Datei den Namen der Site anpassen und den DB-Zugriff für das neue Adminschema eintragen. Mit Doppelklick auf die Datei den Eintrag in die Registry importieren.
4. Im Installationsverzeichnis den Ordner Server kopieren und in dem neuen "Server_2" folgende Anpassungen vornehmen:
5. Anpassen der Datei gmsckservice.conf (siehe Konfigurationsdateien)
6. Anpassen der Datei log4j-server.properties (siehe Konfigurationsdateien)
7. Anpassen der Datei spring.properties (siehe Konfigurationsdateien)
8. Die entsprechenden Ordner bitte per Hand im Windows-Explorer anlegen, z.B. C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\_logfile\gmsck_2
9. Nach diesen Anpassungen die Datei "InstallGMSCKService.bat" im Verzeichnis "C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Server_2\bin" im neuen Installationsverzeichnis (Server_2) als Administrator ausführen.
10. Jetzt im ursprünglichen Installationsverzeichnis in dem Ordner Client > webapps den Ordner gmsck kopieren und in dem neuen "gmsck_2" (C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Client\webapps\gmsck_2) in der Datei "WEB-INF\web.xml" folgende Anpassungen vornehmen: siehe Konfigurationsdateien

Durch diese Änderungen steht jetzt der neue Dienst "Intergraph GMSC Kommunal_2" zur Verfügung. Bitte ggf. die Dateien für Start und Stopp der Dienste entsprechend anpassen und damit dann den neuen Dienst analog dem bisherigen "Intergraph GMSC Kommunal" starten. Damit steht für die Lizenz jetzt eine komplett eigenständige Umgebung zur Verfügung, die auch ein eigenes Adminschema hat.

Es ist auch möglich für jeden GMSC-K-Dienst ein eigene Lizenzdatei zu verwenden. Dazu muss in der Datei gmsckservice.conf die Zeile

wrapper.app.parameter.5="C:/Program Files/Intergraph/GeoMedia SmartClient Kommunal/Lizenzierung/"

entsprechend angepasst werden.

ab GMSC-K 2018

Speziell beim Hosting kann es erforderlich werden, die Dienste von GMSC-K zu trennen um z.B. jedem Kunden eine "eigene" Umgebung zur Verfügung zu stellen. Vorgehen nach einer Standardinstallation.

1. Den Dienst "Hexagon GMSC Kommunal" stoppen, der kopiert werden soll.
2. In der Datenbank ein weiteren USER (Adminschema) anlegen.
3. Regedit aufrufen und die Site GMSC exportieren. In der exportierten Datei den Namen der Site anpassen und den DB-Zugriff für das neue Adminschema eintragen. Mit Doppelklick auf die Datei den Eintrag in die Registry importieren.
4. Im Installationsverzeichnis den Ordner "Instances\[Instanzname]" kopieren und in dem neuen Ordner "Server_2" folgende Anpassungen vornehmen:
5. Anpassen der Datei Instances\[Instanzname]\Server\gmsckservice.conf (siehe Konfigurationsdateien 2018)
6. Anpassen der Datei Instances\[Instanzname]\Server\log4j-server.properties (siehe Konfigurationsdateien 2018)
7. Anpassen der Datei Instances\[Instanzname]\Server\config.properties (siehe Konfigurationsdateien 2018)
8. Aus dem Ordner Instances\[Instanzname]\doc\ ggf. vorhandene Dokumente löschen
9. Nach diesen Anpassungen die Datei "InstallGMSCKService.bat" im Verzeichnis "C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Instances\[Instanzname]\Server\bin" als Administrator ausführen.
10. Anpassen der Datei Instances\[Instanzname]\Client\config.json: siehe Konfigurationsdateien 2018

Durch diese Änderungen steht jetzt der neue Dienst "Hexagon GMSC Kommunal_2" zur Verfügung. Bitte ggf. die Dateien für Start und Stopp der Dienste entsprechend anpassen und damit dann den neuen Dienst analog dem bisherigen "Hexagon GMSC Kommunal" starten. Damit steht für die Lizenz jetzt eine komplett eigenständige Umgebung zur Verfügung, die auch ein eigenes Adminschema hat.

Ab GMSC-K 2018 wurde die Lizenzierung auf Aktivierungscodes umgestellt. Dadurch ist nicht mehr möglich pro Serverinstanz eine eigene Lizenzdatei zu hinterlegen, um im Hostingbetrieb sicherzustellen, dass pro Kunde nur die gekauften Module freigeschaltet werden. Um trotzdem eine Einschränkung der Module zu ermöglichen kann in der Datei Instances\[Instanzname]\Server\gmsckservice.conf folgende Angabe ergänzt werden (ein entsprechender Abschnitt existiert bereits, es muss nur noch das Kommentarkennzeichen '#' am Zeilenanfang entfernt werden):

wrapper.app.parameter.10=-licenseModuleFilter wrapper.app.parameter.11=GKBASE,XXX,YYY

Der zweite Parameter enthält eine Liste der freigegebenen Module, wobei folgende Einzelwerte möglich sind:

-	Modulenkürzel	Beschreibung
GKBASE	Basis Modul
FAFLV	Flurstücksverwaltung
FAFHOF	Friedhof
FAGAS	Gas
FAKNAL	Kanal
FAKLRA	Kleinkläranlagen
FASYNC	Datensynchronisation
FAWASS	Wasser
FAFEWA	Fernwärme
FAXPLN	XPlanung
SHPI	Shape-Import
SHPE	Shape-Export
DXFI	DXF-Import
DXFE	DXF-Export
DESKCOM	verschiedene Kopplung

Hoch zum Seitenanfang

Datenbankumzug

Zieht die Datenbank vom Server A um auf den Server B und die Datenbank ist eine 1:1 Kopie, so sind folgende Schritte notwendig um das System mit dem neuen Datenbankserver zu verbinden:

1. Dienste stoppen

2. Im Registrierungseditor den ConnectionString entsprechend anpassen

3. Anpassung der Konfigurationsdatei

• bis GMSC-K 2016: In der Datei „spring.properties“ (Standardpfad: C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Server) den Eintrag zum Adminschema entsprechend ändern.
• ab GMSC-K 2018: In der Datei „config.properties“ (Standardpfad: C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Instances\Default\Server) den Eintrag zum Adminschema entsprechend ändern.

4. Die Dienste neu starten.

5. Mappe Adminer aufrufen und die Einträge zu dem oder den Datenschemen anpassen.

Danach ist das System mit dem neuen Datenbankserver verbunden.

Hoch zum Seitenanfang

Installation Hexagon App Launcher am Client

Ab GMSC-K 2018 erfolgt der Start des GMSC-K-Clients nicht mehr per Java WebStart sondern mit Hilfe des Hexagon App Launcher. Dieser muss einmalig auf jedem Client-Rechner installiert werden. Updates werden automatisch eingespielt. Gehen Sie zur Installation wie folgt vor:

Öffnen Sie in einem Internet-Browser die URL http://servername/GMSC/api/v1/hnlp/smartclient/downloads?resource=applauncher/AppLauncher.exe&type=setup und speichern Sie die Datei ab. Führen Sie die Datei nun durch Doppelklick aus.

Hoch zum Seitenanfang