So installieren Sie den GlassFish-Anwendungsserver mit Nginx-Reverse-Proxy auf Debian 12

GlassFish ist eine kostenlose und Open-Source-Implementierung der Java EE-Plattform, die von Eclipse entwickelt wurde. Es ist die weltweit erste Implementierung der Java EE-Plattform, die einen leichten Anwendungsserver bereitstellt und es Ihnen ermöglicht, mehrere Java-basierte Anwendungen bereitzustellen. GlassFish unterstützt mehrere Arten von Java-Anwendungstechnologien wie Enterprise JavaBeans, JPA, JavaServer Faces, JMS und viele mehr.

GlassFish ist eine der besten Wahlmöglichkeiten für Entwickler, um Java-basierte Anwendungen zu entwickeln und bereitzustellen. Es ermöglicht Entwicklern, Unternehmensanwendungen auf bequeme Weise und mit einer skalierbaren Architektur zu entwickeln. Das GlassFish-Projekt wurde ursprünglich von Sun Microsystems gestartet. Es kommt mit zwei verschiedenen kostenlosen Lizenzen - der Common Development and Distribution License und der GNU General Public License.

In diesem Leitfaden installieren Sie den GlassFish-Anwendungsserver auf Debian 12 in einem schrittweisen Prozess. Sie werden auch Nginx als Reverse-Proxy für Ihre GlassFish-Installation konfigurieren.

Voraussetzungen

Um den Prozess zu beginnen, stellen Sie sicher, dass Sie Folgendes haben:

Einen Debian 12-Server mit mindestens 4 GB RAM oder Speicher.
Einen Nicht-Root-Benutzer mit Sudo-Rechten.

Java OpenJDK installieren

GlassFish ist ein Anwendungsserver zum Bereitstellen von Java-Anwendungen. Um GlassFish zu installieren, müssen Sie zuerst Java auf Ihrem Debian-System installieren. Zu diesem Zeitpunkt bietet das Debian-Repository Java OpenJDK 17 an, das mit der neuesten Version von GlassFish kompatibel ist.

Zuerst aktualisieren und aktualisieren Sie Ihr Debian-Repository mit dem folgenden Befehl.

sudo apt update

update repo

Sobald das Repository aktualisiert ist, installieren Sie das Paket default-jdk, indem Sie den folgenden Befehl ausführen. Durch die Installation des default-jdk-Pakets installieren Sie Java OpenJDK 17.

sudo apt install default-jdk

Geben Sie y ein, um mit der Installation fortzufahren.

install java

Nachdem die Installation abgeschlossen ist, überprüfen Sie Ihre Java-Version mit dem folgenden Befehl. Sie sollten sehen, dass Java OpenJDK 17 installiert ist.

java -version

check java

System einrichten

Nach der Installation von Java OpenJDK besteht der nächste Schritt darin, Ihr Debian-System einzurichten, indem Sie zusätzliche Pakete wie wget und unzip installieren, einen neuen glassfish-Systembenutzer erstellen und die Umgebungsvariable JAVA_HOME konfigurieren.

Um zu beginnen, installieren Sie das Paket unzip und wget, indem Sie den folgenden apt-Befehl ausführen.

sudo apt install unzip wget -y

install wget unzip

Führen Sie nun den folgenden Befehl aus, um einen neuen Systembenutzer glassfish zu erstellen. Dieser Benutzer wird verwendet, um Ihre GlassFish-Installation auszuführen, die im Verzeichnis /opt/glassfish gespeichert wird.

sudo useradd -M -d /opt/glassfish -U -s /bin/false glassfish

Erstellen Sie als Nächstes ein neues Bash-Skript /etc/profile.d/java.sh mit dem folgenden Befehl im Nano-Editor.

sudo nano /etc/profile.d/java.sh

Fügen Sie die folgende Konfiguration hinzu, um die Umgebungsvariable JAVA_HOME einzurichten und den Java-Bin-Pfad zum System PATH hinzuzufügen.

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64  
export PATH=$PATH:$JAVA_HOME/bin

