INSTALL.en.md

This procedure is meant for Ubuntu et Debian GNU/Linux

Necessary packages :

Ubuntu

Requirements: Bokeh needs PHP 5.4 which is not present by default in ubuntu. Repository must be declared below with the last version of php:

apt-get install python-software-properties
add-apt-repository ppa:ondrej/php5
apt-get update
apt-get install php5 php5-gd php5-imagick php5-xdebug php-pear php5-mysql php5-xhprof graphviz apache2 mysql-server libapache2-mod-php5 subversion php5-mcrypt

Debian

apt-get install php5 php5-gd php5-imagick php5-xdebug php-pear php5-mysql php5-xhprof graphviz apache2 mysql-server libapache2-mod-php5 subversion php5-mcrypt

ArchLinux

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

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

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: calendar, curl, gd, gettext, iconv, mcrypt, mysql, pdo_mysql, openssl, soap, imagick

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

Modifier /etc/mysql/my.cnf et ajouter dans la section et forcer l'indexation fulltext à partir de 1 lettre dans la section [mysqld]

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 db 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