Chapter 3. JBoss EAP installer

Procedure

1. Log in to the Red Hat Customer Portal.
2. From the Product Downloads list, select Red Hat JBoss Enterprise Application Platform.
3. Click Downloads.
4. From the Version drop-down list, select 7.4.
5. Find Red Hat JBoss Enterprise Application Platform 7.4.0 Installer file in the list and click the Download link.

Procedure

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

2. Run the graphical installer using the following command:

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

3. Choose the desired language for the installer and click OK.
4. 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.
5. Select the installation path for JBoss EAP, and click Next.

6. Select the components to install. Required components are disabled for deselection.

   Figure 3.1. JBoss EAP installer - Component selection screen

   
7. Create an administrative user and assign a password. Then click Next.
8. Review your installation options, and then click Yes.
9. When the installation progress completes, click Next.

10. Choose a default configuration for your JBoss EAP installation, or choose to perform an advanced configuration with the installer.

    Note

    Even if you choose a default configuration, you can still alter your configuration using the JBoss EAP management interfaces at a later time.

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

    

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

    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

    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

    
13. When the configuration progress completes, click Next.

14. Select the Create shortcuts in the Start-Menu check box to create shortcuts, and then click Next.

    Note

    Only alphanumeric characters, dash (-), and underscore (_) characters are allowed. On Microsoft Windows, the slash (/) and backslash (\) characters are also allowed.

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

Procedure

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

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

   $ java -jar jboss-eap-7.4.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.

Procedure

1. Configure the start-up options in the jboss-eap.conf file by opening the jboss-eap.conf in a text editor and set the options for your JBoss EAP installation.

2. Copy the service initialization and configuration files into the system directories:

   1. Copy the modified service configuration file to the /etc/default directory.

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default

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

3. Add the new jboss-eap-rhel.sh service to the list of automatically started services using the chkconfig service management command:

   $ sudo chkconfig --add jboss-eap-rhel.sh

4. Verify that the service has been installed correctly by using one of the following commands.

   1. For Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh start

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

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

Procedure

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

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

   Note

   You 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

Procedure

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

2. 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 ]
   ...

Procedure

1. Specify the path to the variables file using -variablefile:

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

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

   Note

   Check that you have not entered any spaces when specifying the -variables key or value pairs.

Procedure

1. Open a terminal and navigate to EAP_HOME/Uninstaller.

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

   
3. Click Uninstall to start the uninstall process.
4. When the uninstall process is finished, click Quit to exit the uninstaller.

Procedure

1. Open a terminal and navigate to EAP_HOME/Uninstaller.

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

   $ java -jar uninstaller.jar -console

3. Follow the prompts to uninstall JBoss EAP.