Installing the Crowd Apache Connector on Debian or Ubuntu Linux

This page provides instructions on how to install the Crowd Apache connector on a computer using Debian Linux or one of its derivative distributions, such as Ubuntu. 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.

These instructions have been tested on Debian 5 and Ubuntu 9.10

1. Install the Prerequisite Packages

1. Use the apt-get command to install the required packages:

   sudo apt-get install liberror-perl libcache-cache-perl libsoap-lite-perl 
   sudo apt-get install libdigest-sha1-perl apache2 libapache2-mod-perl2 
   

2. If you want to integrate Apache with Subversion, install the following packages as well:

   sudo apt-get install subversion libapache2-svn
   

2. Install the Crowd Apache Connector Packages

The Crowd Apache connector software is available in deb format.

1. Download the packages from the link below:
   • https://studio.plugins.atlassian.com/source/browse/~tarball=zip/CWDAPACHE/branches/1.x/DEBS/DEBS.zip
2. Install the packages as follows:

   unzip DEBS.zip
   dpkg -i libatlassian-crowd-perl_1.3-1_all.deb
   dpkg -i libapache-crowdauth-perl_1.3-1_all.deb
   dpkg -i libapache-crowdauthz-perl_1.3-1_all.deb
   

3. Everything you need should now be installed. Restart Apache to make sure there are no errors:

   /etc/init.d/apache2 restart
   

4. If Apache fails to start, check the /var/log/apache2/error.log file.

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