Chapter 3. Installing JBoss EAP

1. Log in to the Red Hat Customer Portal.
2. Click Downloads.
3. Click Red Hat JBoss Enterprise Application Platform in the Product Downloads list.
4. In the Version drop-down menu, select 7.2.
5. Find Red Hat JBoss Enterprise Application Platform 7.2.0 in the list and click the Download link.

1. If necessary, move the ZIP file to the server and location where JBoss EAP should be installed.

   Note

   The user who will be running JBoss EAP must have read and write access to this directory.

2. Extract the ZIP archive.

   $ unzip jboss-eap-7.2.0.zip

   Note

   For Windows Server, right-click the ZIP file and select Extract All.

Downloading the JBoss EAP Installer

1. Open a browser and log in to the Red Hat Customer Portal at https://access.redhat.com.
2. Click Downloads.
3. Click Red Hat JBoss Enterprise Application in the Product Downloads list.
4. In the Version drop-down menu, select 7.2.
5. Find Red Hat JBoss Enterprise Application 7.2.0 Installer in the list and click the Download link.

Running the JBoss EAP Graphical Installer

1. Open a terminal and navigate to the directory containing the downloaded JBoss EAP Installer JAR file.

2. Run the graphical installer using the following command:

   $ java -jar jboss-eap-7.2.0-installer.jar

3. Follow the instructions in the table below.

   Table 3.1. JBoss EAP Installer Screens

   Screen Name	When it Appears	Description
   Langauge Selection	Always	Choose the desired language for the installer and click OK.
   License Agreement	Always	The EULA for RED HAT JBOSS MIDDLEWARE. Select "I accept the terms of this license agreement.", and click Next.
   Installation Path	Always	Select the installation path for JBoss EAP, and click Next.
   Component Selection	Always	Select the components to install. Required components are disabled for deselection.
   	Figure 3.1. JBoss EAP Installer - Component Selection Screen
   Create an Administrative User	Always	Create an administrative user and assign a password. Then click Next.
   Installation Overview	Always	Review your installation options, then click Next.
   Component Installation	Always	When the installation progress completes, click Next.
   Configure Runtime Environment	Always	You can choose a default configuration for your JBoss EAP installation, or choose to perform an advanced configuration with the installer. Note that even 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, then click Next.
   	Figure 3.2. JBoss EAP Installer - Configure Runtime Environment Screen
   Configure Password Vault	If you choose to install a password vault in the advanced configuration of the runtime environment.	Configure a password vault to store all your sensitive passwords in an encrypted keystore, 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	If you choose to enable SSL Security in the advanced configuration of the runtime environment.	Specify an SSL keystore and the keystore password for securing the JBoss EAP management interfaces, then click Next. For more information, see the documentation on securing the management interfaces in the How To Configure Server Security guide. Warning Red 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	If you choose to enable LDAP authentication in the advanced configuration of the runtime environment.	Enable LDAP authentication to use an LDAP directory server as the authentication source for the management console, management CLI, and management API. When you are done, 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	If you choose to enable LDAP authentication in the advanced configuration of the runtime environment.	A new security realm will be created and associated with the management interfaces, using the LDAP connection defined in the previous step. Specify the values for your LDAP environment, 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	If you choose to add a security domain in the advanced configuration of the runtime environment.	Configure a security domain for the JBoss EAP server instance. Most of the fields are already populated with default values and do not need modification. When you are done, click Next. For more information, see Security Domains in the Security Architecture guide.
   	Figure 3.6. JBoss EAP Installer - Security Domain Configuration Screen
   JSSE Configuration	If you choose to add a security domain in the advanced configuration of the runtime environment.	Configure Java Secure Socket Extension (JSSE) for the security domain defined in the previous step, using either a keystore or a truststore. When you are done, click Next.
   	Figure 3.7. JBoss EAP Installer - JSSE Configuration Screen
   Quickstarts	If you choose to install quickstarts in the advanced configuration of the runtime environment.	Select the quickstart installation path, then click Next.
   Maven Repository Setup	If you choose to install the quickstarts in the advanced configuration of the runtime environment.	Select your Maven repository and settings file.
   	Figure 3.8. JBoss EAP Installer - Maven Repository Setup Screen
   Socket Bindings	If you choose to configure server port bindings in the advanced configuration of the runtime environment.	Determine whether the installation will use the default port bindings, configure port offsets for all default bindings, or configure custom port bindings. If you choose to configure port offsets, choose the offset number. If you choose to configure custom bindings, select 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 will make the required configuration changes. Click Next.
   	Figure 3.9. JBoss EAP Installer - Socket Bindings Screen
   Custom Socket Bindings for Standalone Configurations	If you choose to configure custom port bindings for standalone mode.	Configure the ports and system properties for each of the standalone configurations (standalone, standalone ha, standalone full, standalone full-ha), then click Next.
   	Figure 3.10. JBoss EAP Installer - Custom Socket Bindings for Standalone Configurations Screen
   Custom Socket Bindings for Domain Configurations	If you choose to configure custom port bindings for domain mode.	Configure 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), then click Next.
   	Figure 3.11. JBoss EAP Installer - Custom Socket Bindings for Domain Configurations Screen
   Logging Options	If you choose to configure logging levels in the advanced configuration of the runtime environment.	Select the desired logging levels, then click Next.
   JSF Setup	If you choose to install a JSF implementation in the advanced configuration of the runtime environment.	Configure the JSF options and paths to your JSF JARs, then click Next. For more information, see Installing a JSF Implementation in the Configuration Guide.
   	Figure 3.12. JBoss EAP Installer - JSF Setup Screen
   JDBC Driver Setup	If you choose to install a JDBC driver in the advanced configuration of the runtime environment.	Install and setup a JDBC driver. Choose the appropriate driver vendor from the drop down list and specify the driver JAR location(s). When you are done, 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	If you choose to install a JDBC driver and install a datasource in the advanced configuration of the runtime environment.	Configure a datasource which can be used by applications. Provide a datasource name and configure the other options, then click Next. For more information, see the details of datasource management in the Configuration Guide.
   	Figure 3.14. JBoss EAP Installer - Datasource Setup Screen
   Configure Server	Always	When the configuration progress completes, click Next.
   Shortcut Configuration	Always	Select the Create shortcuts in the Start-Menu check box to create shortcuts. Only alphanumeric characters, dash (-) and underscore (_) characters are allowed. On Microsoft Windows, the slash (/) and backslash (\) characters are also allowed. Click Next.
   Installation Complete	Always	Click Generate installation script and properties file if you want to capture the selected installation options for a future automated installation, 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.

