19.3.2. Install the Apache HTTP Server included with JBoss EAP 6 (Zip)

Prerequisites

  • Root-level or administrator access.
  • A supported version of Java installed.
  • The following packages installed:
    • krb5-workstation
    • mod_auth_kerb (required for Kerberos functionality)
    • elinks (required for the apachectl functionality)
    • On Red Hat Enterprise Linux 7, apr-util-ldap (LDAP authentication functionality)
  • The Apache Portability Runtime (APR) must be installed. In Red Hat Enterprise Linux, install package apr-util-devel.
The Apache HTTP Server Zip archive contains symbolic links to several Kerberos modules, which is why the mod_auth_kerb package is a prerequisite. If Kerberos functionality is not required, there is no need to install the mod_auth_kerb package and the associated symbolic link can be deleted: EAP_HOME/httpd/modules/mod_auth_kerb.so.
For information on Apache HTTP Server installation for Microsoft Windows Server environment, see the Configuring the Environment section in the Installing Enterprise Web Server on Windows section of JBoss Enterprise Web Server 2 Installation Guide.

Procedure 19.2. Install the Apache HTTP Server

  1. Navigate to the JBoss EAP downloads list for your platform, on the Red Hat Customer Portal.

    Log in to the Customer Portal at https://access.redhat.com. Click on Downloads, then Red Hat Enterprise Application Server in the list of Product Downloads. Select the correct JBoss EAP version from the Version drop-down menu.
  2. Choose the httpd binary from the list.

    Find the Apache HTTP Server option for your operating system and architecture. Click the Download link. A Zip file containing the Apache HTTP Server distribution downloads to your computer.
  3. Extract the Zip to the system where the Apache HTTP Server binary will run.

    Extract the Zip file on your preferred server, to a temporary location. The Zip file will contain the httpd directory under a jboss-ews-version-number folder. Copy the httpd folder and place it inside the directory where you installed the JBoss EAP 6, commonly referred to as EAP_HOME.
    Your Apache HTTP Server is now be located in EAP_HOME/httpd/ directory. You can now use this location for HTTPD_HOME, as found in other JBoss EAP 6 documentation.
  4. Run the Post-installation script and create apache user and group accounts

    In a terminal emulator, switch to the root user account, navigate to the EAP_HOME/httpd directory and execute the following command.
    ./.postinstall
    Next, check to see if a user called apache exists on the system by running the following command:
    id apache
    If the user does not exist then it will need to be added, along with the appropriate usergroup. In order to achieve this, execute the following:
    /usr/sbin/groupadd -g 91 -r apache 2> /dev/null || :
    /usr/sbin/useradd -c "Apache" -u 48 -g 91 -s /sbin/nologin -r apache 2>
    /dev/null || :
    Once this is completed, if the apache user will be running the httpd service, then the ownership of the HTTP directories will need to be changed to reflect this:
    chown -R apache:apache httpd
    To test that the above commands have been successful, check that the apache user has execution permission to the Apache HTTP Server install path.
    ls -l
    The output should be similar to:
    drwxrwxr-- 11 apache apache 4096 Feb 14 06:52 httpd
  5. Configure the Apache HTTP Server.

    Switch to the new user account using the following command
    sudo su apache
    and then configure the Apache HTTP server as the apache user to meet the needs of your organization. You can use the documentation available from the Apache Foundation at http://httpd.apache.org/ for general guidance.
  6. Start the Apache HTTP Server.

    Start the Apache HTTP Server using the following command:
    EAP_HOME/httpd/sbin/apachectl start
  7. Stop the Apache HTTP Server.

    To stop the Apache HTTP Server, issue the following command:
    EAP_HOME/httpd/sbin/apachectl stop