CentOS 5.5 installation instructions
The following is a journal of one successful CA installation on a fresh CENTos 5.5 server. It correctly installed and works, but not all of the media bits work fully.
This may not be an optimal install, but it does work. There are also many alternatives to some of these steps but this is a combination that works.
The machine is a 64bit machine in a basic server configuration with smb (not required) and httpd turned on as services. The following ports were opened up:
http; https; smtp; samba; 10000
After running the CENTos installation,
install webmin as on http://www.webmin.com/rpm.html
Add user account for admin user to: webmin; linux; smb (if using it) and visudo
It is assumed that the rest of the install will be done over SSH (or a local shell) as root or sudo'd as root.
Package management matters
Installed RPMforge as http://wiki.centos.org/AdditionalResources/Repositories/RPMForge
to update all packages
CENTos 5.5 ships with PHP version 5.1, this is not officially supported by CA. While there may be a way to get this to work, and this may be required in some situations for security or for compatibility with other systems, the quickest solution is to upgrade to PHP v5.2
Note that this uses the centos-testing repo, and as such it is not guaranteed stable or safe, make sure that you know what you are doing before deploying this.
Follow instructions here: http://wiki.centos.org/HowTos/PHP_5.1_To_5.2
From here, this guide runs in parallel with the main installation page Installing_Providence
I ended up running:
yum install ImageMagick yum install dcraw yum install abiword yum install gd gd-devel php-gd
then following the (interpreted) instructions on http://www.matteomattei.com/en/install-imagemagick-with-php-imagick-extension-on-centos/
yum install ImageMagick-devel yum install php-pear yum install php-devel yum install gcc pecl install imagick
Several changes are required to the php config file. Edit or add lines such that these values are defined, other values may better suit your situation.
extension=imagick.so upload_max_filesize = 96M memory_limit = 128M post_max_size = 96M
Create a database and mysql user using webmin
This should be way outside the scope of this page, but it's here in case someone benefits from it anyway:
- create a database
- create a user with no privs (but with a password, and restricted to "localhost")
- then create a "database permission" that maps the 2 together, also limited to "localhost"
Final bits before installing
For the normal installation method you need SVN installed:
yum install mod_dav_svn subversion
You will need php-mysql
yum install php-mysql
You will need to create a directory; fill it and set the privs
mkdir /var/www/html/ca cd /var/www/html/ca svn checkout http://collectiveaccess.svn.whirl-i-gig.com/CollectiveAccess/trunk mv trunk/* . chgrp –R apache .
Create and edit the setup.php file:
cp setup.php-dist setup.php nano setup.php
You can then go ahead and run the installer by browsing to setup.php
Reactions to errors
yum install php-mbstring
There was also a problem with PCRE unicode stuff, this is discussed here: http://chrisjean.com/2009/01/31/unicode-support-on-centos-52-with-php-and-pcre/ and if you trust totally third party addons, can be summarised down to the following (the alternatives look ugly and involve recompiling things).
wget http://chrisjean.com/wp-content/uploads/2009/01/pcre-66-27x86_64.rpm sudo rpm -Uvh pcre-6.6-2.7.x86_64.rpm
With the coming of XML, the above procedure will fall over at the start of the installation with cryptic messages like "PHP Fatal error: Class ‘DOMDocument’ not found in ..."
to solve this, run:
yum install php-xml
then restart apache (in webmin>apache click the apply changes link in the top right)
The installation for pawtucket can now be run as described without a hitch. Installing_Pawtucket