Administration und Installation
Inhaltsverzeichnis
- 1 Voraussetzungen
- 2 Projektstruktur
- 3 Kompilieren des CIM-Caches auf der Basis der veröffentlichten Quelltexte
- 4 Starten des CIM-Caches
- 5 Beenden der Applikation
- 6 Prüfen des CIM-Cache-Start durch einen Service-Aufruf
- 7 Log- und Konfigurationsdateien
- 8 Konfiguration der Schnittstellen, Versionen und Ports
Voraussetzungen
Hardware
Die Anforderungen an die Hardware für den Rechner für Serverkomponenten hängen von verschiedenen Rahmenbedingungen ab. Sind die Mindestanforderungen erfüllt, ist die Anwendung lauffähig. Mit zunehmender Leistung der Hardware wird ein besseres Laufzeitverhalten erreicht.
Prozessor: | Intel Core i7-7700 CPU Prozessor, mind. 4x 3.60GHz |
RAM: | mind. 16 GB |
Festplattenspeicher: | mind. 20 GB |
Internetverbindung: | Ja |
Software
Folgende Installationen und Konfigurationen wurden gemäß Dokumentation ausgeführt:
Betrieb
64-bit-Windows-Umgebung* | Version 10 | |
Oracle Java Runtime Environment | Version 8 | Download |
Mozilla Firefox-Browser | Version 52 | Download |
Erstellen
64-bit-Betriebssystem | Windows Version 10 oder Ubuntu Server 16.04.3 LTS | |
Oracle Java SE Development Kit | Version 8 | Download |
Apache Maven Umgebung | Version 3.5 | Download |
Mozilla Firefox-Browser | Version 52 | Download |
Internet-Zugriff | Maven-Repository | Maven-Repository |
Die für das Projekt notwendigen Sourcen (veröffentlichte Quelltexte) können über das eclipse-git bezogen werden.
Projektstruktur
Die Projektverzeichnisse und Dateien befinden nach dem Entpacken bzw. Herunterladen auf dem lokalen Rechner in einem gemeinsamen Verzeichnis (z. B. D:\demo\git.openk\cim-cache), das im Folgenden als ROOT_PATH bezeichnet wird:
org.eclipse.openk.build org.eclipse.openk.cim.cim17v07 org.eclipse.openk.cim.profile.openkonsequenz org.eclipse.openk.common org.eclipse.openk.domain.dynamic-topology org.eclipse.openk.domain.static-topology org.eclipse.openk.domain.topology-state org.eclipse.openk.service org.eclipse.openk.source-system.mock-up-static-topology org.eclipse.openk.source-system.mock-up-topology-state .gitignore pom.xml
Es sind die folgenden Quelltexte und Definitionen enthalten:
- der CIM-Standard in der Version 17.07
- die Domänen-Module des TopologieDatenManagements
- die Quellsystem-Module der Mock-Up-Topology
- gemeinsam genutzte Basis- und Servicefunktionalität
- eine Hilfsdatei für die Versionsverwaltung Git (.gitignore)
- die notwendigen Definitionen zum automatisierten Kompilieren und Testen der Quellen (pom.xml)
Kompilieren des CIM-Caches auf der Basis der veröffentlichten Quelltexte
- Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:
cd demo\git.openk\cim-cache
- Anschließend den Bau des CIM-Caches mit Hilfe des Tools Maven starten:
mvn clean install
Auf dieser Basis führt Maven folgende Schritte durch:
- Auflösen der zum Bauen notwendigen Informationen
- Herunterladen der externen Abhängigkeiten
- Durchführung der statischen Code-Analyse
- Bauen der einzelnen Module in der festgelegten Reihenfolge
- Durchführung von Unit- und Integrationstest
Starten des CIM-Caches
Der Start des CIM-Cache setzt die Verfügbarkeit der Quellsysteme voraus. Für Tests kann hier die Mock-Up-Topology als Quellsystem-Mock-Up verwendet werden.
Dabei ist zu berücksichtigen, dass alle notwendigen Applikationen auf unterschiedlichen Ports laufen. Diese lassen sich, wie in Abschnitt 6 beschrieben, konfigurieren.
Starten der Mock-Up-Topology
- Innerhalb der Konsole in das folgende Verzeichnis wechseln:
ROOT_PATH/org.eclipse.openk.source-system.mock-up-static-topology/service/target
- Das Quellsystem-Mock-Up mit dem folgenden Befehl starten (Windows):
java -jar mock-up-static-topology-service-0.0.1-SNAPSHOT.jar
- Das Quellsystem-Mock-Up mit dem folgenden Befehl starten (Linux):
nohup java -jar mock-up-static-topology-service-0.0.1-SNAPSHOT.jar > mock-up-static-topology.log 2>&1 &
Starten des TopologieDatenManagement
- Innerhalb der Konsole in das folgende Verzeichnis wechseln:
ROOT_PATH/org.eclipse.openk.domain.dynamic-topology/service/target
- Den CIM-Cache mit dem folgenden Befehl starten (Windows):
java -jar dynamic-topology-service-0.0.1-SNAPSHOT.jar
- Den CIM-Cache mit dem folgenden Befehl starten (Linux):
nohup java -jar dynamic-topology-service-0.0.1-SNAPSHOT.jar > dynamic-topology.log 2>&1 &
Beenden der Applikation
Die Applikation wird beendet, indem die Konsole(n), in der die Applikation(en) gestartet wurden, geschlossen werden.
Prüfen des CIM-Cache-Start durch einen Service-Aufruf
Zur Überprüfung des Starts des CIM-Caches kann im Browser die folgende URL aufgerufen: topologische Elemente
Das Ergebnis ist die Mock-up-Topologie als RDF formatiertes XML-Dokument.
Log- und Konfigurationsdateien
Die Anwendung wird durch die Konfigurationsdatei application.properties angepasst. Folgende Parameter können hier konfiguriert werden:
- server-Port
- logging-level
Die Datei befindet sich im Verzeichnis:
ROOT_PATH/org.eclipse.openk.domain.topology.topology-service/src/main/resources/
Die Konfiguration dieser Datei können Sie beim Start der Anwendung überschreiben. Dazu fügen Sie dem Befehl zum Starten der Applikation folgenden Parameter hinzu und verweisen damit auf eine alternative Konfigurationsdatei mit den gewünschten Einstellungen:
java -jar topology-service.jar --spring.config.location=./Configuration/application.properties
Konfiguration der Schnittstellen, Versionen und Ports
Sie können den Service anhand der Datei topology-service.config konfigurieren. Ein Beispiel für einen Konfigurationsparameter ist in der der folgenden Tabelle beschrieben. Die Datei befindet sich im Verzeichnis
ROOT_PATH/org.eclipse.openk.domain.topology.topology-service