Running the JBoss EAP Text-based Installer

1. Open a terminal and navigate to the directory containing the downloaded JBoss EAP Installer JAR.

2. Run the text-based installer using the following command:

   $ java -jar jboss-eap-7.2.0-installer.jar -console

3. 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.

Changing the JBoss EAP Repository

1. Before changing the repository, ensure that the JBoss EAP installation has all applicable updates applied:

   # yum update

2. Using Red Hat Subscription Manager, unsubscribe from the existing repository and subscribe to the new repository you want to change to. In the command below, replace EXISTING_REPOSITORY and NEW_REPOSITORY with the respective repository names.

   # subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY

Unattended Automated Installer Installation Using a Variables File

1. Open the .variables file in a text editor and provide a password value for each key. For example:

   adminPassword = password#2
   vault.keystorepwd = vaultkeystorepw
   ssl.password = user12345

2. Run the installer using the automatic installation script XML file. The installer detects the variables file automatically if the completed variables file is in the same directory as the installation script XML file, and you haven’t modified its file name.

   $ java -jar jboss-eap-7.2.0-installer.jar auto.xml
   
   Checking for corresponding .variables file
   Variables file detected: auto.xml.variables
   [ Starting automated installation ]
   ...

   Alternatively, you can specify the path to the variables file using -variablefile:

   $ java -jar jboss-eap-7.2.0-installer.jar auto.xml -variablefile auto.xml.variables

Unattended Automated Installer Installation Using the -variables Argument

1. Run the installer using the automatic installation script XML file, and specify the required passwords as key/value pairs using the -variables argument. For example:

   $ java -jar jboss-eap-7.2.0-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

   Note

   It is important that you do not have any spaces when specifying the -variables key/value pairs.