Installation Guide
For Use with Red Hat JBoss Enterprise Application Platform 7.4
Abstract
Providing feedback on JBoss EAP documentation
To report an error or to improve our documentation, log in to your Red Hat Jira account and submit an issue. If you do not have a Red Hat Jira account, then you will be prompted to create an account.
Procedure
- Click the following link to create a ticket.
- Please include the Document URL, the section number and describe the issue.
- Enter a brief description of the issue in the Summary.
- Provide a detailed description of the issue or enhancement in the Description. Include a URL to where the issue occurs in the documentation.
- Clicking Submit creates and routes the issue to the appropriate documentation team.
Making open source more inclusive
Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.
Chapter 1. Preparing to install JBoss EAP
You can choose to install an instance of JBoss EAP using any of the three types of installers. Depending on your requirements, each installer type is useful in certain situations.
1.1. JBoss EAP installation methods
You can choose one of several methods to install JBoss EAP. Each method is best used in certain situations.
The following table provides a brief overview of each type of installation and links to the sections that cover the relevant processes.
Method | Description |
---|---|
Installer installation |
|
Archive installation |
Note If you plan to use JBoss Operations Network (JBoss ON) to deploy and install JBoss EAP patches, install the target JBoss EAP instances using the archive installation method. |
RPM installation |
|
1.2. The EAP_HOME variable
You can use the variable, EAP_HOME
, to denote the path for the JBoss EAP installation. Set the EAP_HOME
variable to the actual path for the JBoss EAP installation. The path set for the EAP_HOME
variable stays the same and does not change after patching or updating an instance of the JBoss EAP.
EAP_HOME
is not an environment variable. JBOSS_HOME
is the environment variable used in scripts.
Depending on the installation option you choose to install JBoss EAP, you can locate the installation directory or the default path as follows:
-
If you installed JBoss EAP using the archive installation method, the installation directory is the
jboss-eap-7.4
directory where you extracted the archive. If you installed JBoss EAP using the installer application, the default path for
EAP_HOME
is${user.home}/EAP-7.4.0
:-
For Red Hat Enterprise Linux and Solaris:
/home/USER_NAME/EAP-7.4.0/
-
For Microsoft Windows:
C:\Users\USER_NAME\EAP-7.4.0\
-
For Red Hat Enterprise Linux and Solaris:
-
If you installed JBoss EAP using the RPM installation method, the installation directory is
/opt/rh/eap7/root/usr/share/wildfly/
.
Chapter 2. Archive installation of JBoss EAP
You can use the archive installer to install, configure, and uninstall a JBoss EAP instance. You can use the archive installation on all platforms supported by JBoss EAP.
2.1. Downloading JBoss EAP archive
You can use the JBoss EAP archive file on the Red Hat Customer Portal to install JBoss EAP. The archive file installation is platform-independent.
Prerequisites
- Set up an account on the Red Hat Customer Portal.
- Review the JBoss EAP 7 supported configurations and ensure that your system is supported.
Procedure
- Log in to the Red Hat Customer Portal.
- Click Downloads.
- Select Red Hat JBoss Enterprise Application Platform in the Product Downloads list.
- In the Version drop-down list, select 7.4.
- Find Red Hat JBoss Enterprise Application Platform 7.4.0 in the list and click the Download link.
2.2. Installing JBoss EAP by using the archive
You can use the archive installation method to install JBoss EAP. This method is the simplest way to install JBoss EAP and the method provides a basic default installation of a server, with configuration files and libraries placed in standard folders.
Prerequisites
- Set up an account on the Red Hat Customer Portal.
- Review the JBoss EAP 7 supported configurations and ensure that your system is supported.
- Download the JBoss EAP installation package.
- Install a supported Java Development Kit (JDK).
-
If you are using Windows, set the
JAVA_HOME
andPATH
environment variables. If you do not have this set up, shortcuts do not work.
Procedure
- Log in to the Red Hat Customer Portal.
- Click Downloads.
- Select Red Hat JBoss Enterprise Application Platform in the Product Downloads list.
- From the Version drop-down list, select 7.4
- Find Red Hat JBoss Enterprise Application Platform 7.4.0 in the list and select the Download link.
Optional: Move the archive file to the server and location where you want to install JBoss EAP.
NoteYou must have read and write access to this directory.
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-7.4.0.zip
- For Windows Server, right-click the archive file and select Extract All.
EAP_HOME
is the top-level directory for the JBoss EAP installation. The directory is created by extracting the archive.
Additional resources
-
See Setting up the
EAP_HOME
variable in the JBoss EAP Installation Guide. - For more information about authentication and authorization options, see Management Users in the JBoss EAP Configuration Guide.
2.3. JBoss EAP configuration file
You can configure options provided in the configuration file by uncommenting and editing the respective lines. If you do not edit the configuration file, the service defaults to starting a standalone JBoss EAP server using the default configuration file, standalone.xml
.
The startup script and an associated configuration file are located in the EAP_HOME/bin/init.d/
directory.
Several configurable options exist in the jboss-eap.conf
file. You must provide the correct values for JBOSS_HOME
and the JBOSS_USER
.
If you want to start JBoss EAP in a managed domain, add JBOSS_MODE=domain
to jboss-eap.conf
. For example, to specify custom domain configuration files, add JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xml
and JBOSS_HOST_CONFIG=HOST_CONFIG_FILE.xml
.
By default, JBoss EAP uses domain.xml
and host-master.xml
as the domain configuration files.
2.4. Configuring JBoss EAP archive installation as a service on RHEL
You can configure the archive installation to run as a service in Red Hat Enterprise Linux (RHEL).
Prerequisites
- Install JBoss EAP as an archive installation.
- Ensure that you 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.$ 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 8:
$ sudo service jboss-eap-rhel start
The service starts. If the service does not start and you get an error message, check the error logs and make sure that the options in the configuration file are set correctly.
For Red Hat Enterprise Linux 9:
NoteRed Hat Enterprise Linux 9 does not have the
initscripts
package in the default build. This package includes the/etc/init.d/functions
file used by thejboss-eap-rhel.sh
service. The/etc/init.d/functions
file is required to start JBoss EAP as a service; therefore, install theinitscripts
package using the following command:$ sudo dnf install initscripts
Restart
systemctl
:$ sudo systemctl daemon-reload
Start JBoss EAP:
$ sudo service jboss-eap-rhel start
Optional: To make the service start automatically when the Red Hat Enterprise Linux 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.5. Removing JBoss EAP service on RHEL
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.
Procedure
If the service is running, open a terminal and stop the service with one of the following commands:
For Red Hat Enterprise Linux 6:
$ sudo service jboss-eap-rhel.sh stop
For Red Hat Enterprise Linux 7 and later:
$ sudo service jboss-eap-rhel stop
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
2.6. Installing JBoss EAP archive installation as a service on Microsoft Windows Server
You can install JBoss EAP on Microsoft Windows Server by using the archive installation method. This method provides a basic default installation of a server, with configuration files and libraries placed in standard folders. The default installation of the server contains a service.bat
script that you can use with Jsvc to stop and start JBoss EAP.
Prerequisites
- Ensure that you have administrator privileges on the server.
- Set the JAVA_HOME system environment variable.
Procedure
Install the JBoss EAP Core Services Jsvc package:
- Open a browser and log in to the Red Hat Customer Portal’s Software Downloads page.
- From the Product drop-down list, select Apache Jsvc.
- From the Version drop-down list, select the latest version.
- From the Releases list, select Red Hat JBoss Core Services Apache Jsvc. Ensure that you select the correct platform and architecture for your system. Next, select the Download link.
Extract the downloaded archive file into the directory containing your JBoss EAP installation directory. This results in a
jbcs-jsvc-<VERSION>
directory at the same depth as your JBoss EAP installation directory. The following example shows the path to thejbcs-jsvc-<VERSION>
directory:C:\Program Files ├── jboss-eap-7.4 │ ├── bin │ └── ... └── jbcs-jsvc-<VERSION>
Install the service by opening the terminal and changing the directories to
EAP_HOME\bin
. For a list of all possible options, runservice.bat
without any argumentsNoteIf you specify the
/jbossuser
and/jbosspass
parameters, you must ensure that your JBoss EAP user’s password does not contain a hash (#
) or a semicolon (;
).The following examples show a basic
service.bat install
command that is needed to create a new service for either a standalone server, or a server in a managed domain.Enter the following command, adjusting the log level for the service as required:
For a standalone server:
$ service.bat install /loglevel INFO
For a server in a managed domain:
Use the
/host
parameter to specify the name of the JBoss EAP host controller being controlled by the service. You can see valid values for the name by executingls /host
in the management CLI.In the following command, replace
EAP_HOST_NAME
with your JBoss EAP host controller name. If you specify the/host
parameter without providing a JBoss EAP host controller name, the name defaults tomaster
.$ service.bat install /host EAP_HOST_NAME /loglevel INFO
-
A new Windows service is created with the name
JBossEAP7
.
Verification
- Verify the new service in the Services console by opening the Windows Services console (services.msc) and checking that the service is created.
If the default service name was used, in the list of Windows services the new service is displayed as JBossEAP7
.
From the Services console you can start and stop the service, and change its settings of how and when it starts.
2.7. Configuring JBoss EAP archive installation as a service on Microsoft Windows Server
You can install JBoss EAP on Microsoft Windows Server using the archive installation method. 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
- Install JBoss EAP as an archive installation.
- Ensure that you have administrator privileges on the server.
- Set the JAVA_HOME system environment variable.
- Verify 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:-
Configure the path for the
JBOSS_HOME
variable to the JBoss EAP installation directory. -
The
jboss-cli.bat
script contains theif "x%NOPAUSE%" == "x" pause
line of code. This code creates a status message when you issue thepause
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.
-
Configure 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.
2.8. Starting and stopping the JBoss EAP service on Microsoft Windows Server
In certain situations, you might need to use the command prompt to either stop or start the service. For instance, if you make any registry changes, you must stop the service and then restart it to force the service to re-read the registry.
Prerequisites
- Install JBoss EAP as an archive installation.
Procedure
- To start the service, at the command prompt issue the following command:
$ net start JBossEAP7
- To stop the service, at the command prompt issue the following command:
$ net stop JBossEAP7
2.9. Removing JBoss EAP service on Microsoft Windows Server
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.
Procedure
If 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
2.10. Installing and starting JBoss EAP archive installation by using Jsvc
You can use the Apache Java Service (Jsvc) component of the JBoss Core Services Apache HTTP Server Installation Guide collection to run JBoss EAP as a detached process, daemon, on Red Hat Enterprise Linux (RHEL).
Although Jsvc works on RHEL, we strongly recommend that you use the native methods for running JBoss EAP as a service on RHEL.
Jsvc is a set of libraries and applications that provide Java applications the ability to run as a background service. Applications run using Jsvc can perform operations as a privileged user, then switch identity to a non-privileged user.
Procedure
- Open a browser and log in to the Red Hat Customer Portal’s Software Downloads page.
- From the Product drop-down list, select Apache Jsvc.
- From the Version drop-down list, select the latest version.
- From the Releases list, select Red Hat JBoss Core Services Apache Jsvc. Ensure that you select the correct platform and architecture for your system. Next, select the Download link.
Extract the downloaded archive file into the directory containing your JBoss EAP installation directory.
This results in a
jbcs-jsvc-<VERSION>
directory at the same depth as your JBoss EAP installation directory. For example:/var/opt/ ├── jboss-eap-7.4 │ ├── bin │ └── ... └── jbcs-jsvc-<VERSION>
Optional: The command examples for using Jsvc to start JBoss EAP assume that a
jboss
user has been created. If you have not already created a user for JBoss EAP, run the following commands to create thejboss
user and group:# groupadd -f -g 185 -r jboss # useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss
Additional resources
- To learn more about controlling JBoss Core Services, see Configuring the Apache HTTP Server Installation in the Apache HTTP Server Installation Guide.
2.11. Jsvc commands to start or stop JBoss EAP as a standalone server
Using Java Service (Jsvc), you can enter various commands for starting or stopping JBoss EAP. The following table shows a list of paths that are needed for the commands for an archive JBoss EAP installation.
File Reference in Instructions | File Location |
---|---|
|
|
|
|
|
|
|
|
The following example demonstrates starting a standalone JBoss EAP server using Jsvc with a JSVC_BIN \ path:
$ JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone
The following example demonstrates stopping a standalone JBoss EAP server using Jsvc with a JSVC_BIN \ path:
$ JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone
2.12. Jsvc commands to start or stop JBoss EAP on a managed domain
Using Java Service (Jsvc), you can enter various commands for starting or stopping JBoss EAP. The following tables show the path that is needed for the commands for an archive JBoss EAP installation.
File Reference in Instructions | File Location |
---|---|
|
|
|
|
|
|
|
|
Before you issue the following command, set the JAVA_HOME system environment variable.
The following example demonstrates starting a JBoss EAP managed domain using Jsvc:
$ JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm "${JAVA_HOME}"/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm "${JAVA_HOME}"/bin/java \
The following example demonstrates stopping a JBoss EAP managed domain using Jsvc:
$ JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \
2.13. Uninstalling a JBoss EAP archive installation
You can use the the archive installation method to install JBoss EAP in a single directory.
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
- Optional: Back up any modified configuration files and deployments that may be reused.
Procedure
- Delete the installation directory to uninstall JBoss EAP.
- Delete any scripts that depend on JBoss EAP being installed on your machine.
Chapter 3. JBoss EAP installer
You can use the JBoss EAP installer to install, configure, and uninstall a JBoss EAP instance. You can use the JBoss EAP installer on all platforms supported by JBoss EAP.
3.1. Downloading and installing the JBoss EAP installer
You can use the JBoss EAP installer that is available from the Red Hat Customer Portal. The .jar
archive can be used to run either the graphical or text-based installers. The installer is the preferred way to install JBoss EAP on all supported platforms.
Prerequisites
- Set up an account on the Red Hat Customer Portal.
- Review the JBoss EAP 7 supported configurations and ensure that your system is supported.
- Install a supported Java Development Kit (JDK).
Procedure
- Log in to the Red Hat Customer Portal.
- From the Product Downloads list, select Red Hat JBoss Enterprise Application Platform.
- Click Downloads.
- From the Version drop-down list, select 7.4.
- Find Red Hat JBoss Enterprise Application Platform 7.4.0 Installer file in the list and click the Download link.
3.2. Running the JBoss EAP graphical installer
The graphical installer offers a convenient way for you to install, configure, and uninstall a JBoss EAP instance. Additionally, you can use the graphical installer to access many optional configuration options.
Prerequisites
- Set up an account on the Red Hat Customer Portal.
- Review the JBoss EAP 7 supported configurations and ensure that your system is supportable.
- Download the JBoss EAP installation package.
- Install a supported Java Development Kit (JDK).
Procedure
- Open a terminal and navigate to the directory containing the downloaded JBoss EAP installer file.
Run the graphical installer using the following command:
$ java -jar jboss-eap-7.4.0-installer.jar
- Choose the desired language for the installer and click OK.
- Agree with the prompt for The EULA for RED HAT JBOSS MIDDLEWARE by selecting "I accept the terms of this license agreement", and then click Next.
- Select the installation path for JBoss EAP, and click Next.
Select the components to install. Required components are disabled for deselection.
Figure 3.1. JBoss EAP installer - Component selection screen
- Create an administrative user and assign a password. Then click Next.
- Review your installation options, and then click Yes.
- When the installation progress completes, click Next.
Choose a default configuration for your JBoss EAP installation, or choose to perform an advanced configuration with the installer.
NoteEven if you choose a default configuration, you can still alter your configuration using the JBoss EAP management interfaces at a later time.
Select Perform default configuration, or select Perform advanced configuration and select the items to configure, and then click Next.
Figure 3.2. JBoss EAP installer - Configure runtime environment screen
The following configuration steps are optional:
Configure password vault
You can use the Configure Password Vault option to install a password vault in the advanced configuration of the runtime environment.
- Configure a password vault to store your sensitive passwords in an encrypted keystore, and then click Next.
For more information, see the password vault documentation in the How To Configure Server Security guide.
Figure 3.3. JBoss EAP installer - Configure password vault screen
SSL Security
You can enable SSL Security in the advanced configuration of the runtime environment by specifying the location of the keystore and the password for securing the JBoss EAP management interfaces.
a. Specify the location of the keystore and the password for securing the JBoss EAP management interfaces.
b. When you have specified these values, click Next.
For more information, see the documentation on securing the management interfaces in the How To Configure Server Security guide.
WarningRed Hat recommends that SSLv2, SSLv3, and TLSv1.0 be explicitly disabled in favor of TLSv1.1 or TLSv1.2 in all affected packages.
LDAP configuration
You can enable the LDAP server to be the authentication and authorization authority as follows:
a. Select Configure Runtime.
b. Select Enable LDAP authentication.
c. On the LDAP Configuration screen, complete the required configurations and click Next.
For more information, see the LDAP documentation in How to Configure Identity Management.
Figure 3.4. JBoss EAP installer - LDAP configuration screen
LDAP security realm configuration
You can enable LDAP authentication in the advanced configuration of the runtime environment by using the LDAP connection, which is defined in the previous step. Enabling LDAP authentication creates a new security realm and this realm becomes associated with the management interfaces.
- Specify the values for your LDAP Security Realm, and then click Next.
For more information, see the LDAP documentation in How to Configure Identity Management.
Figure 3.5. JBoss EAP installer - LDAP security realm configuration screen
Security Domain Configuration
You can add a security domain in the advanced configuration of the runtime environment by configuring a security domain for the JBoss EAP server instance. Most of the fields are already populated with default values and do not need modification.
a. Configure the security domain for your JBoss EAP server instance.
b. Click Next.
For more information, see Security Domains in the Security Architecture guide.
Figure 3.6. JBoss EAP installer - Security domain configuration screen
Java Secure Socket Extension configuration
You can add a security domain in the advanced configuration of the runtime environment by configuring the Jave Secure Socket Extension (JSSE) for the security domain defined in the previous step.
a. For the JSSE element, set either a keystore or a truststore.
b. Click Next.
Figure 3.7. JBoss EAP installer - Java Secure Socket Extension configuration screen
Quickstarts
You can choose to install quickstarts in the advanced configuration of the runtime environment by selecting the quickstart installation path, and then clicking Next.
Maven repository setup
You can install quickstarts in the advanced configuration of the runtime environment by selecting your Maven repository and its settings.xml file.
Figure 3.8. JBoss EAP installer - Maven repository setup screen
Socket bindings
Choose one of the following options to configure your socket bindings:
- Configure server port bindings in the advanced configuration settings of the runtime environment by configuring port offsets for all default bindings, or configuring custom port bindings. You might need to determine whether the installation uses the default port bindings.
- Configure port offsets by choosing the offset type.
- Configure custom bindings by selecting whether to configure the ports for standalone mode, domain mode, or both.
- If the host is configured for IPv6 only, select the Enable pure IPv6 configuration check box and the installer makes the required configuration changes.
When you have configured your socket binding, click Next.
Figure 3.9. JBoss EAP Installer - Socket bindings screen
Custom socket bindings for Standalone configurations
-
Configure custom port bindings for standalone mode by setting the ports and system properties for each of the standalone configurations (
standalone
,standalone ha
,standalone full
,standalone full-ha
), and then click Next.
Figure 3.10. JBoss EAP installer - Custom socket bindings for standalone configurations screen
Custom socket bindings for domain configurations
-
Configure custom port bindings for domain mode by setting the ports and system properties for the host configuration (
domain host
) and each of the domain profiles (domain default
,domain ha
,domain full
,domain full-ha
), and then click Next.
Figure 3.11. JBoss EAP installer - Custom socket bindings for domain configurations screen
Logging options
You can configure logging levels in the advanced configuration settings of the runtime environment as follows:
a. Select the desired logging levels for the root logger and the console logger.
b. Click Next.
Jakarta server faces setup
You can install a Jakarta Server Faces implementation in the advanced configuration settings of the runtime environment, as follows:
a. Configure the Jakarta Server Faces options and paths to your Jakarta Server Faces JARs.
b. Click Next.
For more information, see Installing a Jakarta Server Faces Implementation in the Configuration Guide.
Figure 3.12. JBoss EAPinstaller - Jakarta server faces setup screen
JDBC driver setup
You can install a JDBC driver in the advanced configuration settings of the runtime environment by installing and setting up a JDBC driver.
a. Choose the appropriate driver vendor from the drop-down list.
b. Specify the driver’s JAR location(s).
c. Click Next.
For more information, see the datasource JDBC driver section in the Configuration Guide.
Figure 3.13. JBoss EAP installer - JDBC driver setup screen
Datasource setup
You can install a JDBC driver and install a datasource in the advanced configuration settings of the runtime environment by configuring a datasource.
a. Provide a datasource name and configure the other options.
b. Click Next.
For more information, see the details of datasource management in the Configuration Guide.
Figure 3.14. JBoss EAP installer - Datasource setup screen
- When the configuration progress completes, click Next.
Select the Create shortcuts in the Start-Menu check box to create shortcuts, and then click Next.
NoteOnly alphanumeric characters, dash (-), and underscore (_) characters are allowed. On Microsoft Windows, the slash (/) and backslash (\) characters are also allowed.
- Click Generate installation script and properties file if you want to capture the selected installation options for a future automated installer installation, and then click Done.
Installation is now complete. The directory created by the installer is the top-level directory for the server. This is referred to as EAP_HOME
.
3.3. Running the JBoss EAP text-based installer
You can use the text-based installer to install, configure, and uninstall a JBoss EAP instance. This installer method offers an uncluttered and straightforward experience.
Prerequisites
- Set up an account on the Red Hat Customer Portal.
- Review the JBoss EAP 7 supported configurations and ensure that your system is supported.
- Install a supported Java Development Kit (JDK).
- Download the text-based installer.
- If you are using Windows, set the JAVA_HOME and PATH environment variables. If you do not have this set up, shortcuts do not work.
Procedure
- Open a terminal and navigate to the directory containing the downloaded JBoss EAP installer.
Run the text-based installer using the following command:
$ java -jar jboss-eap-7.4.0-installer.jar -console
-
Follow the prompts to install JBoss EAP. The directory created by the installer is the top-level directory for the server. This is referred to as
EAP_HOME
.
Additional resources
-
See Setting up the
EAP_HOME
variable, in the JBoss EAP Installation Guide.
3.4. Configuring JBoss EAP installer installation as a service on RHEL
You can configure the installer installation to run as a service in Red Hat Enterprise Linux (RHEL).
Prerequisites
- Install the installer.
- Ensure that 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.$ 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
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
The service starts. If the service does not start and you get an error message, check the error logs and make sure that the options in the configuration file are set correctly.
Optional: To make the service start automatically when the Red Hat Enterprise Linux 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
- 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.
-
To check the permissions of a file, enter the
3.5. Configuring JBoss EAP installer installation as a service on Microsoft Windows Server
You can install JBoss EAP on Microsoft Windows Server using the installer installation method. This method provides a basic default installation of a server, with configuration files and libraries placed in standard folders. The default installation of the server contains a service.bat
script that you can use with Jsvc to stop and start JBoss EAP.
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
- Install the JBoss EAP installer.
- Ensure that you administrator privileges on the server.
- Set the JAVA_HOME system environment variable.
- Ensure that you have an instance of the JBoss EAP server that is not running.
Procedure
The procedure for configuring JBoss EAP installer installation as a service in Microsoft Windows Server is similar to that of the archive installation method. See Configuring JBoss EAP archive installation as a service on Microsoft Windows Server.
3.6. Installing and running the JBoss EAP installer installation by using Jsvc
You can use the Apache Java Service (Jsvc) component of the JBoss Core Services Apache HTTP Server Installation Guide collection to run JBoss EAP as a detached service, a daemon, on Red Hat Enterprise Linux (RHEL).
Although Jsvc works on RHEL, we strongly recommend that you use the native methods for running JBoss EAP as a service on RHEL.
Jsvc is a set of libraries and applications that provide Java applications the ability to run as a background service. Applications run using Jsvc can perform operations as a privileged user, then switch identity to a non-privileged user.
Prerequisites
- Install the JBoss EAP installer.
- Ensure that you administrator privileges on the server.
- Set the JAVA_HOME system environment variable.
- Ensure that you have an instance of the JBoss EAP server that is not running.
Procedure
The procedure for configuring the JBoss EAP installer installation by using Jsvc is similar to that of the archive installation method. For more information refer to the following sections in the JBoss EAP Installation Guide:
- Installing and starting JBoss EAP installer installation by using Jsvc
- Jsvc commands to start or stop JBoss EAP as a standalone server
- Jsvc commands to start or stop JBoss EAP on a managed domain
- Optional: Configuring JBoss EAP installer installation as a service on Microsoft Windows Server
Additional resources
- For information about controlling JBoss Core Services, see Configuring the Apache HTTP Server Installation in the Apache HTTP Server Installation Guide.
- For information about configuring a JBoss EAP archive installation as a service using Jsvc, see Archive installation of JBoss EAP.
- For information about configuring a JBoss EAP installer installation on a Microsoft Windows server, see Configuring JBoss EAP installer installation as a service on Microsoft Windows Server.
3.7. Using the automated installer installation
If you used the installer installation to install JBoss EAP, you can use an installation script generated from a previous install to automate future installations with the same configuration.
The automated installer is not backward compatible. You cannot use an installation script generated from a previous version of JBoss EAP with the automated installer. Only use installation scripts generated by the same minor version of JBoss EAP. For example JBoss EAP 7.4.
Prerequisites
Use the installer installation to generate an automatic installation script.
- The automatic installation script is an XML file.
Procedure
- Open a terminal and navigate to the directory containing the downloaded JBoss EAP installer file.
Run the following command to install JBoss EAP using the automatic installation script XML file:
$ java -jar jboss-eap-7.4.0-installer.jar auto.xml
By default, the installer prompts you to enter any passwords required for the JBoss EAP configuration. You can do an unattended install by pre-setting the passwords for the installation.
NoteYou can store the automatic installation script XML file on a network host, and use HTTP or FTP to point the installer to use it for an installation. For example:
$ java -jar jboss-eap-7.4.0-installer.jar http://network-host.local/auto.xml
$ java -jar jboss-eap-7.4.0-installer.jar ftp://network-host.local/auto.xml
Additional resources
- See Unattended automated installer installation in the JBoss EAP Installation Guide.
3.8. Unattended automated installer installation
To do an unattended automated installer installation, you must preset the passwords required for the JBoss EAP installation.
When the installation script XML file is generated from a previous installer installation, an incomplete installation script variables file is also generated. It has the same file name as the installation script file, but with a .variables
suffix.
The variables file contains a list of key and password parameters needed for an unattended automated installation.
You can provide the required passwords as a completed variables file, or as an argument when running the installer command.
3.9. Providing the password as an argument in the installer command
You can edit the .variables
file in a text editor and provide a password value for each key. You can then run the installer by using the automatic installation script. The installer detects the variables file automatically if the completed variables file is in the same directory as the installation script XML file. Additionally, you must not have modified variables file name.
Prerequisites
Use the JBoss EAP installer to generate an automatic installation script.
- The automatic installation script is an XML file.
Procedure
Open the
.variables
file in a text editor and provide a password value for each key. The following example demonstrates setting a password value for a key:adminPassword = password#2 vault.keystorepwd = vaultkeystorepw ssl.password = user12345
Run the installer using the automatic installation script XML file:
$ java -jar jboss-eap-7.4.0-installer.jar auto.xml Checking for corresponding
.variables
file Variables file detected: auto.xml.variables [ Starting automated installation ] ...
3.10. Providing the password as a completed variables file
You can use the -variablefile
option in the management CLI to specify a path to the variables file. You can then run the installer using the automatic installation script to specify passwords as key or value pairs using the -variables
argument.
Prerequisites
Use the JBoss EAP installer to generate an automatic installation script.
- The automatic installation script is an XML file.
Procedure
Specify the path to the variables file using
-variablefile
:$ java -jar jboss-eap-7.4.0-installer.jar auto.xml -variablefile auto.xml.variables
Run the installer using the automatic installation script XML file and specify the required passwords as key/value pairs using the
-variables
argument, as demonstrated in the following example:$ java -jar jboss-eap-7.4.0-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345
NoteCheck that you have not entered any spaces when specifying the
-variables
key or value pairs.
3.11. Uninstalling a JBoss EAP installer with the graphical uninstaller
If you installed JBoss EAP using the installer, you can uninstall JBoss EAP using the graphical uninstaller. The graphical uninstaller offers a convenient way to uninstall the JBoss EAP installer in a few simple steps.
Prerequisites
- Install the JBoss EAP installer.
- Ensure that you administrator privileges on the server.
- Set the JAVA_HOME system environment variable.
- Ensure that you have an instance of the JBoss EAP server that is not running.
Procedure
-
Open a terminal and navigate to
EAP_HOME/Uninstaller
. Run the graphical uninstaller using the following command:
$ java -jar uninstaller.jar
The graphical uninstaller is similar to the following figure. Select the check box if you want to delete the JBoss EAP installation directory.
Figure 3.15. JBoss EAP graphical uninstaller
- Click Uninstall to start the uninstall process.
- When the uninstall process is finished, click Quit to exit the uninstaller.
3.12. Uninstalling JBoss EAP installer installation with the text uninstaller
If you installed JBoss EAP using the installer, you can uninstall JBoss EAP using the text uninstaller. The text uninstaller offers a simpler way to manually uninstall the JBoss EAP installer.
Prerequisites
- Install the JBoss EAP installer.
- Ensure that you have administrator privileges on the server.
- Set the JAVA_HOME system environment variable.
- Ensure that you have an instance of the JBoss EAP server that is not running.
Procedure
-
Open a terminal and navigate to
EAP_HOME/Uninstaller
. Run the text-based uninstaller using the following command:
$ java -jar uninstaller.jar -console
- Follow the prompts to uninstall JBoss EAP.
Chapter 4. RPM installation of JBoss EAP
You can install JBoss EAP using RPM packages on supported installations of Red Hat Enterprise Linux 6, Red Hat Enterprise Linux 7, and Red Hat Enterprise Linux 8.
4.1. Subscribing to a minor JBoss EAP repository
To install JBoss EAP with RPM, you need a subscription to both the Red Hat Enterprise Linux Server
base software repository, as well as a minor JBoss EAP repository.
For the JBoss EAP repository, you must subscribe to a minor JBoss EAP repository. A minor repository provides a specific minor release of JBoss EAP 7 and all applicable patches. This allows you to maintain the same minor version of JBoss EAP, while staying current with high severity and security patches.
For example, updating from this repository includes patches and security updates for the minor JBoss EAP version, but does not include upgrades from JBoss EAP 7.4 to JBoss EAP 7.5.
Prerequisites
- Red Hat Enterprise Linux system is registered to your account using Red Hat Subscription Manager. For more information, see the Red Hat Subscription Management documentation.
Procedure
- Enter the Red Hat Subscription Manager.
Replace
EAP_MINOR_VERSION
with your intended JBoss EAP minor version. For example,7.4
.For Red Hat Enterprise Linux 6 and 7, replace
RHEL_VERSION
with either6
or7
depending on your Red Hat Enterprise Linux version:# subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-server-rpms
For Red Hat Enterprise Linux 8, use the following command:
# subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-ARCH-rpms
4.2. Installing the JBoss EAP RPM installation on RHEL
Choose the Red Hat Packet Manager (RPM) to install a minor version of JBoss EAP. Conversely, you can subscribe to the current JBoss EAP using this method.
A minor version of JBoss EAP provides a specific minor release and all applicable patches. When you subscribe to a minor version of JBoss EAP, you can remain up-to-date with high severity and security patches.
Prerequisites
- Set up an account on the Red Hat Customer Portal.
- Review the JBoss EAP 7 supported configurations and ensure your system is supported.
- Download the JBoss EAP installation package.
- Register to the Red Hat Enterprise Linux server using Red Hat Subscription Manager.
- Install a supported Java Development Kit (JDK).
Procedure
Install JBoss EAP and JDK 8.
# yum groupinstall jboss-eap7
Install JBoss EAP and JDK 11. JDK 11 is available for Red Hat Enterprise Linux 7 and later.
Red Hat Enterprise Linux 7:
# yum groupinstall jboss-eap7-jdk11
Red Hat Enterprise Linux 8:
# dnf groupinstall jboss-eap7-jdk11
NoteThe
groupinstall
command installs the specified version of JDK if that version of JDK is not installed on the system. If a different version of JDK already exists, the system contains multiple JDKs installed after the command is executed.If there are multiple JDKs installed on your system after
groupinstall
is complete, check which JDK is used for JBoss EAP execution. By default, the system default JDK is used.You can modify the default by either of the following ways:
Change system wide configuration using the
alternatives
command:# alternatives --config java
The command displays a list of installed JDKs and instructions for setting a specific JDK as the default.
Change the JDK used by JBoss EAP by using the JAVA_HOME property.
Your installation is complete. The default
EAP_HOME
path for the RPM installation is/opt/rh/eap7/root/usr/share/wildfly
.ImportantWhen using the RPM installer to install JBoss EAP, configuring multiple domain or host controllers on the same machine is not supported.
Additional resources
-
See Setting up the
EAP_HOME
variable, in the JBoss EAP Installation Guide. - See Subscribing to a Minor JBoss EAP repository, in the JBoss EAP Installation Guide.
- For more information about changing the JAVA_HOME property, see the RPM Service Configuration Properties section of the Configuration Guide.
4.3. Changing repositories
Over the lifespan of a JBoss EAP installation, you may want to change the software subscription from one JBoss EAP repository to another. Changing repositories is supported, but only within the following conditions:
- Changing from the current repository to a minor repository is supported if changing to the latest minor repository.
- Changing from a minor repository to another minor repository is supported if changing to the next minor JBoss EAP version. For example, changing from JBoss EAP 7.0 to JBoss EAP 7.1 is supported, but changing from JBoss EAP 7.0 to JBoss EAP 7.2 is not supported.
The JBoss EAP current repository is no longer available as of JBoss EAP 7.3. If you subscribed to the current repository for a previous release of JBoss EAP, you must change your subscription to a minor repository for this release of JBoss EAP.
Prerequisites
- Install JBoss EAP using the RPM installation.
- Choose a repository.
Ensure that the JBoss EAP installation has all applicable updates applied.
- Issue the following command on your terminal to apply the updates:
# yum update
- Comply with the supported change conditions shown above.
Procedure
Using Red Hat Subscription Manager, unsubscribe from the existing repository and subscribe to the new repository. In the command below, replace
EXISTING_REPOSITORY
andNEW_REPOSITORY
with the respective repository names.# subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY
4.4. Configuring JBoss EAP RPM installation as a service on RHEL
You can configure the Red Hat Packet Manager (RPM) installation to run as a service in Red Hat Enterprise Linux (RHEL). An RPM installation of JBoss EAP installs everything that is required to run JBoss EAP as a service
Run the appropriate command for your RHEL, as demonstrated in this procedure. Replace EAP_SERVICE_NAME
with either eap7-standalone
for a standalone JBoss EAP server, or eap7-domain
for a managed domain.
You cannot configure more than one JBoss EAP instance as a service on a single machine.
Prerequisites
- Install JBoss EAP as an RPM installation.
- Ensure that you have administrator privileges on the server.
Procedure
For Red Hat Enterprise Linux 6:
chkconfig EAP_SERVICE_NAME on
For Red Hat Enterprise Linux 7 and later:
systemctl enable EAP_SERVICE_NAME.service
Additional resources
- To start or stop an RPM installation of JBoss EAP on demand, see the RPM instructions in the JBoss EAP Configuration Guide.
- See the RPM service configuration files appendix in the JBoss EAP Configuration Guide for further details and options.
4.5. Installing JBoss EAP RPM installation by using Jsvc
You can use the Apache Java Service (Jsvc) component of the JBoss Core Services collection to run JBoss EAP as a detached process, daemon, on Red Hat Enterprise Linux (RHEL). You would usually use Jsvc to run JBoss EAP on Windows or Solaris.
For best product performance, use the native method for running JBoss EAP as a service on your version of RHEL.
Jsvc is a set of libraries and applications that provide Java applications the ability to run as a background service. Applications run using Jsvc can perform operations as a privileged user and then switch identity to a non-privileged user.
Prerequisites
- Install JBoss EAP as an RPM installation.
- Ensure that you have administrator privileges on the server.
Procedure
- Log in to the Red Hat Customer Portal.
- Click on Systems in the Subscriber Inventory.
Subscribe to the JBoss Core Services CDN repositories for your operating system version and architecture:
For Red Hat Enterprise Linux 6:
jb-coreservices-1-for-rhel-6-server-rpms
For Red Hat Enterprise Linux 7 and later:
jb-coreservices-1-for-rhel-7-server-rpms
Run the following command as the root user to install Apache Jsvc:
# yum groupinstall jbcs-jsvc
Additional resources
- To learn more about controlling JBoss Core Services, see Apache HTTP Server Installation Guide.
- For information about installing JBoss Core Services on RHEL, see Installing JBoss Core Services Apache HTTP Server on Red Hat Enterprise Linux in the Apache HTTP Server Installation Guide.
- For information about installing JBoss Core Services on Windows, see Installing JBoss Core Services Apache HTTP Server on Windows in the Apache HTTP Server Installation Guide.
- For information about installing JBoss Core Services on Solaris, see Installing Apache HTTP Server on Solaris in the Apache HTTP Server Installation Guide.
4.6. Jsvc commands to start or stop JBoss EAP as a standalone server
Using Java Service (Jsvc), you can enter various commands for starting or stopping JBoss EAP. The following table shows a list of paths that are needed for the commands for an archive JBoss EAP installation.
File Reference in Instructions | File Location |
---|---|
|
|
|
|
|
|
|
|
The following example demonstrates starting a JBoss EAP standalone server using Jsvc with a JSVC_BIN \
path:
$ JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone
The following example demonstrates stopping a JBoss EAP standalone server using Jsvc with a JSVC_BIN \
path:
$ JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone
4.7. Jsvc commands to start or stop JBoss EAP as a managed domain
Using Java Service (Jsvc), you can enter various commands for starting or stopping JBoss EAP. The following table shows a list of paths that are needed for the commands for an archive JBoss EAP installation.
File Reference in Instructions | File Location |
---|---|
|
|
|
|
|
|
|
|
The following example demonstrates starting a JBoss EAP domain server using Jsvc with a JSVC_BIN \
path. Before you issue the following command, set the JAVA_HOME
system environment variable.
$ JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm "${JAVA_HOME}"/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm "${JAVA_HOME}"/bin/java \
The following example demonstrates stopping a JBoss EAP domain server using Jsvc with a JSVC_BIN \
path.
$ JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm $JAVA_HOME/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm $JAVA_HOME/bin/java
4.8. Uninstalling a JBoss EAP RPM installation
Uninstalling a JBoss EAP installation that is using the RPM method is not recommended.
Because of the nature of RPM package management, it cannot be guaranteed that all installed packages and dependencies are completely removed, or that the system is not left in an inconsistent state caused by missing package dependencies.
Revised on 2024-01-17 05:25:15 UTC