Speichern und schließen Sie die Datei, wenn Sie fertig sind.

Laden Sie nun die neue Umgebungsvariable innerhalb von /etc/profile.d/java.sh mit dem folgenden Source-Befehl.

source /etc/profile.d/java.sh

Führen Sie schließlich den folgenden Befehl aus, um die System-PATH- und JAVA_HOME-Umgebungsvariablen zu überprüfen.

echo $JAVA_HOME  
echo $PATH

Wenn alles gut läuft, sollten Sie sehen, dass der JAVA_HOME-Pfad auf das Verzeichnis /usr/lib/jvm/java-17-openjdk-amd64 konfiguriert ist und das Java-Bin-Verzeichnis zum System-PATH hinzugefügt wurde.

GlassFish-Binärpaket herunterladen

Mit dem installierten Java OpenJDK und Ihrem bereitgestellten Debian-System können Sie jetzt GlassFish herunterladen und installieren. Überprüfen Sie vor dem Fortfahren die GlassFish-Download-Seite, um die neueste Version von GlassFish zu erhalten. Zu diesem Zeitpunkt ist die neueste Version von GlassFish v7.0.10.

Gehen Sie in das Verzeichnis /tmp und laden Sie das GlassFish-Binärpaket über den folgenden wget-Befehl herunter. Sobald der Downloadvorgang abgeschlossen ist, sollten Sie die Datei glassfish-7.0.10.zip sehen.

cd /tmp  
wget https://download.eclipse.org/ee4j/glassfish/glassfish-7.0.10.zip

Extrahieren Sie die Datei glassfish-7.0.10.zip in das Verzeichnis /opt über den folgenden unzip-Befehl. Das GlassFish-Paket wird im Verzeichnis /opt/glassfish7 extrahiert.

unzip glassfish-7.0.10.zip -d /opt

Benennen Sie schließlich das extrahierte Verzeichnis von /opt/glassfish7 in /opt/glassfish um. Ändern Sie dann den Besitz des Verzeichnisses /opt/glassfish auf den Benutzer glassfish.

mv /opt/glassfish7 /opt/glassfish  
sudo chown -R glassfish:glassfish /opt/glassfish

GlassFish als Systemd-Dienst ausführen

Nachdem Sie das GlassFish-Binärpaket heruntergeladen haben, erstellen Sie eine neue Systemd-Dienstdatei, die verwendet wird, um GlassFish auszuführen. Dadurch können Sie GlassFish über das Systemctl-Dienstprogramm verwalten und GlassFish im Hintergrund als Systemd-Dienst ausführen.

Um GlassFish als Systemd-Dienst auszuführen, führen Sie den folgenden Nano-Editor-Befehl aus, um eine neue Datei /etc/systemd/system/glassfish.service zu erstellen.

sudo nano /etc/systemd/system/glassfish.service

Fügen Sie die folgende Konfiguration in die Datei ein.

[Unit]  
Description = GlassFish Server v7  
After = syslog.target network.target  
  
[Service]  
User=glassfish  
ExecStart=/opt/glassfish/bin/asadmin start-domain  
ExecReload=/opt/glassfish/bin/asadmin restart-domain  
ExecStop=/opt/glassfish/bin/asadmin stop-domain  
Type = forking  
  
[Install]  
WantedBy = multi-user.target

Speichern und schließen Sie die Datei, wenn Sie fertig sind.

Führen Sie nun den folgenden systemctl-Befehl aus, um den Systemd-Manager neu zu laden und die Änderungen anzuwenden.

sudo systemctl daemon-reload

Nachdem der Systemd-Manager neu geladen wurde, starten und aktivieren Sie den glassfish-Dienst mit dem folgenden Befehl.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

run glassfish systemd

Überprüfen Sie schließlich den Status des GlassFish-Dienstes mit dem folgenden Befehl.

