Die Installation von WSO2-Produkten auf Linux, Windows und Mac

Die drei Hauptprodukte von WSO2, der API Manager, der Identity Server und der Micro Integrator, können schnell auf Ihrem lokalen Computer installiert werden. In diesem Blog beschreiben wir das allgemeine Installationsverfahren, das für alle drei Produkte auf Windows, Linux oder Mac gleich ist. Wir werden dies am Beispiel des Micro Integrators erläutern und in den abschließenden Anweisungen auch auf die anderen beiden Produkte eingehen.

Wenn Sie den Micro Integrator (MI) ausprobieren möchten, um zu sehen, was das Produkt kann, können Sie es leicht auf Ihrem lokalen Rechner installieren. WSO2-Software nennen wir „any prem“, sie kann lokal, in der Cloud und auf Ihrem Server ausgeführt werden, was ein großer Vorteil ist. Es spielt keine Rolle, ob Sie es auf Linux, Windows oder Mac installieren.

In der Tat gibt es viele Gemeinsamkeiten zwischen beiden Umgebungen. Dazu gehören der Download der Binärdateien und die Konfiguration von Java usw.

Die Installation auf allen drei Plattformen ist recht einfach und kann in wenigen Minuten abgeschlossen werden. Dabei spreche ich natürlich nicht von einer „echten“ Installation, bei der Sie WSO2 MI für die Produktion oder sogar ein Proof of Concept konfigurieren. Nein, ich spreche davon, es schnell zu installieren, um eine der Mediationen aus einem unserer Blogs zum Beispiel auszuprobieren.

Open Source oder Produktsupport

Welche Auswahlmöglichkeiten haben Sie? Zunächst die Wahl der Version. Entscheiden Sie sich für die Open-Source-Version, die Sie von GitHub herunterladen können, oder verwenden Sie die Version, die Sie von der Website von WSO2 herunterladen können, die nicht Open Source ist, aber eine Produktsupport-Lizenz erfordert, wenn Sie sie in der Produktion einsetzen. Ich empfehle Ihnen, beim Herunterladen der Datei die EULA-Bestimmungen zu lesen, um zu entscheiden, was für Sie am besten ist.

Aber zurück zur Quellcodebasis. Sie können sie hier finden, und seit einigen Monaten stellt WSO2 nicht mehr die Binärdateien, sondern nur noch den Quellcode zur Verfügung. Sie laden einfach den Quellcode herunter, aber um ihn verwenden zu können, ist ein Maven-Build erforderlich, um die Binärdateien zu erstellen. Das ist im Grunde genommen keine große Arbeit, wie Sie auf dem Screenshot sehen können. Maven ist das Build-Tool, um das Produkt aus dem Quellcode zu erstellen. Ich gehe hier nicht zu sehr ins Detail über diesen Prozess, Sie finden eine Reihe von Blogs zum Erstellen aus dem Quellcode auf der Yenlo-Website.

Wenn Ihnen das zu viel Arbeit erscheint und Sie davon nicht gestört werden möchten, empfehle ich Ihnen, die Version von WSO2 herunterzuladen. Der Micro Integrator befindet sich im Integrationsbereich der Website. Die Dokumentation befindet sich jedoch noch beim API Manager, da der Micro Integrator in den letzten Versionen nur über die API Management-Downloadseite zugänglich war. Macht das Sinn? Ja und nein. Der API Manager und der Micro Integrator sind Geschwister und arbeiten gut zusammen, obwohl es sich um verschiedene Produkte mit unterschiedlichen Anwendungsfällen handelt.

Gehen Sie zu dieser URL, um es herunterzuladen: https://wso2.com/integrator/micro-integrator/ .

Klicken Sie auf „Herunterladen“.

Geben Sie eine geschäftliche E-Mail-Adresse ein, also keine wie Gmail oder andere kostenlose E-Mail-Dienste. Akzeptieren Sie die Softwarelizenz. Der Download erfolgt nicht sofort, Sie erhalten einen Link zum einmaligen Herunterladen der Zip-Datei. Wenn Sie es ein zweites Mal herunterladen möchten, müssen Sie den Vorgang wiederholen. Sie erhalten eine E-Mail, in der Sie einen Download-Button finden.

Damit startet der Download der Zip-Datei. Sie finden sie im Download-Ordner Ihres Computers und um mit der Installation fortzufahren, werden wir sie auf den Desktop kopieren. Wenn Sie das getan haben, erstellen Sie ein Verzeichnis namens MI420. Verwenden Sie Ihr Archivierungs- oder Zip-Manager, um die Zip-Datei in dieses Verzeichnis zu extrahieren. Ich zeige hier den Linux-Download, das Prinzip ist bei Windows dasselbe

