Table of Contents
What the Red Means
The lines that the user needs to enter or customize will be in red in this tutorial! The rest should mostly be copy-and-pastable.
What is JBoss?
JBoss is a powerful open source Java application server developed by RedHat.
It has full support for the JavaEE 6 Webprofile, which means you have the following out of the box support:
- Servlet 3.0
- JSF
- Java Server Faces
- EJB
- JPA
- CDI
- Bean Validation
Additionally there is also support for other JavaEE features like JMS, JAX-RS and JAX-WS.
More documentation can be found docs.jboss.org.
Step One—Install Java
First you have to check if you have installed java on your VPS.
java -version
When you get the following error you have to install it.
-bash: java: command not found
Install Java.
apt-get update
apt-get install openjdk-7-jdk
Step Two—Install JBoss
The next step is to download the current JBoss version, which is at the moment 7.1.1.
wget http://download.jboss.org/jbossas/7.1/jboss-as-7.1.1.Final/jboss-as-7.1.1.Final.tar.gz
Now unzip it and move it to /usr/local/share/jboss.
tar xfvz jboss-as-7.1.1.Final.tar.gz
mv jboss-as-7.1.1.Final /usr/local/share/jboss
Step Three—Create a New User
Because we don’t want to run it as root you should create a new user which is used to start the JBoss server.
adduser appserver
Also change the ownership of the newly created folder to the new user.
chown -R appserver /usr/local/share/jboss
The next step will be creating a new user for the JBoss management console.
su appserver
cd /usr/local/share/jboss/bin
./add-user.sh
Now you should create a new Management User by typing “a” and enter later username and password
What type of user do you wish to add?
a) Management User (mgmt-users.properties)
b) Application User (application-users.properties)
(a): a
Enter the details of the new user to add.
Realm (ManagementRealm) :
Username : app1
Password :
Re-enter Password :
It is really important that the Realm has the value “ManagementRealm” because this is the realm for the management console.
Step Four—Start the JBoss Server
After this steps you can start the JBoss server using the following command.
./standalone.sh -Djboss.bind.address=yourserverip -Djboss.bind.address.management=yourserverip&
You have to set the bind address because otherwise JBoss is only accessable from localhost. You can also set as IP address 0.0.0.0 if you have no static IP.
To verify if everything works you can navigate to the management console.
http://yourserverip:9990/console
You have to enter username and password of the user you created using add-user.sh.
You should see the following site now:
<img src="images/how-to-install-jboss-on-ubuntu-12-10-64bit-section-1.png; alt="JBoss 1">
To enter the deployed root web page you have to navigate to the following url.
http://yourserverip:8080/
You should see the following site now:
<img src="images/how-to-install-jboss-on-ubuntu-12-10-64bit-section-1.png; alt="JBoss 2">
To stop the server you have to run the following command.
./jboss-cli.sh --connect --controller=yourserverip:9999 command=:shutdown