sudo systemctl status glassfish

Wenn alles gut läuft, sollten Sie den Status von GlassFish als aktiv (laufend) sehen, und er ist aktiviert.

check glassfish service

Benutzer einrichten und GlassFish-Administration sichern

An diesem Punkt ist GlassFish betriebsbereit. Jetzt werden Sie die GlassFish-Installation konfigurieren, indem Sie das Standardpasswort für die Admin-Konsole ändern und die sichere Administration aktivieren. Dies kann über den asadmin-Befehl erfolgen, der im Verzeichnis /opt/glassfish/bin verfügbar ist.

Führen Sie die folgende asadmin-Befehlszeile aus, um das Admin-Passwort für Ihre GlassFish-Installation zu ändern.

sudo -u glassfish /opt/glassfish/bin/asadmin --port 4848 change-admin-password

Während des Prozesses werden Sie nach Folgendem gefragt:

Geben Sie den Standard-Admin-Benutzer für GlassFish ein.
Drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden. Der Standard-Admin-Benutzer für GlassFish hat kein Passwort.
Geben Sie nun das neue Admin-Passwort für GlassFish ein und wiederholen Sie es.

Wenn der Prozess abgeschlossen ist, sollten Sie eine Nachricht wie die folgende erhalten:

Führen Sie als Nächstes den asadmin-Befehl unten aus, um die sichere Administration auf Ihrer GlassFish-Installation zu aktivieren.

Im Wesentlichen ermöglicht die sichere Administration sichere Kommunikation über SSL zwischen dem Domain-Administrationsserver (DAS), Remote-Instanzen und Administrationsclients, einschließlich des asadmin-Dienstprogramms, der Administrationskonsole und REST-Clients.

sudo -u glassfish /opt/glassfish/bin/asadmin --port 4848 enable-secure-admin

Geben Sie Ihren GlassFish-Admin-Benutzer und das Passwort ein und drücken Sie dann die Eingabetaste. Wenn Sie fertig sind, wird die folgende Ausgabe angezeigt.

Nachdem die sichere Administration aktiviert wurde, führen Sie den folgenden Befehl aus, um den GlassFish-Dienst neu zu starten und die Änderungen anzuwenden.

sudo systemctl restart glassfish

Starten Sie jetzt Ihren Webbrowser und besuchen Sie die Server-IP-Adresse, gefolgt von Port 8080, z. B. http://192.168.5.15:8080/. Wenn Ihre GlassFish-Installation erfolgreich ist, sollten Sie die folgende Seite erhalten, die bestätigt, dass GlassFish läuft.

glassfish index

