Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

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

7.1. Running JBoss EAP as a service on RHEL

You can configure JBoss EAP to run as a service in Red Hat Enterprise Linux RHEL. This enables the JBoss EAP service to start automatically when the RHEL server starts.

Prerequisites

  • You have downloaded and Installed JBoss EAP.
  • You have set the JAVA_HOME system environment variable.
  • You have administrator privileges on the server.

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
      Copy to Clipboard

    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
      Copy to Clipboard

  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
    Copy to Clipboard

  4. Verify that the service has been installed correctly by using the following command: 

    $ sudo systemctl start jboss-eap-rhel
    Copy to Clipboard

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

    $ sudo chkconfig jboss-eap-rhel.sh on
    Copy to Clipboard

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
    Copy to Clipboard

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.

7.2. Removing JBoss EAP service on RHEL

You can remove an instance of JBoss EAP and any services associated with it. After you remove these components, you can install JBoss EAP by using a suitable installation method.

Prerequisites

  • You have JBoss EAP installed.

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
    Copy to Clipboard
    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
    Copy to Clipboard

  3. Delete the configuration file and startup script: 

    $ sudo rm /etc/init.d/jboss-eap-rhel.sh
$ sudo rm /etc/default/jboss-eap.conf
    Copy to Clipboard
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.