Come installare GlassFish Application Server con Nginx Reverse Proxy su Debian 12

GlassFish è un’implementazione gratuita e open-source della piattaforma Java EE sviluppata da Eclipse. È la prima implementazione al mondo della piattaforma Java EE e fornisce un server applicativo leggero che consente di distribuire più applicazioni basate su Java. GlassFish supporta diversi tipi di tecnologie per applicazioni Java come Enterprise JavaBeans, JPA, JavaServer Faces, JMS e molte altre.

GlassFish è una delle migliori scelte per gli sviluppatori per sviluppare e distribuire applicazioni basate su Java. Permette agli sviluppatori di sviluppare applicazioni aziendali in modo conveniente e con un’architettura scalabile. Il progetto GlassFish è stato originariamente avviato da Sun Microsystems. Viene fornito con due diverse licenze gratuite: la Common Development and Distribution License e la GNU General Public License.

In questa guida, installerai il GlassFish Application Server su Debian 12 in un processo passo-passo. Configurerai anche Nginx come reverse proxy per la tua installazione di GlassFish.

Prerequisiti

Per iniziare il processo, assicurati di avere quanto segue:

• Un server Debian 12 con almeno 4 GB di RAM o memoria.
• Un utente non root con privilegi sudo.

Installazione di Java OpenJDK

GlassFish è un server applicativo per distribuire applicazioni Java. Per installare GlassFish, devi prima installare Java sul tuo sistema Debian. In questo momento, il repository Debian fornisce Java OpenJDK 17, che è compatibile con l’ultima versione di GlassFish.

Per prima cosa, aggiorna e aggiorna il tuo repository Debian utilizzando il seguente comando.

sudo apt update

Una volta aggiornato il repository, installa il pacchetto default-jdk eseguendo il comando qui sotto. Installando il pacchetto default-jdk, installerai Java OpenJDK 17.

sudo apt install default-jdk

Digita y per procedere con l’installazione.

Dopo che l’installazione è terminata, verifica la tua versione di Java utilizzando il comando qui sotto. Dovresti vedere che Java OpenJDK 17 è installato.

java -version

Configurazione del sistema

Dopo aver installato Java OpenJDK, il passo successivo è configurare il tuo sistema Debian installando pacchetti aggiuntivi come wget e unzip, creando un nuovo utente di sistema glassfish e configurando la variabile d’ambiente JAVA_HOME.

Per iniziare, installerai i pacchetti unzip e wget eseguendo il seguente comando apt.

sudo apt install unzip wget -y

Ora, esegui il comando qui sotto per creare un nuovo utente di sistema glassfish. Questo utente sarà utilizzato per eseguire la tua installazione di GlassFish, che sarà situata nella directory /opt/glassfish.

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

Successivamente, crea un nuovo script bash /etc/profile.d/java.sh utilizzando il seguente comando dell’editor nano.

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

Aggiungi la seguente configurazione per impostare la variabile d’ambiente JAVA_HOME e aggiungere il percorso binario di Java al PATH del sistema.

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

Salva e chiudi il file quando hai finito.

Ora carica la nuova variabile d’ambiente all’interno di /etc/profile.d/java.sh utilizzando il comando source qui sotto.

source /etc/profile.d/java.sh

Infine, esegui il seguente comando per verificare le variabili d’ambiente PATH e JAVA_HOME del sistema.

echo $JAVA_HOME  
echo $PATH

Se tutto va bene, dovresti vedere che il percorso JAVA_HOME è configurato sulla directory /usr/lib/jvm/java-17-openjdk-amd64, e la directory bin di Java è stata aggiunta al PATH del sistema.

Download del pacchetto binario di GlassFish

Con Java OpenJDK installato e il tuo sistema Debian pronto, puoi ora scaricare e installare GlassFish. Prima di procedere, controlla la pagina di download di GlassFish per ottenere l’ultima versione di GlassFish. In questo momento, l’ultima versione di GlassFish è v7.0.10.

Vai alla directory /tmp e scarica il pacchetto binario di GlassFish tramite il comando wget qui sotto. Una volta terminato il processo di download, dovresti vedere il file glassfish-7.0.10.zip.

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

Estrai il file glassfish-7.0.10.zip nella directory /opt tramite il comando unzip qui sotto. Il pacchetto GlassFish sarà estratto nella directory /opt/glassfish7.

unzip glassfish-7.0.10.zip -d /opt

Infine, rinomina la directory estratta da /opt/glassfish7 a /opt/glassfish. Quindi, cambia la proprietà della directory /opt/glassfish all’utente glassfish.

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

Esecuzione di GlassFish come servizio Systemd

Dopo aver scaricato il pacchetto binario di GlassFish, creerai un nuovo file di servizio systemd che sarà utilizzato per eseguire GlassFish. Questo ti consente di gestire GlassFish tramite l’utilità systemctl e di eseguire GlassFish in background come servizio systemd.

Per eseguire GlassFish come servizio systemd, esegui il comando dell’editor nano qui sotto per creare un nuovo file /etc/systemd/system/glassfish.service.

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

Inserisci la seguente configurazione nel file.

