Chapter 2. Archive installation of JBoss EAP

Procedure

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

Procedure

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

6. Optional: Move the archive file to the server and location where you want to install JBoss EAP.

   Note

   You must have read and write access to this directory.

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

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
      $ sudo restorecon /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 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.

   3. For Red Hat Enterprise Linux 9:

      Note

      Red 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 the jboss-eap-rhel.sh service. The /etc/init.d/functions file is required to start JBoss EAP as a service; therefore, install the initscripts package using the following command:

      $ sudo dnf install initscripts

      1. Restart systemctl:

         $ sudo systemctl daemon-reload

      2. Start JBoss EAP:

         $ sudo service jboss-eap-rhel start

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

Procedure

1. If the service is running, open a terminal and stop the service with one of the following commands:

   1. For Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh stop

   2. For Red Hat Enterprise Linux 7 and later:

      $ sudo service jboss-eap-rhel stop

2. Remove JBoss EAP from the list of services:

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

3. Delete the configuration file and startup script:

   $ sudo rm /etc/init.d/jboss-eap-rhel.sh
   $ sudo rm /etc/default/jboss-eap.conf

Procedure

1. Install the JBoss EAP Core Services Jsvc package:

   1. Open a browser and log in to the Red Hat Customer Portal’s Software Downloads page.
   2. From the Product drop-down list, select Apache Jsvc.
   3. From the Version drop-down list, select the latest version.
   4. 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.

2. 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 the jbcs-jsvc-<VERSION> directory:

   C:\Program Files
   ├── jboss-eap-7.4
   │   ├── bin
   │   └── ...
   └── jbcs-jsvc-<VERSION>

3. Install the service by opening the terminal and changing the directories to EAP_HOME\bin. For a list of all possible options, run service.bat without any arguments

   Note

   If 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:

   1. For a standalone server:

      $ service.bat install /loglevel INFO

   2. 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 executing ls /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 to master.

      $ service.bat install /host EAP_HOST_NAME /loglevel INFO

4. A new Windows service is created with the name JBossEAP7.

Procedure

1. Use the setx command to create two system environment variables: JBOSS_HOME and NOPAUSE.

2. Use the setx command to configure the two environment variables:

   1. Configure the path for the JBOSS_HOME variable to the JBoss EAP installation directory.
   2. The jboss-cli.bat script contains the if "x%NOPAUSE%" == "x" pause line of code. This code creates a status message when you issue the pause command. To disable these messages, you must specify a value for the NOPAUSE variable. For example, setting the NOPAUSE variable to NOPAUSE=true disables status messages from appearing when a script completes.

Procedure

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

2. At a command prompt, change directories to EAP_HOME\bin and execute the following command:

   service.bat uninstall

Procedure

1. Open a browser and log in to the Red Hat Customer Portal’s Software Downloads page.
2. From the Product drop-down list, select Apache Jsvc.
3. From the Version drop-down list, select the latest version.
4. 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.

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

6. 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 the jboss user and group:

   # groupadd -f -g 185 -r jboss
   # useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss

Procedure

1. Delete the installation directory to uninstall JBoss EAP.
2. Delete any scripts that depend on JBoss EAP being installed on your machine.