= Installation de Clariprint =

== Arborescence ==

Clariprint s'installe dans le dossier /usr/local/clariprint/

Un dossier est créé par "plateforme", par défaut c'est la plateforme nommée "prod" :

/usr/local/clariprint/prod

Dans ce dossier on va retrouver :
 * /bin : les binaires applicatifs
 * /wcl : les fichiers d'interface interprétés, la racine du du site web
 * /config : des fichiers de configuration, notamment apache.
 * /fonts : configuration des polices utilisées par le générateur PDF
 * /locale : fichier de descriptions des langues. Doit être accessible en lecture/écriture par le serveur web (www-data ou _www ou apache suivant distributions).
 * /logs : contient les logs des applications (r/w par apache)
 * /sbin : utilitaires d'administrations
 * /scripts : fichiers de configuration pour les services linux
 * /services : idem /scripts
 * /templates : templates de mail
 * /tmp : contient les sessions (rw apache)


Un dossier contiendra l'ensemble des configuration des différentes plateformes :

/usr/local/clariprint/conf

== Installation fichiers ==

 * création des dossiers de base :
  * mkdir /usr/local/clariprint
  * mkdir /usr/local/clariprint/conf
 * Décompression du distrib_clariprint.tgz
  * tar -zxf distrib_clariprint.tgz  (peut varier suivant les plateformes, ex distrib_clariprint_debian7.tgz)
  * mv distrib_clariprint /usr/local/clariprint/prod

 * creation des dossier temporaires
  * mkdir -f  /usr/local/clariprint/prod/tmp /usr/local/clariprint/prod/logs
 * permissions :
  * chown -r www-data /usr/local/clariprint/prod/tmp /usr/local/clariprint/prod/logs /usr/local/clariprint/prod/locate 




== Configuration des services == 
=== Clariprint Solver ===
 * Installation du fichier de service 
  * ln -s /usr/local/clariprint/prod/service/solver /etc/init.d/clariprint.solver.prod
 * S'assurer que le script se lance au démarrage (ici debian)
  * update-rc.d  clariprint.solver.prod defaults 
 * lancer le serveur :
  * /etc/init.d/clariprint.solver.prod start

=== Nettoyage des fichiers temporaires ===
 * ln -s /usr/local/clariprint/prod/sbin/clariprint.cron /etc/cron.daily/clariprint.prod.cron

=== Rotation des logs ===
 * ln -s /usr/local/clariprint/prod/scripts/logrotate.cnf /etc/logrotate.d/clariprint

== Configuration Apache ==

 * cp /usr/local/clariprint/prod/config/httpd.conf /usr/local/clariprint/conf/http_prod.conf
 * modifier /usr/local/clariprint/conf/httpd_prod.conf au besoin (base de données.. host name) 
 * Ajouter les fichiers à Apache
  * ln -s /usr/local/clariprint/conf/httpd_prod.conf /etc/apache2/sites-enabled/clariprint_prod.conf
 * relancer apache
  * apapche2ctl restart


== Éléments importants ==
 * le serveur doit resoudre correctement son hostname. Si vous utilisez un répartiteur de charge ou une passerelle, la serveur doit tout de même résoudre son nom par 127.0.0.1 (modifiez le /etc/hosts en conséquence)