Prérequis

Avant de démarrer l'installation de PLOOPI, vous devez vérifier que vous disposez des éléments suivants :

Apache 2.x
PHP 5.x
MySQL 5.x

si ce n'est pas le cas, vous devez les installer (avec l'utilisateur root) :

apt-get install apache2 mysql-server php5

Certaines extensions de php sont également nécessaires :

php5-mysql
php5-mcrypt
php5-gd
php5-dev
php-pear

Pour cela exécutez la commande suivante :

apt-get install php5-mysql php5-gd php5-cli php5-mcrypt php-pear php5-dev make

Vous devez ensuite mettre à jour la librairie PEAR et installer les classes requises par le portail :

pear upgrade-all
pear install --alldeps Cache_Lite HTTP_Request XML_Feed_Parser Xml_Beautifier OLE-0.6.1 Spreadsheet_Excel_Writer-0.9.1 PEAR_info Net_UserAgent_Detect
pecl install stem

Si vous êtes derrière un proxy, vous devez configurer pear pour utiliser les paramètres de votre proxy

pear config-set http_proxy http://login:password@ip_du_proxy:port_du_proxy

Si vous souhaitez utiliser de manière optimale la gestion des documents, vous devez également installer les outils pour l'extraction des contenus

apt-get install catdoc xpdf-utils jhead unrtf unzip zip

Paramétrage Apache/PHP

PHP

Le module pecl/stem n'est pas chargé par défaut avec php. Pour charger stem, créez par exemple un fichier stem.ini dans /etc/php5/conf.d

nano /etc/php5/conf.d/stem.ini

et copiez/collez le contenu suivant :

# configuration for pecl stem module
extension=stem.so

Ensuite, modifiez dans le fichier de configuration de PHP la configuration des magic quotes :

nano /etc/php5/apache2/php.ini

mettez :

magic_quotes_gpc = Off

En option (surtout pour le module gestion de documents et le moteur d'indexation), toujours dans php.ini :

memory_limit = 128M
post_max_size = 16M
upload_max_filesize = 16M

En option également, paramétrez correctement le fuseau horaire par défaut (sinon php vous renvoie Europe/Berlin) :

date.timezone = Europe/Paris

Apache

Editez le fichier de configuration d'Apache

nano /etc/apache2/apache2.conf

et décommenter la ligne :

AddDefaultCharset ISO-8859-15

Activez le module "rewrite"

ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled

Installation de Ploopi

Méthode 1 (recommandée) : téléchargement d'une archive

Téléchargez la dernière version de Ploopi (au format tar.bz2)

Copiez le contenu de l'archive dans votre dossier web :

tar jxvf ploopi_x.x.tar.bz2
mv ploopi_x.x /var/www/monploopi

Méthode 2 (testeurs) : téléchargement depuis le dépôt subversion

Si vous n'avez pas le client svn, vous devez d'abord l'installer :

apt-get install subversion

Puis utilisez svn pour télécharger la dernière version :

svn export http://svn.ploopi.org/trunk /var/www/monploopi --force

Enfin, renommez le fichier .htaccess_modele en .htaccess

mv /var/www/monploopi/.htaccess_modele /var/www/monploopi/.htaccess

Vérification des droits sur le système de fichiers

Vérifiez les droits d'accès en lecture/écriture pour le processus apache.
L'idéal est d'appliquer les règles suivantes (en root) :

cd /var/www/monploopi/
chown -R www-data:www-data .
find . -type d | xargs chmod 500
find . -type f | xargs chmod 400
find {data,config,modules} -type d | xargs chmod 700
find {data,config,modules} -type f | xargs chmod 600
find bin -type f | xargs chmod 500
chmod 500 ./cgi/upload.cgi

Création d'un VirtualHost sur Apache

Pour cela vous pouvez ajouter un fichier dans /etc/apache2/sites-available/ :

nano /etc/apache2/sites-available/ploopi

ensuite insérez les lignes suivantes :

<VirtualHost *>
        ServerName monploopi

        DocumentRoot /var/www/monploopi/

        <Directory /var/www/monploopi/>
                AllowOverride All
        </Directory>

        # config CGI
        ScriptAlias /cgi/ /var/www/monploopi/cgi/
        <Directory "/var/www/monploopi/cgi/">
                AllowOverride None
                Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
                Order allow,deny
                Allow from all
        </Directory>
</VirtualHost>

La configuration CGI est optionnelle. Elle permet d'uploader des fichiers sans limite de taille et avec une barre de progression. Cette fonctionnalité est désactivée par défaut sur le portail.

Si vous souhaitez utiliser cette option, il est par contre nécessaire de disposer de l'interpréteur php en ligne de commande (paquet php5-cli)

apt-get install php5-cli

Pour terminer, il faut activer le virtualhost...

ln -s /etc/apache2/sites-available/ploopi /etc/apache2/sites-enabled/000-ploopi

... puis recharger le fichier de configuration

/etc/init.d/apache2 reload

Premier démarrage

Si vous utilisez un VirtualHost, éditez le fichier hosts de votre machine (pas le serveur !) pour ajouter le nom du host que vous avez donné au VirtualHost. Sous linux editez le fichier /etc/hosts :

nano /etc/hosts

et ajoutez la ligne suivante :

[ip de votre serveur] monploopi

Ouvrez ensuite un navigateur à l'adresse http://monploopi/

Vous pouvez également ne pas utiliser de VirtualHost. Dans ce cas, ouvrez un navigateur à l'adresse http://monserveur/monploopi/

Vous devriez arriver sur la page d'installation du portail.

Suivez ensuite les étapes une à une. Les paramètres par défaut sont en général suffisant. Les points rouges indiquent des problèmes de paramétrage.

Lorsque l'installation est terminée, il est fortement recommandé de supprimer le fichier ./config/install.php et de modifier les droits d'écriture pour apache sur le dossier ./config

rm -rf ./config/install.php
find config -type d | xargs chmod 500
find config -type f | xargs chmod 400

Configuration .htaccess

Un fichier .htaccess est inclus à la racine de Ploopi.
Il peut être nécessaire de d'adapter le fichier .htaccess à votre configuration.

Notamment la directive RewriteBase qui doit être adapté au dossier contenant ploopi.

Si vous utilisez un VirtualHost vous pouvez laisser la configuration par défaut.

Si vous utilisez ploopi en sous dossier d'un site existant, indiquez le chemin relatif de ce dossier dans la directive RewriteBase.

RewriteBase /monploopi/

Articles