How to Install GlassFish with Nginx as a Reverse Proxy on Debian 10

GlassFish is an open-source and world's first implementation of the Java Platform developed by Eclipse Foundation. It is a light-weight application server and supports different Java-based technologies like Enterprise JavaBeans, JPA, JavaServer Faces, JMS, and many more. GlassFish comes with a simple and easy to use administration console with an update tool for updates and add-on components.

In this tutorial, we will explain how to install GlassFish on Debian 10 with Nginx as a reverse proxy.

Requirements

  • A server running Debian 10.
  • A root password is setup to your server.

Getting Started

Before starting, you will need to update your system with the latest version. You can do this by running the following command:

apt-get update -y
apt-get upgrade -y

Once your server is updated, restart your server to apply the changes.

Installing Java

GlassFish requires java version 8 to be installed on your server. So, you will need to remove the Java if you have any other Java version installed on your system.

You can remove the Java version 11 with the following command:

apt-get remove openjdk-11-jre-headless

Next, you will need to download the java version 8 from their official website. Once the download is completed, extract the downloaded file to the /usr/lib/jvm directory with the following command:

mkdir /usr/lib/jvm/
tar -zxvf jdk-8u221-linux-x64.tar.gz -C /usr/lib/jvm/

Next, set the default Java version with the following command:

update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk1.8.0_221/bin/java 1

You should get the following output:

update-alternatives: using /usr/lib/jvm/jdk1.8.0_221/bin/java to provide /usr/bin/java (java) in auto mode

You can now check the java version with the following command:

java -version

You should see the following output:

java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode)

Install GlassFish

First, install the required packages with the following command:

apt-get install wget unzip -y

Next, download the latest version of GlassFish with the following command:

wget http://download.oracle.com/glassfish/5.0.1/nightly/latest-glassfish.zip

Once the download has been completed, extract the downloaded file to the /opt directory using the following command:

unzip latest-glassfish.zip -d /opt/

Once you have done, you can proceed to the next step.

Create a GlassFish Service

Next, you can create a systemd service file to manage the GlassFish service. You can create it with the following command:

nano /etc/systemd/system/glassfish.service

Add the following content:

[Unit]
Description = GlassFish Server v5.0
After = syslog.target network.target

[Service]
ExecStart=/opt/glassfish5/bin/asadmin start-domain
ExecReload=/opt/glassfish5/bin/asadmin restart-domain
ExecStop=/opt/glassfish5/bin/asadmin stop-domain
Type = forking

[Install]
WantedBy = multi-user.target

Save and close the file. Then, reload the systemd daemon with the following command:

systemctl daemon-reload

Next, start the GlassFish service and enable it to start on boot with the following command:

systemctl start glassfish
systemctl enable glassfish

You can now check the status of GlassFish service with the following command:

systemctl status glassfish

You should get the following output:

? glassfish.service - GlassFish Server v5.0
   Loaded: loaded (/etc/systemd/system/glassfish.service; disabled; vendor preset: enabled)
   Active: active (running) since Thu 2019-09-19 04:54:25 EDT; 42s ago
  Process: 15205 ExecStart=/opt/glassfish5/bin/asadmin start-domain (code=exited, status=0/SUCCESS)
 Main PID: 15217 (java)
    Tasks: 90 (limit: 1138)
   Memory: 271.7M
   CGroup: /system.slice/glassfish.service
           ??15217 /usr/lib/jvm/jdk1.8.0_221/bin/java -cp /opt/glassfish5/glassfish/modules/glassfish.jar -XX:+UnlockDiagnosticVMOptions -XX:Ne

Sep 19 04:53:42 debian systemd[1]: Starting GlassFish Server v5.0...
Sep 19 04:54:24 debian asadmin[15205]: Waiting for domain1 to start .................................
Sep 19 04:54:24 debian asadmin[15205]: Successfully started the domain : domain1
Sep 19 04:54:24 debian asadmin[15205]: domain  Location: /opt/glassfish5/glassfish/domains/domain1
Sep 19 04:54:24 debian asadmin[15205]: Log File: /opt/glassfish5/glassfish/domains/domain1/logs/server.log
Sep 19 04:54:24 debian asadmin[15205]: Admin Port: 4848
Sep 19 04:54:24 debian asadmin[15205]: Command start-domain executed successfully.
Sep 19 04:54:25 debian systemd[1]: Started GlassFish Server v5.0.
lines 1-18/18 (END)

Enable GlassFish Admin Console

By default, GlassFish admin console password is not set. So, you will need to update the admin password.

Run the following command to set the admin password:

/opt/glassfish5/bin/asadmin change-admin-password

Provide your desired password and press Enter. Once the password has been set, you should see the following output:

Enter admin user name [default: admin]>admin
Enter the admin password> 
Enter the new admin password> 
Enter the new admin password again> 
Command change-admin-password executed successfully.

Next, you will need to enable the secure admin feature. You can do it with the following command:

/opt/glassfish5/bin/asadmin enable-secure-admin

Provide your admin username and password, and hit Enter to enable the secure admin as shown below:

Enter admin user name>  admin
Enter admin password for user "admin"> 
You must restart all running servers for the change in secure admin to take effect.
Command enable-secure-admin executed successfully.

Next, restart GlassFish service to apply the configurationchanges:

systemctl restart glassfish

Access GlassFish

By default, GlassFish application runs on port 8080. You can access it by visiting the URL http://your-server-ip:8080. You should see the following page:

GlassFish default page

GlassFish admin console runs on port 4848. You can access it by visiting the URL http://your-server-ip:4848. You should see the GlassFish login page:

Login to GlassFish server

Provide your admin username and password, and click on the Login button. You should see the GlassFish admin console in the following screen:

