INSTALL.en.md

This procedure is meant for Ubuntu et Debian GNU/Linux

Necessary packages :

Ubuntu Trusty

apt-get install python-software-properties php5 php5-gd php5-imagick php5-xdebug php-pear php5-mysql php5-xhprof graphviz apache2 mysql-server libapache2-mod-php5 git php5-mcrypt php5-curl yaz

Debian Wheezy

apt-get install php5 php5-gd php5-imagick php5-xdebug php-pear php5-mysql graphviz apache2 mysql-server libapache2-mod-php5 git php5-mcrypt php5-curl yaz

ArchLinux

yaourt -S php php-gd php-imagick xdebug php-pear apache mysql php-apache php-xhprof graphviz git

CentOS

rpm -Uvh http://repo.webtatic.com/yum/el6/latest.rpm
yum install php54w php54w-gd php54w-pear php54w-mysql php54w-pecl-xdebug php54w-xml php54w-soap php54w-mbstring

You need to build Imagick extension from scratch

Install PHPUnit (Account root / sudo):

  cd /usr/local/bin
  wget https://phar.phpunit.de/phpunit.phar
  mv phpunit.phar phpunit

Downloading source code

cd /var/www
git clone http://git.afi-sa.fr/afi/opacce.git opacce

Launch update.sh script

cd opacce
./update.sh

Apache / PHP Configuration:

Activate the following modules :

Debian

a2enmod headers rewrite php5

ArchLinux:

Modify /etc/httpd/conf/http.conf and add the line:

LoadModule php5_module modules/libphp5.so

Activate mod_mpm_prefork (see https://wiki.archlinux.org/index.php/Apache_HTTP_Server#PHP).

Deactivate negotiation module which is in conflict with Zend Framework on index/index urls:

a2dismod negotiation

Configure PHP

In /etc/php5/apache2/php.ini (ArchLinux: /etc/php/php.ini), configure the following variables:

post_max_size = 10M
upload_max_filesize = 10M
error_reporting  =  E_ALL & ~E_NOTICE & ~E_DEPRECATED

Activate the following extensions if they are not already actived (they should be):

php5enmod calendar curl gd gettext iconv mcrypt mysql pdo_mysql openssl soap imagick

On Archinux uncomment the corresponding lines.

Configure Apache

In Apache conf, delete indexes option (file list) and authorise .htaccess:

<Directory /var/www/>
  Options FollowSymLinks
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>

Warning: For apache 2.4

<Directory /var/www/>
  Options FollowSymLinks
  AllowOverride All
  Require all granted
</Directory>

User rights on temp folder

chmod -R 777 opacce/temp

MySQL config

Finalise the installation (ArchLinux)

See https://wiki.archlinux.org/index.php/MySQL#Installation

Configuration

Edit /etc/mysql/my.cnf and add to the [mysqld] section the following line (in order to force fulltext indexation from the first letter)

ft_min_word_len = 1

Restart mysql.

Warning: If you have encoding problems, in Cosmogramme, you can force UTF8 like this:

skip-character-set-client-handshake
character-set-server=utf8

Connect to mysql and import the database schema

mysql -uroot -ppass
mysql> create database opac;
mysql> connect opac;
mysql> source opacce/scripts/opac2.sql;

OPAC Config

In the opacce directory, copy and configure

cp config.ini.default config.ini
touch local.php

Cosmogramme Config

In the cosmogramme folder, copy and configure

cp config.ref.php config.php 

go to http://localhost/opacce/cosmogramme

connnect with the account admin/achanger and click on the patch update link

Connect to the opac

Use the account compte admin/achanger go to http://localhost/opacce/admin

To run the tests:

cd opacce/tests/
phpunit