Installing the Crowd Apache Connector on OpenSolaris

This page provides instructions on how to install the Crowd Apache connector on a computer using OpenSolaris (http:/www.opensolaris.org). 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 Solaris system administrator you need not follow these instructions to the letter.

These instructions were tested on OpenSolaris 2009.06.

1. Install the Prerequisite Packages

Please make sure that you run all the commands in this section as root.

When following the instructions below, you will install some required Perl modules and the Sun Studio compiler. The Crowd Apache connector integrates with Apache using the Perl language, which should be already installed. You must, however, install several Perl modules required by the connector, as described below. Perl modules are generally not available in PKG format for OpenSolaris, so you will need to install them directly from CPAN. Several of the CPAN modules need a C compiler and they assume the Sun Studio compiler.

1. Assume the root role by running pfexec bash.
2. Install the Apache web server:

   pkg install SUNWapch22
   

3. If you are planning to use Apache as a front end to Subversion, install the Subversion package as well:

   pkg install SUNWsvn
   

4. Install the Sun Studio compiler:

   pkg install developer/sunstudioexpress
   

5. Install the required Perl modules from CPAN:

   export PATH="/opt/SunStudioExpress/bin:$PATH"
   perl -MCPAN -e "install Error"
   perl -MCPAN -e "install Digest::SHA1"
   perl -MCPAN -e "install Cache::Cache"
   perl -MCPAN -e "install SOAP::Lite"
   

   If this is the first time you have installed Perl modules via CPAN you will prompted to configure it. Accepting the default values for each question should work. Also, during the installation of the SOAP::Lite module you will be prompted to confirm the installation of several other dependent modules. Say 'yes' in each case.

2. Install the Crowd Apache Connector Packages

The Crowd Apache connector software is available in pkg format.

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

1. Install the packages as follows:

   unzip PKGS.zip
   pkgadd -d ATLNperl-atlassian-crowd-all.pkg
   pkgadd -d ATLNperl-apache-crowdauth-all.pkg
   pkgadd -d ATLNperl-apache-crowdauthz-all.pkg
   

3. Do the Initial Apache Configuration

1. Perl integration is not enabled by default. To add it, edit the file /etc/apache2/2.2/conf.d/modules-32.load and add the following line:

   LoadModule perl_module libexec/mod_perl.so
   

2. If you want to enable Subversion integration, add the following line as well:

   LoadModule dav_svn_module libexec/mod_dav_svn.so
   

3. Edit the file /etc/apache2/2.2/conf.d/modules-64.load and add the following line:

   LoadModule perl_module libexec/64/mod_perl.so
   

4. If you want to enable Subversion integration, add the following line as well:

   LoadModule dav_svn_module libexec/64/mod_dav_svn.so
   

5. Enable the Apache service:

   svcadm enable network/http:apache22
   svcadm restart network/http:apache22
   

6. Use the svcs command to check that the service is running:

   # svcs -l apache22
   fmri         svc:/network/http:apache22
   name         Apache 2.2 HTTP server
   enabled      true
   state        online
   next_state   none
   state_time   Wed Jun 23 15:37:49 2010
   logfile      /var/svc/log/network-http:apache22.log
   restarter    svc:/system/svc/restarter:default
   contract_id  99 
   dependency   require_all/error svc:/milestone/network:default (online)
   dependency   require_all/none svc:/system/filesystem/local:default (online)
   dependency   optional_all/error svc:/system/filesystem/autofs:default (online)
   

7. If the state shows as 'maintenance', check the /var/svc/log/network-http:apache22.log file for the cause.

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