Öffnen Sie schließlich einen neuen Tab und besuchen Sie dieselbe Server-IP-Adresse mit Port 4848 (d. h. https://192.168.5.15:4848/), um auf die GlassFish-Administrationsseite zuzugreifen. Akzeptieren Sie die SSL/TLS-Zertifikate in Ihrem Webbrowser, und wenn alles erfolgreich ist, sollten Sie die Anmeldeseite für die GlassFish-Administration unten erhalten.

glassfish login page

Nginx als Reverse-Proxy installieren

In diesem Leitfaden werden Sie GlassFish mit Nginx als Reverse-Proxy ausführen. Jetzt werden Sie Nginx auf Ihrem Debian-Rechner installieren und eine neue Serverblockkonfiguration für GlassFish erstellen. In diesem Fall verwenden wir einen lokalen Domainnamen glassfish.howtoforge.local.

Zuerst installieren Sie Nginx auf Ihrem Debian-System mit dem folgenden apt-Befehl. Geben Sie y ein, um mit der Installation fortzufahren.

sudo apt install nginx

install nginx

Nachdem Nginx installiert ist, erstellen Sie eine neue Serverblockkonfiguration /etc/nginx/sites-available/glassfish mit dem folgenden Befehl im Nano-Editor.

sudo nano /etc/nginx/sites-available/glassfish

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den Parameter server_name mit Ihrem lokalen Domainnamen ändern.

upstream glassfish {  
    server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;  
}  
  
server {  
    listen          80;  
    server_name     glassfish.howtoforge.local;  
  
    location / {  
        proxy_set_header X-Forwarded-Host $host;  
        proxy_set_header X-Forwarded-Server $host;  
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
        proxy_pass http://glassfish/;  
    }  
}

Speichern und beenden Sie die Datei, wenn Sie fertig sind.

Führen Sie als Nächstes den folgenden Befehl aus, um die Serverblockkonfiguration glassfish zu aktivieren und die Nginx-Syntax zu überprüfen, um sicherzustellen, dass Sie die richtige Syntax haben.

sudo ln -s /etc/nginx/sites-available/glassfish /etc/nginx/sites-enabled/  
sudo nginx -t

Wenn Sie die richtige Nginx-Syntax haben, sollten Sie die Ausgabe ‘ Test erfolgreich - Syntax ist in Ordnung ‘ erhalten.

setup nginx reverse proxy

Jetzt können Sie den Nginx-Dienst neu starten und die Änderungen anwenden. Überprüfen Sie dann den Nginx-Dienst, um sicherzustellen, dass der Dienst läuft.

sudo systemctl restart nginx  
sudo systemctl status nginx

In der folgenden Ausgabe sollten Sie sehen, dass der Nginx-Dienst läuft.

check nginx

Zugriff auf die GlassFish-Installation

Im letzten Abschnitt werden Sie auf Ihre GlassFish-Installation von der Clientmaschine aus zugreifen. Sie können jedes Betriebssystem als Ihre Clientmaschine verwenden.

Bearbeiten Sie die Datei /etc/hosts auf Ihrem lokalen Rechner und fügen Sie die folgende Konfiguration ein. Stellen Sie sicher, dass Sie die Server-IP-Adresse und den lokalen Domainnamen ändern. Wenn Sie einen Windows-Client verwenden, stellen Sie sicher, dass Sie die Datei C:\Windows\System32\drivers\etc\hosts als Administrator ändern.

192.168.5.15    glassfish.howtoforge.local

Gehen Sie jetzt zurück zu Ihrem Webbrowser und besuchen Sie den Domainnamen Ihrer GlassFish-Installation, z. B. http://glassfish.howtoforge.local/. Wenn Ihre Nginx-Reverse-Proxy-Konfiguration erfolgreich ist, sollten Sie die Standard-GlassFish-Seite wie folgt sehen.

glassfish nginx reverse proxy

Besuchen Sie als Nächstes die GlassFish-Administrationsseite über Port 4848 (d. h. https://glassfish.howtoforge.local:4848/). Geben Sie auf der Anmeldeseite Ihren Admin-Benutzer und Ihr Passwort ein und klicken Sie auf Anmelden.

GlassFish login

Wenn Ihre Installation erfolgreich ist, sollten Sie das GlassFish-Administrations-Dashboard wie folgt erhalten:

GlassFish dashboard

Klicken Sie nun auf das Menü Server, um den Status Ihrer GlassFish-Installation zu überprüfen. In diesem Beispiel sollten Sie sehen, dass GlassFish 7.0 installiert ist und den Status Läuft hat.

GlassFish status

Von hier aus können Sie jetzt Ihren GlassFish-Anwendungsserver verwalten.

Fazit

Zusammenfassend haben Sie nun erfolgreich den GlassFish-Anwendungsserver auf einem Debian 12-Server installiert, indem Sie die schrittweisen Anweisungen befolgt haben. Sie haben GlassFish mit Java OpenJDK 17 und Nginx als Reverse-Proxy installiert und auch GlassFish gesichert, indem Sie das Standard-Admin-Passwort geändert und die sichere Administration aktiviert haben. Sie können jetzt beginnen, Ihre Anwendung mit GlassFish bereitzustellen.