Administration und Installation
1. Hardware-Voraussetzungen 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
2. Software-Voraussetzungen Folgende Installationen und Konfigurationen wurden gemäß Dokumentation ausgeführt: • 64-bit-Windows-Umgebung* in der Version 10. • Oracle Java-Runtime-Umgebung in der Version 1.8 Download-Link: https://java.com/de/download/ • Apache Maven Umgebung in der Version 3.3.9 oder höher Download-Link: https://maven.apache.org/download.cgi • Mozilla Firefox-Browser in der Version 52 oder höher Download-Link: https://www.mozilla.org Die für das Projekt notwendigen Sourcen (veröffentlichte Quelltexte) können Sie vom Eclipse-Git herunterladen. Download-Link: https://projects.eclipse.org/projects/technology.openk-platform
3. Projektstruktur Alle relevanten Projektverzeichnisse und Dateien befinden auf dem lokalen Rechner in einem gemeinsamen Verzeichnis (z.B.: C:/oK), das im Folgenden als Vorlage:ROOT PATH bezeichnet wird:
org.eclipse.openk.core.cab.common org.eclipse.openk.core.cab.service org.eclipse.openk.core.cab.tools.contrigger org.eclipse.openk.core.cim.cim17v16 org.eclipse.openk.core.domain.measurement org.eclipse.openk.core.domain.measurement-service org.eclipse.openk.core.domain.topology org.eclipse.openk.core.domain.topology.api org.eclipse.openk.core.domain.topology.service org.eclipse.openk.core.sourcesystem.mockuptechnology pom.xml
4. Kompilieren des CIM Cache auf der Basis der veröffentlichten Quelltexte
1. Innerhalb der Konsole in das Verzeichnis Vorlage:ROOT PATH wechseln. 2. Basierend auf der in diesem Verzeichnis liegenden Maven Konfigurationsdatei ‚pom.xml‘, welche als Aggregator-Pom definiert ist, wird der Befehl zum Bauen der Applikation gegeben:
mvn clean install
Der Mechanismus in Maven ist in der Lage, Multi-Modul-Projekte zu verarbeiten und wird als Reaktor bezeichnet. Auf dieser Basis führt Maven folgende Schritte durch:
• Sammeln aller zum Bauen notwendigen Module • Sortieren der Module entsprechend der zum Bauen korrekten Reihenfolge • Bauen der einzelnen Module in der vorgegebenen Reihenfolge
5. Starten der Applikation
Der Start des CIM-Cache setzt die Verfügbarkeit des Quelldatensystems voraus. Dabei ist zu berücksichtigen, dass alle notwendigen Applikationen auf unterschiedlichen Ports laufen. Diese lassen sich, wie in Abschnitt 6 beschrieben, konfigurieren.
5.1 Starten des Quelldatensystems
1. Innerhalb der Konsole in das folgende Verzeichnis wechseln:
Vorlage:ROOT PATH/org.eclipse.openk.core.sourcesystem.mockuptechnology.
2. Das Quelldatensystem mit dem folgenden Befehl starten:
java -jar mock-up-topology-0.0.1-SNAPSHOT.jar
5.2 Starten des CIM-Cache 1. Innerhalb der Konsole in das folgende Verzeichnis wechseln: Vorlage:ROOT PATH/org.eclipse.openk.core.domain.topology.service
2. Den CIM-Cache mit dem folgenden Befehl starten:
java -jar topology-0.0.1-SNAPSHOT.jar
6. Beenden der Applikation
Die Applikation wird beendet, indem die Konsole(n), in welcher die Applikation(en) gestartet wurden, geschlossen werden.
7. Anstoßen des Neuaufbaus des Datenmodells
Nach einem Post-Request an /commands/reload-topology/executions wird das Datenmodell neu eingelesen. Zum Absetzen des Kommandos kann die folgende HTML-Seite verwendet werden:
http://
8. Prüfen des CIM-Cache-Start durch einen Service-Aufruf
Zur Überprüfung des Starts des CIM-Cache wird im Firefox-Browser die folgende URL aufgerufen:
Das Ergebnis sollte eine in XML formatierte Liste der dem System bekannten Leitungsabschnitte darstellen.
9. 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: Vorlage:ROOT PATH/org.eclipse.openk.core.domain.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
10. 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
Vorlage:ROOT PATH/org.eclipse.openk.core.domain.topology.service.