Bis jetzt waren alle Anweisungen unabhängig vom Betriebssystem. Ab diesem Punkt werden wir die Konfiguration für die Linux-Umgebung zeigen, in diesem Fall unsere CentOS-Umgebung. Wenn es Unterschiede für Windows oder Mac gibt, werden wir sie angeben.

Es wird so aussehen

Was wir jetzt tun müssen, ist auch JAVA herunterzuladen. Möglicherweise haben Sie bereits eine Java-Version auf Ihrem Rechner, aber in diesem Fall werde ich JDK17 herunterladen, da MI 4.2.0 diese Version unterstützt (genauso wie Java 11).

Die Liste nennt eigentlich die folgenden JDKs.

Ich werde das Adopt OpenJDK als Zip-Datei herunterladen. Nach dem Download entpacken Sie es bitte auch in das MI420-Verzeichnis.

Das Verzeichnis sieht jetzt so aus.

Nun erstellen wir eine Batch-Datei, die vorübergehend JAVA_HOME festlegt und den PATH erweitert, um die in unserem Verzeichnis befindliche Java-Version zu verwenden. Dies bedeutet, dass es nicht mit anderen Versionen, die Sie möglicherweise haben, kollidiert, da die Einstellungen nur für die Dauer der Ausführung der Batch-Datei gelten.

Der Code ist eigentlich recht einfach.

Dies ist der Code für Linux:

export OLDPATH=$PATH

export OLDJH=$JAVA_HOME

echo Setting JAVA_HOME

export "JAVA_HOME=/opt/wso2/Desktop/MI420/jdk-17.0.7+7"

echo JAVA_HOME: $JAVA_HOME

echo Setting PATH

export "PATH=/opt/wso2/Desktop/MI420/jdk-17.0.7+7/bin;$PATH"

echo PATH: $PATH

echo starting WSO2 MI 4.2.0

cd /opt/wso2/Desktop/MI420/wso2mi-4.2.0/bin

sh micro-integrator.sh

cd ../..

export PATH=$OLDPATH

export JAVA_HOME=$OLDJH

echo JAVA_HOME: $JAVA_HOME

echo Done

Für Windows ist das Skript etwas anders, aber nicht viel. Hauptsächlich in der Art und Weise, wie Windows mit Verzeichnissen umgeht, zum Beispiel mit dem Backslash anstelle des Schrägstrichs.

@set OLDPATH=%PATH%

@set OLDJH=%JAVA_HOME%

@echo Setting JAVA_HOME

@SET "JAVA_HOME=C:\Users\rob\Desktop\MI420\jdk-17.0.7+7"

@echo JAVA_HOME: %JAVA_HOME%

@echo Setting PATH

@SET "PATH=C:\Users\rob\Desktop\MI420\jdk-17.0.7+7\bin;%PATH%"

@echo PATH: %PATH%

@echo starting WSO2 MI 4.2.0

@cd C:\Users\rob\Desktop\MI420\wso2mi-4.2.0\bin

@start micro-integrator.bat

@cd ..\..

@set PATH=%OLDPATH%

@set JAVA_HOME=%OLDJH%

@echo JAVA_HOME: %JAVA_HOME%

@echo Done

Wenn Sie das Skript in einem Terminal ausführen, sieht es auf Linux so aus.

Wie Sie sehen können, ist JAVA_HOME nicht betroffen, nur innerhalb des Terminals wird es festgelegt. Der Code stellt eigentlich die alten Einstellungen von Pfad und JAVA_HOME wieder her..

Windows

Für Windows ist der beste Weg, Micro Integrator zu starten, das Öffnen eines CMD-Fensters anstelle des Klickens auf das Symbol in der normalen Ordneransicht. Wenn etwas schief geht, können Sie in einem CMD-Fenster die Fehlermeldung sehen, während es bei einem Klick und einem Fehler direkt geschlossen wird, ohne die Möglichkeit, zu sehen, was schief gelaufen ist.

Mac

Auf einem Mac ist das Skript ähnlich wie auf Linux, aber der Pfad von Java Home ist anders, da die Verzeichnisstruktur des heruntergeladenen JDK von Mac anders ist.

Dies ist der Code für Mac

export OLDPATH=$PATH

export OLDJH=$JAVA_HOME

echo Setting JAVA_HOME

export "JAVA_HOME=/Users/rob/Desktop/MI420/jdk-17.0.7+7/Contents/Home"

echo JAVA_HOME: $JAVA_HOME

echo Setting PATH

