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 Copy linkLink copied to clipboard!
1.1. JBoss EAP installation methods Copy linkLink copied to clipboard!
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.
| 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 Copy linkLink copied to clipboard!
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_HOMEandPATHenvironment 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 Platformfrom theProduct Downloadslist. -
In the
Versiondrop-down list, select8.0. -
Find
Red Hat JBoss Enterprise Application Platform8.0.0in 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.zipFor Windows Server, right-click the archive file and select
Extract All.NoteEAP_HOMEis 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 Copy linkLink copied to clipboard!
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 Copy linkLink copied to clipboard!
2.1. Running JBoss EAP as a service on RHEL Copy linkLink copied to clipboard!
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_HOMEsystem environment variable. - You have administrator privileges on the server.
Procedure
-
Configure the start-up options in the
jboss-eap.conffile by opening thejboss-eap.confin 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/defaultdirectory.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/defaultCopy the service startup script to the
/etc/init.ddirectory 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.shservice to the list of automatically started services using thechkconfigservice management command:$ sudo chkconfig --add jboss-eap-rhel.shVerify 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 startFor 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 -lcommand 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 Copy linkLink copied to clipboard!
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 stopNoteThe 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.shDelete 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 Copy linkLink copied to clipboard!
3.1. Running JBoss EAP as a service on Microsoft Windows server Copy linkLink copied to clipboard!
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_HOMEsystem environment variable. - You have verified that the JBoss EAP server instance is not running.
Procedure
-
Use the
setxcommand to create two system environment variables:JBOSS_HOMEandNOPAUSE. Use the
setxcommand to configure the two environment variables:-
Set the path for the
JBOSS_HOMEvariable to the JBoss EAP installation directory. -
The
jboss-cli.batscript contains the"x%NOPAUSE%" == "x" pauseline of code. This code creates a status message when you issue the pause command. To disable these messages, you must specify a value for theNOPAUSEvariable. For example, setting theNOPAUSEvariable toNOPAUSE=truedisables 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 Copy linkLink copied to clipboard!
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
netstop command with the name of the service:net stop JBossEAP7At a command prompt, change directories to
EAP_HOME\binand execute the following command:service.bat uninstall