In diesem Blog beschreibe ich eine generische Art der Installation des WSO2 API Manager auf Ihrem Windows-Rechner. Wieso generisch? Nun, ganz einfach, weil sich die Versionen des API Managers zwar ändern können, die Installationsprozedur für den API Manager und generell für alle WSO2-Produkte aber so ziemlich die gleiche ist. Ich beschreibe hier eine Situation, in der wir so wenig wie möglich installieren und auch keine dauerhaften Änderungen am PC vornehmen. Wir können sicher 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 andere Betriebssysteme natürlich auch funktionieren (z.B. Linux), benötigen sie eine andere Einrichtung, und in diesem Blog geht es um die Installation unter Windows – um genauer 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 betrifft, 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 liefern 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. Für WSO2 ist jedoch entweder Java 8 oder 11 erforderlich. Für den API Manager ist Java 8 eine gute Wahl, da es auch ältere Versionen des API Managers unterstützt. Wenn Sie beispielsweise bei API Manager 3.2.0 bleiben, funktioniert Java 11. Was die Distribution anbelangt, so ist Adopt OpenJDK in Ordnung, aber auch andere funktionieren.
Laden Sie zunächst Adopt OpenJDK 11 von dieser URL herunter (Java 8 finden Sie ebenfalls hier). Wir verwenden die Zip-Datei und nicht das Installationsprogramm (MSI). Stellen Sie sicher, dass Sie die richtige Version verwenden, d.h. x64.
WSO2
Für diesen Blog werde ich die Apache 2.0 Version des API Managers verwenden. Diese 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 API Manager herunter. Sie können beide Dateien herunterladen, wso2am-3.2.0.zip und wso2am-analytics-3.2.0.zip. Es ist ratsam, auch die MD5-Prüfsumme herunterzuladen (wso2am-3.2.0.zip.md5 und wso2am-analytics-3.2.0.zip.md5), um den Download zu überprüfen. Wenn Sie auf Ihrem PC die Checksum berechnen, sollte sie mit der heruntergeladenen Summe übereinstimmen.
Öffnen Sie ein CMD-Fenster und geben Sie den folgenden Befehl ein:
CertUtil -hashfile <path to file> MD5
Ändern Sie <path to file> in den tatsächlichen Pfad und den Speicherort der Datei.
Vergleichen Sie dies mit der MD5-Datei wso2am-3.2.0.zip: 08EFC5AD08626CA5E0799F63A56B728F. Der einzige Unterschied ist die Klein-/Großschreibung. Wiederholen Sie den Vorgang 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, AM und Analytics) in dieses Verzeichnis. Entpacken Sie jede Zip-Datei. Sie erhalten dann das folgende Ergebnis:
Da ich keine Umgebungsvariablen oder Pfadeinstellungen ändern möchte, 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 Analytics im WSO2 API Manager aktivieren. Dies geschieht durch Ändern der Datei deployment.toml in [AM-HOME]/repository/conf.
Suchen Sie nach Analytics.
Entfernen Sie die Markierung und setzen Sie enable auf true.
Speichern Sie die Datei. Wir haben jetzt Analytics aktiviert.
Alles starten
Die Batch-Datei sieht in etwa so aus. Die Parameter JAVA_HOME und PATH werden damit für die Dauer der Batch-Datei und des Befehlsfensters festgelegt. Ändern Sie den Speicherort (d.h. C:\Users…) entsprechend Ihrer lokalen Installation.
@set OLDPATH=%PATH%
@set OLDJH=%JAVA_HOME%
@echo Setting JAVA_HOME
@SET "JAVA_HOME=C:\Users\rob\Desktop\WSO2-AM\jdk-11.0.11+9"
@echo JAVA_HOME: %JAVA_HOME%
@echo Setting PATH
@SET "PATH=C:\Users\rob\Desktop\WSO2-AM\jdk-11.0.11+9\bin;%PATH%"
@echo PATH: %PATH%
@echo starting WSO2 AM Analytics Worker Node
@cd C:\Users\rob\Desktop\WSO2-AM\wso2am-analytics-3.2.0\bin
@start worker.bat
@echo starting WSO2 AM Analytics Dashboard Node
@cd C:\Users\rob\Desktop\WSO2-AM\wso2am-analytics-3.2.0\bin
@start dashboard.bat
@echo starting WSO2 AM 3.2.0
@cd C:\Users\rob\Desktop\WSO2-AM\wso2am-3.2.0\bin
@start wso2server.bat
@cd ..\..
@set PATH=%OLDPATH%
@set JAVA_HOME=%OLDJH%
@echo Done
@set PATH=%OLDPATH%
@set JAVA_HOME=%OLDJH%
@echo Done
Ergebnis
Dadurch werden der Worker, das Dashboard und der API Manager in drei separaten Fenstern gestartet, ohne dass dauerhafte Änderungen am Computer vorgenommen werden. Lediglich für die Dauer der Befehls-/Terminalsitzung werden die Werte geändert, aber auch auf ihre ursprünglichen Werte gesetzt. Sie können über die Management UI, das Publisher portal, oder das Devportal in Ihrem Browser auf den API Manager zugreifen. Dies ist der Link zum Analytics Dashboard.
Fazit
Dies ist eine einfache und unaufdringliche Möglichkeit, WSO2 API Manager und Analytics auf Ihrem PC zu installieren. Wenn Sie das Setup mit PowerShell vollständig automatisieren würden, könnten 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 noch mehr über den API Manager erfahren möchten, werfen Sie einen Blick auf unsere Yenlo Schulungsseiten.