export "PATH=/Users/rob/Desktop/MI420/jdk-17.0.7+7/Contents/Home;$PATH"

echo PATH: $PATH

echo starting WSO2 MI 4.2.0

cd /Users/rob/Desktop/MI420/wso2mi-4.2.0/bin

sh micro-integrator.sh

cd ../..

export PATH=$OLDPATH

export JAVA_HOME=$OLDJH

echo JAVA_HOME: $JAVA_HOME

echo Done

Wenn Sie das Skript in einem Terminal ausführen, sieht es auf einem Mac so aus.

Testen

Das ist die Installation des Micro Integrators auf Ihrem lokalen Rechner. Wie wissen wir, dass es funktioniert? Nun, wir können eine einfache API auf den Micro Integrator setzen. Ich werde kein Integration Studio verwenden, sondern Ihnen erlauben, eine XML Synapse-Konfiguration zu erstellen und diese direkt in das Synapse Config-Verzeichnis zu kopieren.

Die API wird die icanhazdadjoke.com-API verwenden, die dort verfügbar ist, und einen Witz zurückgeben. Kopieren Sie diesen Code in eine XML-Datei mit dem Namen joke.xml und speichern Sie ihn in einem Verzeichnis namens api. Dieses Verzeichnis existiert noch nicht, Sie müssen es also erstellen.

<?xml version="1.0" encoding="UTF-8"?>

<api context="/joke" name="joke" xmlns="http://ws.apache.org/ns/synapse">

    <resource methods="GET">

        <inSequence>

            <property action="remove" name="REST_URL_POSTFIX" scope="axis2"/>

            <header name="Accept" scope="transport" value="application/json"/>

            <call>

                <endpoint>

                    <http uri-template="https://icanhazdadjoke.com/">

                        <suspendOnFailure>

                            <initialDuration>-1</initialDuration>

                            <progressionFactor>-1</progressionFactor>

                            <maximumDuration>0</maximumDuration>

                        </suspendOnFailure>

                        <markForSuspension>

                            <retriesBeforeSuspension>0</retriesBeforeSuspension>

                        </markForSuspension>

                    </http>

                </endpoint>

            </call>

            <respond/>

        </inSequence>

        <outSequence/>

        <faultSequence/>

    </resource>

</api>

Hier müssen Sie es erstellen: [MI-HOME]/repository/deployment/server/synapse-configs/default/api.

Es reicht aus, die Datei dort abzulegen. MI liest und implementiert sie.

Öffnen Sie nun ein Browserfenster und kopieren Sie diese URL:

http://localhost:8290/joke

Die von uns implementierte API gibt einen Witz zurück.

Dies ist eine ziemlich schnelle und einfache Möglichkeit, eine API bereitzustellen. Normalerweise würden wir ein Integrationsprojekt in Integration Studio erstellen und die API mit einem Composite Exporter bereitstellen. Für einen schnellen Test wie diesen funktioniert es jedoch gut und erfordert keine Installation und Erklärung von Integration Studio, um zu sehen, ob das Produkt funktioniert.

Installation anderer WSO2-Produkte

Der API Manager und der Identity Server können auf ähnliche Weise installiert werden. Die Unterschiede sind natürlich:

• Der Download-Ort für die Produkte, dies gilt für den API Manager und dies für den Identity Server
• In den einzelnen Skripten der Name der Verzeichnisse (z.B. wso2am-4.2.0 und wso2is-6.1.0) und der Startbefehle (api-manager.sh/bat wso2server.sh/bat)

Ein schnelles Beispiel für den API Manager unter Windows mit den Änderungen im Vergleich zu Micro Integrator in Gelb:

@set OLDPATH=%PATH%

@set OLDJH=%JAVA_HOME%

@echo Setting JAVA_HOME

@SET "JAVA_HOME=C:\Users\rob\Desktop\AM420\jdk-17.0.7+7"

@echo JAVA_HOME: %JAVA_HOME%

@echo Setting PATH

@SET "PATH=C:\Users\rob\Desktop\AM420\jdk-17.0.7+7\bin;%PATH%"

@echo PATH: %PATH%

@echo starting WSO2 AM 4.2.0

@cd C:\Users\rob\Desktop\MI420\wso2am-4.2.0\bin

@start api-manager.bat

@cd ..\..

@set PATH=%OLDPATH%

@set JAVA_HOME=%OLDJH%

@echo JAVA_HOME: %JAVA_HOME%

Natürlich gibt es weitere Optionen wie die Ausführung in einem Container. Das könnte ein interessantes Thema für einen kommenden Blog sein.

Vielen Dank an Saad Sahibjan für seine Hilfe auf dem Mac