Installing the Crowd Apache Connector on Red Hat Enterprise Linux

This page provides instructions on how to install the Crowd Apache connector on a computer using Red Hat Enterprise Linux. These instructions are part of the guide to integrating Crowd with Apache.

The intent of these instructions is to take you from a default OS installation to a working Apache/Subversion/Crowd integration as easily as possible. We assume a fresh installation. If you are an experienced Linux system administrator you need not follow these instructions to the letter.

1. Determine which Package You Need

Identify the package you require by looking up your version of Red Hat Enterprise Linux and your processor architecture in the table below.

If you are unsure of your processor architecture, you can determine it by entering the command "uname -p" in a terminal.

^* 'Build from source' means that there is no binary package available for your platform. Rather than following the instructions on this page, you should follow the instructions for installing the Crowd Apache connector on other UNIX-like systems.

2. Subscribe to the Red Hat Network

Ensure that your system has an active subscription to the Red Hat Network. This is required so that packages upon which the Apache Connector depends can be downloaded from Red Hat and installed.

If it has an active subscription, the system will appear in the list of Red Hat Network systems.

If your system does not have an active subscription, you can register it by entering the command "su -c rhn_register" in a terminal on the affected system. Enter the root password when prompted and follow the instructions that appear.

3. (Red Hat Enterprise Linux 6 only) Subscribe to the Optional Software Channel

This is required for installation of some of the packages upon which the Apache Connector depends.

1. Visit the page for your system on the Red Hat Network by clicking its name in the list of systems.
2. Click the 'Alter Channel Subscriptions' link.
3. If the checkbox for 'RHEL Server Optional' is not already checked, check it and click the 'Change Subscriptions' button.

4. Install the Crowd Apache Connector Packages

1. Download the package by entering the following command at a terminal, substituting PACKAGE_RELATIVE_URL with the appropriate relative URL from the table in step 1:

   wget https://downloads.atlassian.com/software/crowd/downloads/cwdapache/packages/PACKAGE_RELATIVE_URL
   

2. Start installation of the package by entering the following command at a terminal, substituting PACKAGE_FILEwith the filename component of the package URL:

   su -c "yum -y --nogpgcheck install PACKAGE_FILE"
   

3. When prompted, enter the root user password.
4. Everything you need should now be installed and Apache should restart. If Apache fails to start, check the /var/log/httpd/error_log file.

Now that the software is installed, the next step is to configure Apache authentication.