CentOS 5.5 installation instructions

From CollectiveAccess Documentation
Jump to: navigation, search

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.


Initial configuration:

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

Install EPEL as http://fedoraproject.org/wiki/EPEL/FAQ#How_can_I_install_the_packages_from_the_EPEL_software_repository.3F

Installed RPMforge as http://wiki.centos.org/AdditionalResources/Repositories/RPMForge

to update all packages

yum update

PHP Version

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

Addons

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 

Php.ini

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

Database

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:

  1. create a database
  2. create a user with no privs (but with a password, and restricted to "localhost")
  3. 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

XML compatibility

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)

Pawtucket

The installation for pawtucket can now be run as described without a hitch. Installing_Pawtucket

i_sphinx

Namespaces

Variants
Actions
Navigation
Tools
User
Personal tools