JBoss EAP Installation Methods
Downloading and installing JBoss EAP using the archive installation method on RHEL and Microsoft Windows server
Abstract
Chapter 1. Installing and uninstalling JBoss EAP using archive installation method
1.1. JBoss EAP installation methods
You can choose to install JBoss EAP using any of the three types of installation methods:
- Installer method
- Archive installation method
- RPM installation method
This documentation only covers the archive installation process.
Depending on your requirements, each installation method is useful in certain situations.
The following table provides a brief overview of each type of installation methods.
Table 1.1. Installation Methods
Method | Description |
---|---|
Installer installation |
|
Archive Installation |
|
RPM Installation | You can install JBoss EAP using RPM packages on supported installations of Red Hat Enterprise Linux 7 or later. |
1.2. Downloading and installing JBoss EAP using archive installation method
You can download and install JBoss EAP using the archive installation method on Red Hat Enterprise Linux RHEL and on Microsoft Windows server.
Prerequisites
- You are on a supported operating system.
- You have set up an account on the Red Hat Customer Portal.
- You have Installed a supported Java Development Kit (JDK).
- You have reviewed the JBoss EAP 8 supported configurations and have ensured that your system is supported.
-
Microsoft Windows only: You have set the
JAVA_HOME
andPATH
environment variables.
If you do not set up the environment variables the shortcuts will not work.
Procedure
- Log in to the Red Hat Customer Portal.
-
Click
Downloads
-
Select
Red Hat JBoss Enterprise Application Platform
from theProduct Downloads
list. -
In the
Version
drop-down list, select8.0
. -
Find
Red Hat JBoss Enterprise Application Platform
8.0.0
in the list and click the Download link. - Optional: Move the archive file to the server and location where you want to install JBoss EAP.
Depending on your operating system, choose one of the following options:
For Red Hat Enterprise Linux, extract the archive file by entering the following command in the management CLI:
$ unzip jboss-eap-8.0.0.zip
For Windows Server, right-click the archive file and select
Extract All
.NoteEAP_HOME
is the top-level directory for the JBoss EAP installation. Create the directory by extracting the archive file.
Additional resources
- For more information about configuring your JBoss EAP server, see our configuration guide.
1.3. Uninstalling JBoss EAP archive installation
Depending on your work environment, the archive installation method might not meet the needs of your environment. You can remove the instance of JBoss EAP and any services associated with it. Thereafter, you can install JBoss EAP using a suitable installation method.
Prerequisites
- You have archived any modified configuration files and deployments that you can reuse at a later stage.
Procedure
- Delete the installation directory to uninstall JBoss EAP.
- Delete any scripts that depend on JBoss EAP being installed on your machine.
Chapter 2. Running and removing JBoss EAP as a service on RHEL
2.1. Running JBoss EAP as a service on RHEL
You can configure JBoss EAP to run as a service in Red Hat Enterprise Linux RHEL. This enables your the JBoss EAP service to start automatically when the RHEL server starts.
Prerequisites
- You have downloaded and Installed JBoss EAP.
-
You have set the
JAVA_HOME
system environment variable. - You have administrator privileges on the server.
Procedure
-
Configure the start-up options in the
jboss-eap.conf
file by opening thejboss-eap.conf
in a text editor and set the options for your JBoss EAP installation. Copy the service initialization and configuration files into the system directories:
Copy the modified service configuration file to the
/etc/default
directory.NoteThe commands in this procedure require root privileges to run. Either run
su
- to switch to the root user or preface the commands withsudo
.$ sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default
Copy the service startup script to the
/etc/init.d
directory and give it execute permissions:$ sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d $ sudo chmod +x /etc/init.d/jboss-eap-rhel.sh $ sudo restorecon /etc/init.d/jboss-eap-rhel.sh
Add the new
jboss-eap-rhel.sh
service to the list of automatically started services using thechkconfig
service management command:$ sudo chkconfig --add jboss-eap-rhel.sh
Verify that the service has been installed correctly by using one of the following commands.
For Red Hat Enterprise Linux 6:
$ sudo service jboss-eap-rhel.sh start
For Red Hat Enterprise Linux 7 and later:
$ sudo service jboss-eap-rhel start
Optional: To make the service start automatically when the RHEL server starts, run the following command:
$ sudo chkconfig jboss-eap-rhel.sh on
Verification
-
To check the permissions of a file, enter the
ls -l
command in the directory containing the file. To check that the automatic service start is enabled, enter the following command:
$ sudo chkconfig --list jboss-eap-rhel.sh
Additional resources
- For more information about controlling the state of services, see Management system services in the JBoss EAP Configuring basic system settings guide.
- For more information about viewing error logs, see Bootup logging in the JBoss EAP Configuration Guide.
2.2. Removing JBoss EAP service on RHEL
You can remove an instance of JBoss EAP and any of its services associated. After you remove these components, you can install JBoss EAP by using a suitable installation method.
Prerequisites
- You have JBoss EAP installed.
Procedure
When the service is running, open a terminal and stop the service with one of the following command:
$ sudo service jboss-eap-rhel.sh stop
NoteThe commands in this procedure require root privileges to run. Either run
su
- to switch to the root user or preface the commands withsudo
.Remove JBoss EAP from the list of services:
$ sudo chkconfig --del jboss-eap-rhel.sh
Delete the configuration file and startup script:
$ sudo rm /etc/init.d/jboss-eap-rhel.sh $ sudo rm /etc/default/jboss-eap.conf
Chapter 3. Running and removing JBoss EAP as a service on Microsoft Windows Server
3.1. Running JBoss EAP as a service on Microsoft Windows server
You can configure JBoss EAP to run as a service on Microsoft Windows server. This method provides a basic default installation of a server, with configuration files and libraries placed in standard folders.
If you use the set
command to set system environment variables in a Windows Server command prompt, it does not permanently set the environment variables. You must use either the setx
command, or the System
interface in the Control Panel
.
Prerequisites
- You have installed JBoss EAP.
- You have administrator privileges on the server.
-
You have set the
JAVA_HOME
system environment variable. - You have verified that the JBoss EAP server instance is not running.
Procedure
-
Use the
setx
command to create two system environment variables:JBOSS_HOME
andNOPAUSE
. Use the
setx
command to configure the two environment variables:-
Set the path for the
JBOSS_HOME
variable to the JBoss EAP installation directory. -
The
jboss-cli.bat
script contains the"x%NOPAUSE%" == "x" pause
line of code. This code creates a status message when you issue the pause command. To disable these messages, you must specify a value for theNOPAUSE
variable. For example, setting theNOPAUSE
variable toNOPAUSE=true
disables status messages from appearing when a script completes.
-
Set the path for the
Additional resources
- To learn more about how to set environment variables on a Microsoft Windows Server, refer to the Microsoft Windows documentation.
3.2. Removing JBoss EAP service on Microsoft Windows Server
You can remove an instance of JBoss EAP and any services associated with it. Thereafter, you can install JBoss EAP by using a suitable installation method.
Prerequisites
- You have JBoss EAP installed.
Procedure
When the service is running, open the command prompt and stop the service by entering the
net
stop command with the name of the service:net stop JBossEAP7
At a command prompt, change directories to
EAP_HOME\bin
and execute the following command:service.bat uninstall