WildFly, früher bekannt als JBoss, ist ein kostenloser, quelloffener und plattformübergreifender Anwendungsserver, der jetzt von Red Hat entwickelt wird. WildFly ist in Java geschrieben und hilft Ihnen beim Erstellen großartiger Anwendungen. Mit seinen steckbaren Subsystemen können Sie die Anwendung nach Bedarf konfigurieren. In diesem Artikel erklären wir, wie ein Debian-Administrator Wildfly auf seinem System installieren und konfigurieren kann.
Wir haben die in diesem Artikel erwähnten Befehle und Prozeduren auf einem Debian 10 Buster-System ausgeführt.
WildFly installieren
Ein Debian-Administrator/(sudo-Benutzer) kann einen stabilen WildFly-Anwendungsserver installieren, indem er die folgenden Schritte sorgfältig durchführt:
Schritt 1:Öffnen Sie das Terminal oder verbinden Sie sich per SSH mit dem Server
Wir werden die Debian-Befehlszeile, das Terminal, verwenden, um WildFly zu installieren und zu konfigurieren. Sie können die Terminal-Anwendung über die Application Launcher-Suche wie folgt öffnen:
Schritt 2:Repository-Index aktualisieren
Um die neueste verfügbare Version einer Software aus den Internet-Repositorys zu installieren, muss Ihr lokaler Repository-Index damit übereinstimmen. Führen Sie den folgenden Befehl als sudo aus, um Ihren lokalen Repository-Index zu aktualisieren:
$ sudo apt-get update
Bitte beachten Sie, dass nur ein autorisierter Benutzer Software auf Debian hinzufügen, entfernen und konfigurieren kann.
Schritt 3:Installieren Sie das OpenJDK-Paket von APT
Bitte führen Sie den folgenden Befehl als sudo aus, um OpenJDK aus den APT-Repositories zu installieren:
$ sudo apt-get install default-jdk
Das System fragt Sie möglicherweise nach dem Passwort für sudo und bietet Ihnen auch eine Y/N-Option, um die Installation fortzusetzen. Geben Sie Y ein und drücken Sie dann die Eingabetaste.
Schritt 4:Erstellen Sie einen Benutzer und eine Gruppe für WildFly
Als ersten Schritt müssen Sie einen Benutzer und eine Gruppe erstellen, die später zum Ausführen des WildFly-Dienstes verwendet werden.
Führen Sie den folgenden Befehl aus, um eine neue Gruppe zu erstellen:
$ sudo groupadd -r wildfly
Führen Sie den folgenden Befehl aus, der autorisiert wird, den Dienst unter /opt/wildfly
auszuführen$ sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly
Tipp: Sie müssen während der Installation von WildFly einige lange Befehle verwenden. Anstatt einen Befehl einzugeben, können Sie ihn von hier kopieren und im Terminal einfügen, indem Sie Strg+Umschalt+V verwenden oder die Option Einfügen aus dem Rechtsklickmenü verwenden.
Schritt 5:Laden Sie die Wildfly-Installationsdatei herunter
Wir werden jetzt tar.gz für WildFly von der offiziellen JBoss-Website herunterladen.
Lassen Sie uns zunächst eine Variable erstellen, um die Versionsnummer von WildFly zu definieren, die wir herunterladen möchten.
$ Version_Number=16.0.0.Final
Ich möchte Version 16.0.0.Final auf mein System herunterladen. Diese Variable kann in allen Befehlen verwendet werden, bei denen Sie die WildFly-Version angeben müssen.
Führen Sie den folgenden Befehl aus, um die tar.gz-Datei in den /tmp-Ordner Ihres Debian herunterzuladen.
$ wget https://download.jboss.org/wildfly/$Version_Number/wildfly-$Version_Number.tar.gz -P /tmp
Schritt 6:Extrahieren Sie die WildFly tar.gz-Datei in den /opt-Ordner
Die WildFly-Software wird installiert, sobald Sie die heruntergeladene .tar.gz-Datei entpacken. Führen Sie den folgenden Befehl als sudo aus, um die Datei in den Ordner /opt zu extrahieren.
$ sudo tar xf /tmp/wildfly-$Version_Number.tar.gz -C /opt/
Schritt 7:Erstellen Sie einen symbolischen Link, der auf das WildFly-Installationsverzeichnis verweist
Führen Sie den folgenden Befehl aus, um einen symbolischen Link mit dem Namen wildfly zu erstellen. Dieser Link verweist auf das Installationsverzeichnis von Wildfly.
$ sudo ln -s /opt/wildfly-$Version_Number /opt/wildfly
Schritt 8:Geben Sie der wildfly-Gruppe und dem Benutzer Zugriff
Der WildFly-Benutzer und die WildFly-Gruppe müssen Eigentümer des WildFly-Installationsverzeichnisses sein, damit sie auf WildFly zugreifen und WildFly ausführen können.
Führen Sie dazu den folgenden Befehl aus:
$ sudo chown -RH wildfly: /opt/wildfly
Schritt 9:Wildfly so konfigurieren, dass es als Dienst ausgeführt wird
Bitte befolgen Sie diese Schritte sorgfältig, damit Sie WildFly so konfigurieren können, dass es als Systemd-Dienst ausgeführt wird:
1. Erstellen Sie ein Verzeichnis, in das wir die Datei wildfly.conf kopieren. Diese Datei ist Teil des WildFly-Pakets, das Sie heruntergeladen und installiert haben.
$ sudo mkdir -p /etc/wildfly
2. Kopieren Sie die Datei wildfly.conf aus den Paketdateien mit dem folgenden Befehl in das neu erstellte Verzeichnis:
$ sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/
3. Öffnen Sie die Konfigurationsdatei im Nano-Editor mit dem folgenden Befehl:
$ sudo nano /etc/wildfly/wildfly.conf
Sie können natürlich auch jeden Ihrer bevorzugten Texteditoren verwenden.
So sieht die Datei aus:
Diese Datei enthält vorerst die Grundkonfiguration für ein eigenständiges System. Wir werden später erläutern, wie diese Datei für benutzerdefinierte Konfigurationen bearbeitet wird, z. B. beim Versuch, remote auf die Verwaltungskonsole zuzugreifen.
4. Kopieren Sie als Nächstes das Skript launch.sh aus dem WildFly-Paket in den Ordner /opt/wildfly/bin/:
$ sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/
Machen Sie das Skript außerdem mit dem folgenden Befehl ausführbar:
$ sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh'
5. Die letzte zu kopierende Datei ist die Unit-Datei wildfly.service in den Dienstordner Ihres Systems /etc/systemd/system
$ sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/
6. Abschließend müssen Sie Ihrem System mitteilen, dass Sie eine neue Unit-Datei hinzugefügt haben. Dies kann durch Neuladen des systemctl-Daemons erreicht werden:
$ sudo systemctl daemon-reload
Sie können den WildFly-Dienst jetzt als Administrator ausführen.
Schritt 10:Führen Sie den WildFly-Dienst aus
Jetzt kann der WildFly-Dienst wie jeder andere von Debian erkannte Dienst ausgeführt werden.
Führen Sie den folgenden Befehl als sudo aus, um den Dienst zu starten:
$ sudo systemctl start wildfly
Sie können überprüfen, ob alles gut funktioniert, indem Sie den Status des Dienstes wie folgt überprüfen:
$ sudo systemctl status wildfly
Der Status „Aktiv“, wie oben hervorgehoben, bestätigt, dass der Dienst ausgeführt wird.
Eine andere Sache, die Ihnen helfen wird, ist, den Wildfly-Dienst beim Booten zu aktivieren:
$ sudo systemctl enable wildfly
Wildfly konfigurieren
Nachdem wir WildFly installiert und als Dienst ausgeführt haben, ist es an der Zeit, einige Konfigurationen vorzunehmen. Dazu gehören im Wesentlichen:
- Firewall anpassen
- Erstellen eines sicheren WildFly-Administrators
- Überprüfen der erfolgreichen Einrichtung
- Zugriff auf die WildFly-Administrationskonsole, lokal und remote
Bitte befolgen Sie diese Schritte nacheinander, damit Sie das WildFly-Portal zuverlässig nutzen können.
Schritt 1:Traffic auf Port 8080 zulassen
Wenn Sie möchten, dass auf Ihren WildFly-Server remote zugegriffen werden kann, müssen Sie Datenverkehr auf Port 8080 zulassen. Wenn Ihr Debian die UFW-Firewall-Anwendung nicht standardmäßig installiert hat, führen Sie den folgenden Befehl aus, um sie auf Ihrem System zu installieren:
$ sudo apt-get install ufw
Führen Sie dazu den folgenden Befehl aus:
$ sudo ufw allow 8080/tcp
Schritt 2:Erstellen Sie einen WildFly-Administrator
In diesem Schritt erstellen und konfigurieren wir einen WildFly-Benutzer. Dieser Benutzer ist ein Verwaltungsbenutzer/Administrator für die webbasierte Verwaltungskonsole und die CLI, die remote verwendet werden können.
Führen Sie den folgenden Befehl aus, um das Add-User-Skript aus dem WildFly-Verzeichnis auszuführen:
$ sudo /opt/wildfly/bin/add-user.sh
Das hier folgende Verfahren ist ziemlich selbsterklärend, aber wir werden Sie trotzdem anleiten.
Das Skript fragt Sie zunächst, ob Sie einen Verwaltungsbenutzer oder einen Anwendungsbenutzer erstellen möchten:
Drücken Sie einfach die Eingabetaste, um anzugeben, dass Sie einen Verwaltungsbenutzer erstellen möchten.
Das Skript fordert Sie dann auf, Details über den neuen Benutzer hinzuzufügen. Dazu gehört das Hinzufügen eines Benutzernamens des neuen Administrators und das Festlegen und erneute Eingeben des Passworts wie folgt:
Im obigen Bild sehen Sie, dass ich einen Benutzer namens „admin-wildfly“ erstellt habe.
Die nächste Eingabeaufforderung fragt Sie, ob der Benutzer in der Lage sein soll, die Konsole remote zu verwenden.
Geben Sie y ein und das Skript überprüft die Benutzererstellung durch die folgende Nachricht:
Dieser Benutzer kann jetzt administrative Funktionen auf WildFly ausführen.
Schritt 3:Überprüfen Sie die erfolgreiche Einrichtung von WindFly
Lassen Sie uns nun überprüfen, ob unser WindFly-Server betriebsbereit ist. Öffnen Sie Ihren Browser und geben Sie die folgende URL ein:
http://
Ich teste das Setup auf meinem localhost:
http://localhost:8080/
Wenn Sie etwas Ähnliches wie oben sehen, können wir Ihnen versichern, dass Ihre WildFly-Instanz betriebsbereit ist.
Wie öffne ich die Verwaltungskonsole über die Webschnittstelle?
Geben Sie in Ihrem Browser die folgende URL ein, um die Verwaltungskonsole über das lokale System zu öffnen:
http://localhost:9990/console
Geben Sie den Benutzernamen und das Passwort des Verwaltungsbenutzers an, den Sie in Schritt 2 von „WildFly konfigurieren“ erstellt haben. Die Konsole wird wie folgt geöffnet, wenn Sie auf die Schaltfläche OK klicken:
Administrationskonsole remote verwalten
Um remote auf die Verwaltungskonsole zuzugreifen, müssen Sie kleine Konfigurationen an drei WildFly-Dateien vornehmen.
1. Öffnen Sie die Datei wildfly.conf mit dem folgenden Befehl:
$ sudo nano /etc/wildfly/wildfly.conf
Fügen Sie am Ende der Datei die folgenden Zeilen hinzu:
# The address console to bind to WILDFLY_CONSOLE_BIND=0.0.0.0
So sollte die Datei aussehen:
Beenden Sie die Datei mit Strg+X und speichern Sie die Änderungen, indem Sie y und dann die Eingabetaste drücken.
2. Öffnen Sie die Startskriptdatei .sh mit dem folgenden Befehl:
$ sudo nano /opt/wildfly/bin/launch.sh
Ändern Sie die hervorgehobenen Zeilen wie folgt:
$WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4 else $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4
Beenden Sie die Datei mit Strg+X und speichern Sie die Änderungen, indem Sie y und dann die Eingabetaste drücken.
Starten Sie danach den WildFly-Dienst mit dem folgenden Befehl neu:
$ sudo systemctl restart wildfly
3. Bearbeiten Sie abschließend die Datei wildfly.service mit dem folgenden Befehl:
$ sudo nano /etc/systemd/system/wildfly.service
Ersetzen Sie die hervorgehobene Zeile durch Folgendes:
ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND
Da wir die Service-Unit-Datei geändert haben, lassen Sie uns das System mit dem folgenden Befehl benachrichtigen:
$ sudo systemctl daemon-reload
Starten Sie außerdem den WildFly-Dienst mit dem folgenden Befehl neu:
$ sudo systemctl restart wildfly
Sie können jetzt auf die Konsole zugreifen, indem Sie auf einem Remote-Computer die folgende Konsole eingeben:
http://
Bitte stellen Sie sicher, dass Port 9990 auf Ihrer Firewall für Datenverkehr geöffnet ist.
So öffnen Sie die CLI der Verwaltungskonsole
Öffnen Sie Ihr Debian-Terminal und wechseln Sie in den Ordner /opt/wildfly/bin, von wo aus wir das CLI-Skript ausführen werden:
$ cd /opt/wildfly/bin/
Geben Sie dann den folgenden Befehl ein, um das CL-Skript der WildFly-Verwaltungskonsole auszuführen:
$ ./jboss-cli.sh --connect
Sie befinden sich jetzt in der „[[email protected]:9990 /]-Konsole.
Geben Sie „Hilfe“ ein, um zu sehen, was Sie hier alles tun können.
Ich werde die Versionsnummer überprüfen, indem ich den Befehl „version“ eingebe:
Sie haben WildFly erfolgreich auf Ihrem System installiert und konfiguriert. Sie wissen auch, wie Sie WildFly und Ihr System so konfigurieren, dass Sie remote auf die Verwaltungskonsole zugreifen können.