[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

Salva e chiudi il file quando hai finito.

Ora, esegui il seguente comando systemctl per ricaricare il gestore systemd e applicare le modifiche.

sudo systemctl daemon-reload

Con il gestore systemd ricaricato, avvia e abilita il servizio glassfish utilizzando il seguente comando.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

Infine, verifica lo stato del servizio glassfish utilizzando il comando qui sotto.

sudo systemctl status glassfish

Se tutto va bene, dovresti vedere lo stato di glassfish come attivo (in esecuzione), ed è abilitato.

Configurazione dell’utente e sicurezza dell’amministrazione di GlassFish

A questo punto, GlassFish è attivo e funzionante. Ora configurerai l’installazione di GlassFish cambiando la password predefinita per la Console di Amministrazione e abilitando l’Amministrazione Sicura. Questi possono essere eseguiti tramite il comando asadmin disponibile nella directory /opt/glassfish/bin.

Esegui la riga di comando asadmin qui sotto per cambiare la password dell’amministratore per la tua installazione di GlassFish.

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

Durante il processo, ti verrà chiesto quanto segue:

• Inserisci l’utente amministratore predefinito per GlassFish.
• Premi INVIO quando ti viene chiesta la password. L’utente amministratore predefinito per GlassFish non ha password.
• Ora inserisci la nuova password dell’amministratore per GlassFish e ripeti.

Quando il processo è completato, dovresti ricevere un messaggio simile al seguente:

Successivamente, esegui il comando asadmin qui sotto per abilitare l’amministrazione sicura sulla tua installazione di GlassFish.

Essenzialmente, l’Amministrazione Sicura abilita comunicazioni sicure tramite SSL tra il server di amministrazione del dominio (DAS), le istanze remote e i client di amministrazione, inclusi l’utilità asadmin, la console di amministrazione e i client REST.

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

Inserisci il tuo utente amministratore di GlassFish e la password, quindi premi Invio. Quando hai finito, verrà visualizzato il seguente output.

Dopo che l’amministrazione sicura è abilitata, esegui il seguente comando per riavviare il servizio glassfish e applicare le modifiche.

sudo systemctl restart glassfish

Ora, apri il tuo browser web e visita l’indirizzo IP del server seguito dalla porta 8080, come http://192.168.5.15:8080/. Se la tua installazione di GlassFish è riuscita, dovresti vedere la seguente pagina, che conferma che GlassFish è in esecuzione.

Infine, apri una nuova scheda e visita lo stesso indirizzo IP del server con la porta 4848 (cioè: https://192.168.5.15:4848/) per accedere alla pagina di amministrazione di GlassFish. Accetta i certificati SSL/TLS nel tuo browser web e, se tutto va bene, dovresti vedere la pagina di accesso all’amministrazione di GlassFish qui sotto.

Installazione di Nginx come Reverse Proxy

In questa guida, eseguirai GlassFish con Nginx come reverse proxy. Ora installerai Nginx sulla tua macchina Debian e creerai una nuova configurazione del blocco server per GlassFish. In questo caso, utilizzeremo un nome di dominio locale glassfish.howtoforge.local.

Per prima cosa, installa Nginx sul tuo sistema Debian utilizzando il seguente comando apt. Inserisci y per procedere con l’installazione.

sudo apt install nginx

Dopo che Nginx è installato, crea una nuova configurazione del blocco server /etc/nginx/sites-available/glassfish utilizzando il seguente comando dell’editor nano.

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

Inserisci la seguente configurazione e assicurati di cambiare il parametro server_name con il tuo nome di dominio locale.

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/;  
    }  
}

Salva ed esci dal file quando hai finito.

Successivamente, esegui il seguente comando per attivare la configurazione del blocco server glassfish e verificare la sintassi di Nginx per assicurarti di avere una sintassi corretta.

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

Se hai la sintassi corretta di Nginx, dovresti ricevere l’output ‘test riuscito - sintassi ok‘.

Ora puoi riavviare il servizio Nginx e applicare le modifiche. Quindi, verifica il servizio Nginx per assicurarti che il servizio sia in esecuzione.

sudo systemctl restart nginx  
sudo systemctl status nginx

Nell’output seguente, dovresti vedere che il servizio Nginx è in esecuzione.

Accesso all’installazione di GlassFish

Nell’ultima sezione, accederai alla tua installazione di GlassFish dalla macchina client. Puoi utilizzare qualsiasi sistema operativo come macchina client.

Modifica il file /etc/hosts sulla tua macchina locale e inserisci la seguente configurazione. Assicurati di cambiare l’indirizzo IP del server e il nome di dominio locale. Se stai utilizzando un client Windows, assicurati di modificare il file C:\Windows\System32\drivers\etc\hosts come amministratore.

192.168.5.15    glassfish.howtoforge.local

Ora torna al tuo browser web e visita il nome di dominio della tua installazione di GlassFish, come http://glassfish.howtoforge.local/. Se la tua configurazione del reverse proxy Nginx ha avuto successo, dovresti vedere la pagina indice predefinita di GlassFish come segue.

Successivamente, visita la pagina di amministrazione di GlassFish sulla porta 4848 (cioè: https://glassfish.howtoforge.local:4848/). Nella pagina di accesso, inserisci il tuo utente amministratore e la password, quindi fai clic su Login.

Se la tua installazione ha avuto successo, dovresti vedere il dashboard di amministrazione di GlassFish come segue:

Ora fai clic sul menu Server per controllare lo stato della tua installazione di GlassFish. In questo esempio, dovresti vedere che GlassFish 7.0 è installato con lo stato In esecuzione.

Da qui, puoi ora gestire il tuo server applicativo GlassFish.

Conclusione

In conclusione, hai ora installato con successo il GlassFish Application Server su un server Debian 12, seguendo le istruzioni passo-passo. Hai installato GlassFish con Java OpenJDK 17 e Nginx come reverse proxy, e hai anche messo in sicurezza GlassFish cambiando la password predefinita dell’amministratore e abilitando l’Amministrazione Sicura. Ora puoi iniziare a distribuire la tua applicazione con GlassFish.