In diesem Blog werde ich eine allgemeine Methode zur Installation von WSO2 Enterprise Integrator auf Ihrem Windows-Rechner beschreiben. Wieso allgemein? Nun, ganz einfach, weil sich die Versionen des Enterprise Integrators zwar unterscheiden können, die Installationsprozedur für den Enterprise Integrator – und generell für alle WSO2 Produkte – aber ziemlich gleich ist. Ich beschreibe hier eine Situation, in der wir so wenig wie möglich installieren und auch keine dauerhaften Änderungen am PC vornehmen. Sicherlich können wir auch in VirtualBox mit Vagrant arbeiten, aber das würde zusätzliche Installationen erfordern, die ich gerne vermeiden möchte.
Hardware und Betriebssystem
Was brauchen wir also, was brauchen wir? Zunächst einmal einen Windows-PC. Obwohl auch andere Betriebssysteme funktionieren (z.B. Linux), erfordern sie eine andere Einrichtung, und dieser Blog befasst sich mit der Installation auf Windows. Und um genau zu sein: Windows 10.
Microsofts Strategie, Windows 10 mit kostenlosen Updates auf den Markt zu bringen, hat mit mehr als 1 Milliarde Geräten, auf denen Windows 10 läuft, sicherlich funktioniert. Allerdings werden die älteren Versionen wahrscheinlich auch funktionieren. Was die Hardware angeht, so brauchen wir einen modernen PC, d.h. Intel Core I3, i5, I7 oder entsprechende Chips von AMD, 8 Gigabyte Ram und all die anderen Dinge, die Sie von einem modernen PC erwarten.
Java
WSO2 ist größtenteils in Java geschrieben und daher wird ein JDK oder JRE benötigt. Diese bieten die Umgebung, die für die Ausführung von WSO2 erforderlich ist. Es gibt verschiedene Java-Versionen, die derzeit von 1 bis 18 durchnummeriert sind. WSO2 erfordert jedoch entweder Java 8 oder 11. Für den Enterprise Integrator ist Java 8 eine gute Wahl, da es mit älteren Versionen des Enterprise Integrators kompatibel ist. Wenn Sie beispielsweise an Enterprise Integrator 6.6.0 festhalten, funktioniert Java 11. Was die Verteilung anbelangt, so ist Adopt OpenJDK in Ordnung, aber auch andere sind geeignet.
Lassen Sie mich mit dem Download von Adopt OpenJDK 11 von dieser URL beginnen (Java 8 finden Sie ebenfalls hier). Wir verwenden die Zip-Datei und nicht das Installationsprogramm (MSI). Stellen Sie sicher, dass Sie die richtige Version haben, d.h. x64.
WSO2
Für diesen Blog werde ich die Apache 2.0 Version des Enterprise Integrators verwenden. Die Version kann wie in der Lizenz beschrieben frei verwendet werden, ist aber nicht für den Einsatz in einer Produktionsumgebung geeignet.
Ich lade die Version direkt von der WSO2 GitHub-Seite für Enterprise Integrator herunter. Laden Sie bitte beide Dateien herunter, wso2am-6.6.0.zip. Es empfiehlt sich, auch die MD5-Checksumme (wso2am-6.6.0.zip.md5) herunterzuladen, um den Download zu überprüfen. Wenn Sie die Checksumme auf Ihrem PC ermitteln, sollte sie mit der heruntergeladenen Summe übereinstimmen. Der Analytics for Enterprise Integrator ist Teil des Downloads und muss nicht separat heruntergeladen werden.
Öffnen Sie ein CMD-Fenster und geben Sie den folgenden Befehl ein.
CertUtil -hashfile <path to file> MD5
Ändern Sie den <path to file> in den tatsächlichen Dateipfad und den Speicherort der Datei.
Vergleichen Sie das Ergebnis mit der MD5-Dateiwso2ei-6.6.0.zip: A4 7A 00 E2 EA 72 2A 91 C3 62 69 60 06 7C E6 33. Der einzige Unterschied ist die Klein-/Großschreibung. Das gleiche gilt auch für die Analytics-Zip-Datei.
Ein Verzeichnis erstellen
Erstellen Sie ein Verzeichnis, z.B. auf dem Desktop, mit dem Datei-Explorer. Nennen Sie es z.B. WSO2-AM.
Kopieren Sie die drei heruntergeladenen Dateien (JDK und EI) in dieses Verzeichnis. Entpacken Sie jede Zip-Datei. Das Ergebnis ist das folgende:
Ich möchte keine Umgebungsvariablen oder Pfadeinstellungen ändern, also werde ich eine Batch-Datei erstellen, die die erforderlichen Variablen setzt, wie z.B.:
- JAVA_HOME
- PATH
Diese Änderung gilt nur für die Dauer der Batch-Datei.
Aber zuerst müssen wir die Analytik im WSO2 Enterprise Integrator aktivieren. Hierzu müssen wir die Datei carbon.xml in [EI-HOME]/conf ändern.
Suchen Sie nach Analytics und validieren Sie die Einstellungen:
Öffnen Sie die Datei synapse.properties in [EI-HOME]/conf und setzen Sie diese Werte auf true. Speichern Sie die Datei.
Wir haben nun Analytics aktiviert.
Alles starten
Die Batch-Datei sieht in etwa so aus. Damit werden die Parameter JAVA_HOME und PATH für die Dauer der Batch-Datei und des Befehlsfensters festgelegt. Ändern Sie den Speicherort (d.h. C:\Users…) so, dass er mit Ihrer lokalen Installation übereinstimmt.
@set OLDPATH=%PATH%
@set OLDJH=%JAVA_HOME%
@echo Setting JAVA_HOME
@SET "JAVA_HOME=C:\Users\rob\Desktop\WSO2-EI\jdk-11.0.11+9"
@echo JAVA_HOME: %JAVA_HOME%
@echo Setting PATH
@SET "PATH=C:\Users\rob\Desktop\WSO2-EI\jdk-11.0.11+9\bin;%PATH%"
@echo PATH: %PATH%
@echo starting WSO2 AM Analytics Worker Node
@cd C:\Users\rob\Desktop\WSO2-EI\wso2ei-6.6.0\wso2\analytics\bin
@start worker.bat
@echo starting WSO2 AM Analytics Dashboard Node
@cd C:\Users\rob\Desktop\WSO2-EI\wso2ei-6.6.0\wso2\analytics\bin
@start dashboard.bat
@echo starting WSO2 AM 6.6.0
@cd C:\Users\rob\Desktop\WSO2-EI\wso2ei-6.6.0\bin
@start integrator.bat
@cd ..\..
@set PATH=%OLDPATH%
@set JAVA_HOME=%OLDJH%
@echo DoneErgebnis
Dadurch werden der Worker, das Dashboard und der Enterprise Integrator in drei separaten Fenstern gestartet, ohne dass dauerhafte Änderungen am Computer vorgenommen werden. Für die Dauer der Befehls-/Terminalsitzung sind die Werte zwar geändert, aber auch auf ihre ursprünglichen Werte zurückgesetzt. Sie können auf den Enterprise Integrator über die Management UI (https://localhost:9643/portal) in Ihrem Browser zugreifen. Dies ist der Link zum Analytics Dashboard (https://localhost:9643/portal).
Fazit
Auf diese Weise können Sie WSO2 Enterprise Integrator und Analytics auf Ihrem PC einfach und unkompliziert installieren. Wenn Sie das Setup mit PowerShell vollständig automatisieren würden, können Sie eine einfache Batch-Datei erstellen, die Sie immer dann ausführen können, wenn Sie ein Setup auf Ihrem PC benötigen.
Wenn Sie mehr über Enterprise Integrator erfahren möchten, schauen Sie sich bitte unsere Yenlo-Schulungsseiten an.
