Installation tips

Ubuntu Linux / Debian

Installing Bricolage on Debian and Ubuntu (a very nice debian clone) is fairly easy using the apt package manager. You may need to add in the universe repository into /etc/apt/sources.list. Apache2 is now the only supported version of Apache under Ubuntu 8.04 LTS and Debian 5 so that’s what we’re using.
From a base installation you should run

	
apt-get install libunix-syslog-perl libdbi-perl liberror-perl libcache-cache-perl libdigest-sha1-perl libmime-perl libxml-writer-perl libimage-info-perl libmldbm-perl libparams-validate-perl libexception-class-perl libclass-container-perl libhtml-mason-perl libapache-session-perl libxml-parser-perl libxml-simple-perl libio-stringy-perl libsoap-lite-perl libtest-class-perl libparams-validate-perl libdatetime-perl libdatetime-timezone-perl libossp-uuid-perl liblist-moreutils-perl libtext-diff-perl libterm-readpassword-perl libimager-perl libcrypt-ssleay-perl libnet-ssh-perl libmodule-build-perl libterm-readline-perl-perl libxml-dom-perl libpod-simple-perl libcache-mmap-perl libhttp-browserdetect-perl libmasonx-interp-withcallbacks-perl libparams-callbackrequest-perl libtest-mockmodule-perl libtext-diff-perl libtext-worddiff-perl libexpat1 libexpat1-dev apache2 libapache2-mod-perl2 libapache2-mod-apreq2 apache2-mpm-prefork libapache2-request-perl xml-core
	

The above includes the libimager package and its dependents that will allow you to use the thumbnail preview code in your search results, see bricolage.conf for more details. It also installs some basic SSL stuff in preparation for installing Net::SFTP via CPAN if you want to later.

Then either use postgres:

	
apt-get install postgresql libpg-perl libdbd-pg-perl postgresql-server-dev-8.3
	

or use mysql :

	
	apt-get install mysql-server libdbd-mysql-perl
	

The packages below are also required for installing bricolage manually. You should uninstall them when finished.

	
apt-get install binutils cpp gcc make (and libpq-dev if using postgres)
	

You should edit pg_hba.conf in /etc/postgresql-8.X to allow root to login to postgres for the installation, needs local trust access.

You also need to run a2enmod qpreq

You also need to install the following CPAN modules:

• Test::File::Contents (download via CPAN but uses Build not make)
• Text::LevenshteinXS
• Text::Diff::HTML

Once you’ve installed bricolage manually, if you want it to auto start on machine boot then symlink bin/bric_apachectl to /etc/init.d and do a “sudo update-rc.d bric_apachectl defaults 92”. Note that you will need to edit the bric_apachectl file to tell it where your BRICOLAGE_ROOT is if you didn’t use /usr/local/bricolage.

Red Hat

Installed 1.10.2 successfully on Red Hat Enterprise Linux AS release 4 (Nahant Update 3).

Before installing any modules from CPAN make sure to run:

	
$ export LANG='en_US'
	

Otherwise several modules will fail for strange reasons.
The following rpms you will want to install before running CPAN

• libxml2-devel
• db4-devel
• gmp-devel
• expat-devel

You will need to install the CPAN modules below.

CPAN modules

To install any of the SFTP moving modules, Math::Pari is required. The package needs pari installed. When the module is installed via CPAN pari should download and install automatically after confirming you wish this done.
An additional module to speed up publishing over SSH:

• Math::BigInt::GMP