GlassFish Console

Deploy Application on GlassFish

GlassFish is now installed and configured, it's time to deploy sample application on GlassFish.

First, download the hello.war application with the following command:

wget https://github.com/dmatej/Glassfish/raw/master/v2/www/downloads/quickstart/hello.war

Next, deploy the hello.war application with the following command:

/opt/glassfish5/bin/asadmin deploy hello.war

You should see the following output:

  Version: V3
  Subject: CN=localhost, OU=GlassFish, O=Oracle Corporation, L=Santa Clara, ST=California, C=US
  Signature Algorithm: SHA256withRSA, OID = 1.2.840.113549.1.1.11

  Key:  Sun RSA public key, 2048 bits
  modulus: 26796330640308027923768800042502020134808966576745098232029910481655545436468207928921434907495986430069072245547607053010428717755932187048623252153613041636091429700133899537566912806297788375081359516836091002133743138757261794690981737280330851500902934286405305506594303276580413684625941149729611614458782091187522283499926880436357851913036137048969953439207474630152049712806975982901461106170366207997764866053158318707816771263261147284707875045634066423002500565550480728681743613266266732299458152358213914375115269066441015633123820868476095174900081535873996509058837674720310526766610294764426209317187
  public exponent: 65537
  Validity: [From: Tue Jan 15 21:17:50 EST 2019,
               To: Fri Jan 12 21:17:50 EST 2029]
  Issuer: CN=localhost, OU=GlassFish, O=Oracle Corporation, L=Santa Clara, ST=California, C=US
  SerialNumber: [    3347569f]

Certificate Extensions: 1
[1]: ObjectId: 2.5.29.14 Criticality=false
SubjectKeyIdentifier [
KeyIdentifier [
0000: F2 F1 22 14 40 CA 9E 1D   92 3B B6 B9 09 D1 27 E7  .."[email protected];....'.
0010: 50 1A 37 4D                                        P.7M
]
]

]
  Algorithm: [SHA256withRSA]
  Signature:
0000: C7 CB 91 D4 9B 39 21 13   B3 48 87 09 85 2E DF B7  .....9!..H......
0010: F9 E7 52 1B 39 D0 12 55   97 A8 02 8D B9 EC 26 F0  ..R.9..U......&.
0020: A6 8F 29 5B 96 80 71 AA   CB C8 EA 83 4F 18 E7 19  ..)[..q.....O...
0030: 26 CF BF 72 B1 E6 23 53   F2 14 CD BA 68 FE 4B 4C  &..r..#S....h.KL
0040: BB B1 3E DE D9 EB 6D 96   8C 8F 0D 33 B6 E7 28 F1  ..>...m....3..(.
0050: D5 40 6B BC 01 FF F9 5A   79 9A 96 DA D9 2A 84 99  [email protected]*..
0060: FA 3A 7A 9D 52 6C C2 D5   E9 DC 98 8B 20 EF 69 99  .:z.Rl...... .i.
0070: E6 FC 1B 0F CA B2 0C 66   BE BB A7 EA 3D DB BB F5  .......f....=...
0080: 88 F1 B4 B1 15 74 FA 9F   E0 9A 98 C5 12 A0 60 B4  .....t........`.
0090: 9B 92 19 FD BA 81 20 7F   51 83 E9 22 56 96 9A 40  ...... .Q.."[email protected]
00A0: 2C 27 BB 86 57 7D 2E E9   C5 98 1A 04 A2 C5 FC 17  ,'..W...........
00B0: 6E 8B 31 79 29 A0 A1 22   1A 31 C0 A6 96 7A D4 80  n.1y)..".1...z..
00C0: 3F 05 26 BB DE D1 2D 74   01 1F 24 EC CE 3B 97 42  ?.&...-t..$..;.B
00D0: 16 E8 16 F1 A4 10 92 0B   8E A5 18 59 BF AA 69 B0  ...........Y..i.
00E0: DB C8 C2 66 5F 5D 2F 3D   4B C7 90 1D C2 24 B1 57  ...f_]/=K....$.W
00F0: 22 02 DA 76 FF 2E B7 C5   E4 E6 50 BD 73 36 AA 8A  "..v......P.s6..

]
Do you trust the above certificate [y|N] -->y
Enter admin user name>  admin
Enter admin password for user "admin"> 
Application deployed with name hello.
Command deploy executed successfully.

To access your application, open your web browser and type the URL http://your-server-ip:8080/hello. You will be redirected to the following page:

Hello World app on GlassFish

Configure Nginx as a Reverse Proxy

Now, you will need to configure Nginx as a reverse proxy to proxy request comming on port 80 to 8080.

First, install Nginx with the following command:

apt-get install nginx -y

Once the nginx has been installed, create an Nginx virtual host file for GlassFish with the following command:

nano /etc/nginx/sites-available/glassfish.conf

Add the following lines:

upstream glassfish {
  server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;
}

server {
  listen          80;
  server_name     example.com;

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

Save and close the file. Then, check Nginx for any syntax error with the following command:

nginx -t

You should get the following output:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Next, enable the Nginx virtual host and restart Nginx service with the following command:

ln -s /etc/nginx/sites-available/glassfish.conf /etc/nginx/sites-enabled/
systemctl restart nginx

Now, you can access your application by visiting the URL http://example.com.

Congratulations! you have successfully installed GlassFish with Nginx as a reverse proxy on Debian 10. You can now deploy any Java-based application on your server easily.

Share this page:

Suggested articles

1 Comment(s)

Add comment

Comments

By: NeilG at: 2019-10-04 10:25:45

apt-get wget unzip -y should read apt-get install wget unzip -y