Chapter 7. Running and removing JBoss EAP as a service on RHEL

Procedure

1. Create the user and group that will be used to launch the server:

   $ sudo groupadd -r groupname
   $ sudo useradd -r -g groupname -d $EAP_HOME -s /sbin/nologin username
   $ sudo chown -R username:groupname $EAP_HOME

   Note

   The commands in this procedure require root privileges to run. Either run su - to switch to the root user or preface the commands with sudo.

2. Generate the systemd unit file:

   Standalone mode

   $ sudo cd $EAP_HOME/bin/systemd
   $ sudo ./generate_systemd_unit.sh standalone username groupname

   Domain mode

   $ sudo cd $EAP_HOME/bin/systemd
   $ sudo ./generate_systemd_unit.sh domain username groupname

3. Configure the start-up options in the jboss-eap-standalone.conf or jboss-eap-domain.conf by using a text editor and set the options for your JBoss EAP installation:

   Standalone mode

   $ sudo vim $EAP_HOME/bin/systemd/jboss-eap-standalone.conf

   Domain mode

   $ sudo vim $EAP_HOME/bin/systemd/jboss-eap-domain.conf

4. Copy the systemd unit file and the server configuration file, and reload the service daemon:

   Standalone mode

   $ sudo cp $EAP_HOME/bin/systemd/jboss-eap-standalone.service $(pkg-config systemd --variable=systemd_system_unit_dir)
   $ sudo cp $EAP_HOME/bin/systemd/jboss-eap-standalone.conf /etc/sysconfig/
   $ sudo systemctl daemon-reload

   Domain mode

   $ sudo cp $EAP_HOME/bin/systemd/jboss-eap-domain.service $(pkg-config systemd --variable=systemd_system_unit_dir)
   $ sudo cp $EAP_HOME/bin/systemd/jboss-eap-domain.conf /etc/sysconfig/
   $ sudo systemctl daemon-reload

5. Enable the service:

   Standalone mode

   $ sudo systemctl enable jboss-eap-standalone.service
   $ sudo systemctl start jboss-eap-standalone.service

   Domain mode

   $ sudo systemctl enable jboss-eap-domain.service
   $ sudo systemctl start jboss-eap-domain.service

Procedure

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

   Standalone mode

   $ sudo systemctl stop jboss-eap-standalone.service

   Domain mode

   $ sudo systemctl stop jboss-eap-domain.service

   Note

   The commands in this procedure require root privileges to run. Either run su - to switch to the root user or preface the commands with sudo.

2. Disable the service:

   Standalone mode

   $ sudo systemctl disable jboss-eap-standalone.service

   Domain mode

   $ sudo systemctl disable jboss-eap-domain.service

3. Delete the configuration file and startup script:

   Standalone mode

   $ sudo rm "$(pkg-config systemd --variable=systemd_system_unit_dir)/jboss-eap-standalone.service"
   $ sudo rm "/etc/sysconfig/jboss-eap-standalone.conf"
   $ sudo systemctl daemon-reload

   Domain mode

   $ sudo rm "$(pkg-config systemd --variable=systemd_system_unit_dir)/jboss-eap-domain.service"
   $ sudo rm "/etc/sysconfig/jboss-eap-domain.conf"
   $ sudo systemctl daemon-reload

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.

      Note

      The commands in this procedure require root privileges to run. Either run su - to switch to the root user or preface the commands with sudo.

      $ 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 the following command:

   $ sudo systemctl start jboss-eap-rhel

5. Optional: To make the service start automatically when the RHEL server starts, run the following command:

   $ sudo chkconfig jboss-eap-rhel.sh on

Procedure

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

   $ sudo service jboss-eap-rhel.sh stop

   Note

   The commands in this procedure require root privileges to run. Either run su - to switch to the root user or preface the commands with sudo.

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