Getting started with JBoss (2024)

Posted: September 20, 2021 | | by Ashish Bharadwaj Madabhushana (Red Hat)

JBoss Enterprise Application Platform (EAP) is an enterprise-grade, open source platform to deploy highly transactional and scalable web applications. It includes everything you need to build, run, deploy, and manage enterprise-level Java applications in different environments—including on-premises, virtual environments, and private, public, and hybrid clouds.

This article explains some of what I have learned during my time with JBoss EAP, its operating modes, installing it, and managing the JBoss service. I will also show how to build and deploy a sample web application archive (WAR) file so that you can learn alongside me.

Understanding operating modes in JBoss EAP

JBoss EAP has two operating modes:

Standalone server mode:For managing discrete instances
Managed domain mode:For managing groups of instances from a single control point

The management capabilities are different depending on which operating mode you useto start the JBoss EAP installer.

Installing JBoss EAP

Before installing JBoss, ensure:

Java/JDK is installed on the system
The JBoss EAP admin user has installation directory read-write access

Then:

Ensure Java/JDK is installed. If it's not, install it using yum install java.
Download the JBoss EAP installer (.jar) file from the Red Hat portal.
Create a directory where you want to save all your JBoss configuration files:
```
[root@jboss-eap ~]# mkdir /jboss
```

Run the JBoss installer:

[jboss-eap Downloads]# java -jar jboss-eap-7.4.0-installer.jar

Executing this command opens the JBoss graphical installer where you can configure all your settings, installation paths, and more.

Below are a few images from the installation process:

Follow the onscreen instructions and complete the installation process. Note that the default settings are fine for basic installation.

Starting JBoss EAP

As I wrote above, JBoss EAP can runin either standalone mode or domain mode. The command to start JBoss EAP depends on the underlying platform and the operating mode.

Stopping JBoss EAP

To stop an interactive instance of JBoss EAP, pressCtrl+Cin the terminal where JBoss EAP was started.

To stop a background instance of JBoss EAP, use the management command-line interface (CLI) to connect to the running instance and shut it down.

Launch the management CLI and issue the shutdown command:

[jboss-eap ~]# /jboss/bin/jboss-cli.sh --connect[standalone@localhost:9990 /] shutdown[disconnected /]

Then pressCtrl+Cto go back to your shell.

Building a WAR file

A WAR fileis an archive that contains all the files related to a web application project. It includes Java class files, Jakarta Server Pages (JSPs), HTML pages, and many other resources.

[ Download now: A system administrator's guide to IT automation.]

To build a WAR file, first, you need to create WEB-INF and WEB-INF/classes directories. You can also use the web.xml file in WEB-INF.

Createyour own WAR file:

[jboss-eap ~]# jar cvf<war-filename><files-to-be-added into war>[jboss-eap ~]# jar cvf test.war WEB-INF/ hello.jsp index.html

Verify the contents of a WAR file:

[jboss-eap ~]# jar tvf test.war

Create a project directory, say example, and copy the WAR file into it:

[jboss-eap jboss]# mkdir /jboss/examples[jboss-eap ~]# cp test.war /jboss/examples

You can also download prebuilt, open source WAR files, copy them into the JBoss directory, and use them.

Deploying a WAR file through the command line

As the JBoss documentationstates, deploying applications using the management CLI gives you the benefit of a single CLI with the ability to create and run deployment scripts. Following are the commands you need to handle various tasks.

Start the JBoss server in standalone mode:
```
[jboss-eap ~]# /jboss/bin/standalone.sh
```

Connect to the JBoss command line:

[jboss-eap ~]# /jboss/bin/jboss-cli.sh --connect[standalone@localhost:9990 /]

Deploy an application (provide the full path to the WAR file)
```
[standalone@localhost:9990 /] deploy /jboss/examples/test.war[standalone@localhost:9990 /]
```
The application is successfully deployed and available at http : //127.0.0.1:8080/test.

Image

List the deployments:

[standalone@localhost:9990 /] deployment infoNAME RUNTIME-NAME PERSISTENT ENABLED STATUStest.war test.war true true OK

You can also view the deployments information from the admin management console at 127.0.0.1:9990.

Undeploy an application:

[standalone@localhost:9990 /] undeploy test.war[standalone@localhost:9990 /] deployment info

Wrapping up

In this article, you learned about the JBoss EAP andits operating modes, downloaded and executed the JBoss installer, managed the JBoss service, created and built a sample WAR file, and deployed the WAR file through the command line. Finally, you listed the deployment information by connecting to the JBoss CLI, and you've also done deployments from the management console. If you'd like to learn more about JBoss, check out the getting started page.

Topics: Java Programming