Explore our detailed guide on how to install GlassFish on Linux 7, including step-by-step instructions, necessary prerequisites, and troubleshooting tips for a smooth installation process. #centlinux #linux #java
Table of Contents
What is GlassFish Server?
GlassFish is an open source application server for the Java EE platform. GlassFish project is initially started by Sun Microsystem and now sponsored by Oracle Corporation. GlassFish is free software and dual-licensed under two free software licenses CDDL (Common Development and Distribution License) and GPL (GNU General Public License).
Oracle GlassFish Server was the commercially supported. In Nov-2013, Oracle discontinued support of Oracle GlassFish Server while continuing open source updates. Thereafter, Oracle encouraged its customer to migrate to another alternate product Oracle Weblogic Server.
The only commercially supported fork of GlassFish available is Payara Server.
GlassFish Server Features
GlassFish Server is an open-source application server developed by the Eclipse Foundation. It serves as a reference implementation of the Java EE (Enterprise Edition) platform, providing a robust environment for deploying and managing Java-based web applications. Here are some key features and aspects of GlassFish Server:
- Java EE Compatibility: GlassFish fully supports the Java EE specifications, including servlets, JavaServer Pages (JSP), Enterprise JavaBeans (EJB), Java Message Service (JMS), and more. This makes it an ideal platform for developing and deploying enterprise-level Java applications.
- Open Source: As an open-source project, GlassFish is free to use and modify, with a strong community of developers contributing to its ongoing development and support.
- Modularity: GlassFish uses a modular architecture based on OSGi (Open Services Gateway initiative), allowing for flexible and dynamic deployment of services and applications.
- Administration and Management: GlassFish offers a comprehensive administrative console, as well as command-line tools, for managing server configurations, deploying applications, and monitoring server performance.
- Clustering and High Availability: GlassFish supports clustering and load balancing, enabling the deployment of applications in a highly available and scalable environment.
- Developer Tools Integration: GlassFish integrates seamlessly with popular Integrated Development Environments (IDEs) such as NetBeans and Eclipse, providing a streamlined development and deployment workflow.
- Extensibility: With support for various plugins and extensions, GlassFish can be customized to meet specific application requirements.
GlassFish Server is widely used for developing, testing, and deploying Java EE applications, offering a combination of performance, reliability, and ease of use.
Recommended Online Training: Glassfish Server Administration for Beginners (Step-By-Step)
System Specification
In this article, we will install GlassFish on Linux 7. We are using the open source version of GlassFish with Oracle Java SE 8.
We are using a CentOS 7 virtual machine with following specification.
- Hostname – glassfish-01.example.com
- IP Address – 192.168.116.147/24
- Operating System – CentOS 7.6
- GlassFish Version – 5.0
Read Also: How to install GlassFish Server on CentOS 8
Install Java SE on CentOS 7
Connect with glassfish-01.example.com using ssh as root user.
As a best practice, we always minimally install our CentOS 7 servers and then install required packages on demand.
We required wget and unzip commands to download and extract software respectively. Therefore, we are installing both of these packages using yum command.
# yum install -y wget unzip
GlassFish 5.0 requires Java JDK 8. Therefore, we are downloading Oracle Java SE 8 from Oracle website.
Although, it is not necessary that, we must use Oracle Java SE 8, instead we can also use OpenJDK as well. Since we are using OpenJDK in our previous articles, therefore, we decided to try Oracle Java SE 8 this time.
# wget --no-cookies --no-check-certificate --header "Cookie: oraclelicense=accept-securebackup-cookie" "https://download.oracle.com/otn-pub/java/jdk/8u201-b09/42970487e3af4f5aa5bca3f542482c60/jdk-8u201-linux-x64.rpm" --2019-03-15 00:20:18-- https://download.oracle.com/otn-pub/java/jdk/8u201-b09/42970487e3af4f5aa5bca3f542482c60/jdk-8u201-linux-x64.rpm?AuthParam=1552591337_33165c6d74a8540150b0c2ddb6f3633b Connecting to download.oracle.com (download.oracle.com)|23.198.73.122|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 176209195 (168M) [application/x-redhat-package-manager] Saving to: âjdk-8u201-linux-x64.rpm.1â 100%[======================================>] 176,209,195 152KB/s in 16m 10s 2019-03-15 00:36:29 (177 KB/s) - âjdk-8u201-linux-x64.rpm.1â saved [176209195/176209195]
Install Java JDK 8u201 using yum command.
# yum install -y jdk-8u201-linux-x64.rpm
Loaded plugins: fastestmirror
Examining jdk-8u201-linux-x64.rpm: 2000:jdk1.8-1.8.0_201-fcs.x86_64
Marking jdk-8u201-linux-x64.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package jdk1.8.x86_64 2000:1.8.0_201-fcs will be installed
--> Finished Dependency Resolution
Dependencies Resolved
================================================================================
Package Arch Version Repository Size
================================================================================
Installing:
jdk1.8 x86_64 2000:1.8.0_201-fcs /jdk-8u201-linux-x64 288 M
Transaction Summary
================================================================================
Install 1 Package
Total size: 288 M
Installed size: 288 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : 2000:jdk1.8-1.8.0_201-fcs.x86_64 1/1
Unpacking JAR files...
tools.jar...
plugin.jar...
javaws.jar...
deploy.jar...
rt.jar...
jsse.jar...
charsets.jar...
localedata.jar...
Verifying : 2000:jdk1.8-1.8.0_201-fcs.x86_64 1/1
Installed:
jdk1.8.x86_64 2000:1.8.0_201-fcs
Complete!
Set JAVA_HOME environment variable.
# echo "export JAVA_HOME=/usr/java/jdk1.8.0_201-amd64/" >> /etc/profile # . /etc/profile # env | grep JAVA_HOME JAVA_HOME=/usr/java/jdk1.8.0_201-amd64/
Check Java version to verify installation.
# java -version java version "1.8.0_201" Java(TM) SE Runtime Environment (build 1.8.0_201-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.201-b09, mixed mode)
Install Glassfish on Linux 7
Create a user to own Glassfish software.
# useradd -s /sbin/nologin glassfish
Download Glassfish 5.0 from Glassfish website.
There are two editions of Glassfish are available, Web Profile and Full Platform.
Full Platform is the full fledge Java EE server, with complete Java Platform support. Whereas, Web Profile is the subset of Glassfish Full Platform, provides only commonly used elements.
Here, we will download Glassfish 5.0 Full Platform.
# wget http://download.oracle.com/glassfish/5.0/release/glassfish-5.0.zip --2019-03-15 20:29:04-- https://download.oracle.com/glassfish/5.0/release/glassfish-5.0.zip Connecting to download.oracle.com (download.oracle.com)|23.211.4.135|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 119735241 (114M) [application/zip] Saving to: âglassfish-5.0.zipâ 100%[======================================>] 119,735,241 298KB/s in 9m 3s 2019-03-15 20:38:09 (215 KB/s) - âglassfish-5.0.zipâ saved [119735241/119735241]
Extract glassfish-5.0.zip file.
# unzip -d /opt/ glassfish-5.0.zip
Change ownership of /opt/glassfish5 directory.
# chown -R glassfish:glassfish /opt/glassfish5/
Create a systemd service to autostart Glassfish server.
# vi /usr/lib/systemd/system/glassfish.service
and add following directives therein.
[Unit] Description = GlassFish Server v5.0 After = syslog.target network.target [Service] User = glassfish ExecStart = /usr/bin/java -jar /opt/glassfish5/glassfish/lib/client/appserver-cli.jar start-domain ExecStop = /usr/bin/java -jar /opt/glassfish5/glassfish/lib/client/appserver-cli.jar stop-domain ExecReload = /usr/bin/java -jar /opt/glassfish5/glassfish/lib/client/appserver-cli.jar restart-domain Type = forking [Install] WantedBy = multi-user.target
Start and enable glassfish.service.
# systemctl enable glassfish.service Created symlink from /etc/systemd/system/multi-user.target.wants/glassfish.service to /usr/lib/systemd/system/glassfish.service. # systemctl start glassfish.service
Glassfish uses following Service ports.
4848 – Administration Console
8080 – HTTP Service
8181 – HTTPS Service
Allow Glassfish Service ports in Linux Firewall.
# firewall-cmd --permanent --add-port={4848,8080,8181}/tcp
success
# firewall-cmd --reload
success
Add Glassfish binaries to PATH environment variable.
# sed -i 's/^PATH=*/PATH=/opt/glassfish5/bin:/g' ~/.bash_profile
Set password for Glassfish 5.0 Admin user.
# asadmin --port 4848 change-admin-password Enter admin user name [default: admin]> Enter the admin password> Enter the new admin password> Enter the new admin password again> Command change-admin-password executed successfully.
By default, Glassfish Admin Console is running as a clear text HTTP service. Run following command to enable secure administration console.
# asadmin --host glassfish-01.example.com --port 4848 enable-secure-admin 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.
Restart glassfish.service.
# systemctl restart glassfish.service
After restarting glassfish.service, we are not able to access the Glassfish Admin Console.
Thanks to M.S. Dousti at StackOverflow, we come to know about this bug. It is caused by the use of an older version of Grizzly module. As a workaround, he suggested to upgrade the grizzly-npn-bootstrap.jar to a newer version.
Therefore, we have downloaded and upgraded grizzly-npn-bootstrap.jar as per his advice.
# cd /opt/glassfish5/glassfish/modules/endorsed # mv grizzly-npn-bootstrap.jar grizzly-npn-bootstrap.jar.1 # wget https://search.maven.org/remotecontent?filepath=org/glassfish/grizzly/grizzly-npn-bootstrap/1.9/grizzly-npn-bootstrap-1.9.jar -O grizzly-npn-bootstrap.jar --2019-03-15 23:12:01-- https://search.maven.org/remotecontent?filepath=org/glassfish/grizzly/grizzly-npn-bootstrap/1.9/grizzly-npn-bootstrap-1.9.jar Resolving search.maven.org (search.maven.org)... 54.87.22.154, 54.236.172.66, 52.200.115.228 Connecting to search.maven.org (search.maven.org)|54.87.22.154|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 126502 (124K) [application/java-archive] Saving to: âgrizzly-npn-bootstrap.jarâ 100%[======================================>] 126,502 204KB/s in 0.6s 2019-03-15 23:12:03 (204 KB/s) - âgrizzly-npn-bootstrap.jarâ saved [126502/126502] # chown glassfish:glassfish grizzly-npn-bootstrap.jar
Restart glassfish.service.
# systemctl restart glassfish.service
Browse URL https://glassfish-01.example.com:4848/ from a client’s browser. You have to ignore certificate warning and add exception in your browser.
We have reached at the login page of Glassfish 5.0 Admin Console.
Login as Admin user with password, that we have set in previous steps.
We have successfully login to Glassfish Admin Console.
Now, Browse URLs http://glassfish-01.example.com/ or https://glassfish-01.example.com/ from a client’s browser.
Both URLs will bring you to the same page. The only difference is that, former will serve you a clear text HTTP version, however the later will serve a encrypted HTTPS version of the same webpage.
We have successfully install Glassfish on Linux 7 server.
You should have a reference book like GlassFish Administration (PAID LINK) by Packt Publishing to help you during your GlassFish study.
Final Thoughts
Installing GlassFish on Linux 7 can be a straightforward process with the right guidance. By following the steps outlined in this guide, you can ensure a smooth and successful installation. If you need further assistance or run into any issues, I’m here to help. Check out my Fiverr gig for personalized support and services related to GlassFish installations, configurations, and more: Application Server Administrator
Reach out for expert advice and ensure your GlassFish setup is done correctly and efficiently!