[[PageOutline]]
= FAQ Technique =

== Installation / configuration ==

=== Ou est installé Clariprint ===

Clariprint est installé par défaut dans : 

/usr/local/clariprint/[plateforme]

Plateforme étant choisi au moment de l'installation. Généralement  "prod" est utilisé.

=== Comment installer à partir d'un package TGZ. ===
 * decompresser l'archive tgz (tar -zxf distrib_clariprint.tgz)
 * se placer dans le dossier (cd distrib_clariprint)
 * executer le script ./sbin/clariprint_update.sh [nom plateforme] ( ./sbin/clariprint_update.sh prod)
 * verifier les permissions (dépendantes de la plateformes, sur debian www-data) 
  * l'utilisateur web (www-data) doit avoir accès en lecture écriture sur les répertoire "locale"  (/usr/local/clariprint/[plateforme]/locale) et "tmp"
 * relancer le serveur apache (apacectl restant ou apache2ctl restart)
 * lancer les service de calcul /etc/init.d/clariprint.solver.[plateforme] start

 * se connecter à Clariprint en super administrateur (Clariprint fait automatiquement les mise à jour de la base de donnée) : 
  * cliquez sur l'icône Administration à partir de l'accueil (mise à jour de la base clariprint)
  * cliquez sur l'icône optimProcess à partir de l'accueil (mise à jour de la base clariprint_optimprocess)
  * cliquez sur l'icône optimPaper à partir de l'accueil (mise à jour de la base clariprint_optimpaper)
  * cliquez sur l'icône optimProject à partir de l'accueil (mise à jour de la base clariprint_optimproject)

=== Le procédure de mise à jour fait-elle une sauvegarde ? ===
La procédure de mise à jour fait une copie des fichiers de l'application, mais ne fait pas de sauvegarde des données.

Les fichiers sont copiés dans un dossier :

{{{ /usr/local/clariprint/[plateforme]-[date] }}}


=== Restaurer une version précédant ===
{{{
# Arret du service

/etc/init.d/clariprint.solver.[plateforme] stop

# renommer le dossier actuel
mv   /usr/local/clariprint/[plateforme]   /usr/local/clariprint/[plateforme]_back

# renommer le dossier sauvegarde en dossier actuel
mv   /usr/local/clariprint/[plateforme]-[date]   /usr/local/clariprint/[plateforme]

# relancer le service 
/etc/init.d/clariprint.solver.[plateforme] start

# relacer Apache 

apachectl restart ou apach2ctl restart
}}}

Attention : Nous assurons une compatibilité ascendante. Une ancienne version de Clariprint peut ne pas lire des données générées avec une version plus récente.

=== Sauvegarde des données ===

Nous vous invitons à consulter la documentation du serveur de donnée Mysql pour faire une sauvegarde. Sauf configuration spécifiques les base utilisées sont nommées :
 * clariprint
 * clariprint_optimproject
 * clariprint_optimprocess
 * clariprint_optimpaper


== Maintenance ==
=== Services === 

Clariprint utilise des services tiers : Apache et Mysql.
Clariprint met en place un seul service : opSolverWcl. Ce service se lance via un script : /etc/init.d/clariprint.solver.[plateforme]

 * Lancer/stoper le service manuellement : {{{/etc/init.d/clariprint.solver.[plateforme] start|stop}}}
 * Ajouter le service au démarrage auto :  {{{update-rc.d -f clariprint.solver.[plateforme]  defaults}}}
 * Vérifier si le écrit est bien installe pour le démarrage : {{{ls -al /etc/rc5.d | grep clariprint}}}

=== Fichiers temporaires ===

Clariprint produit 3 types de fichier temporaires.
==== Sessions ====
Les fichiers *.session se trouvent dans le répertoire /usr/local/clariprint/[plateforme]/tmp. Il n'y a que peu de risque de problèmse de fonctionnement avec ces fichiers. Il est souhaitable cependant de procéder régulièrement à leur nettoyage.

 * Script de nettoyage :  {{{/usr/local/clariprint/[plateforme]/sbin/clean_temp_files.sh}}}
 * Ajout du script au cron journalier : {{{/usr/local/clariprint/[plateforme]/sbin/clean_temp_files.sh /etc/cron.daily/clariprint.clean.[plateforme]}}}
 * Pour les supprimer tous : {{{ find /usr/local/clariprint -name "*.session" --exec rm -f {} \; }}} (attention celé peut produire des dysfonctionnement pour les utilisateurs connectés.


==== Logs Solver ====
Les fichiers WCL*.log se trouvent dans le répertoire tmp ou lors de la plateforme /usr/local/clariprint/[plateforme]/

Le niveau du log solder se définit dans le fichier service.conf (/usr/local/clariprint/[plateforme]/config/services.conf)

{{{ SOLVER_VERBOSE=" -v -2000 " }}}

Plus le niveau est bas, moins le système fournis de trace en production, nous préconisons -2000

Pour prendre en compte les changement, il faut france le service de calcul :
{{{ /etc/init.d/clariprint.solver.[plateforme] restart }}}

  Si le log solver dépasse les 2Go, le système devient instable


==== Logs Applications ====
Les fichiers WCL*.log se trouvent dans le répertoire tmp ou lors de la plateforme /usr/local/clariprint/[plateforme]/

Le niveau du log solder se définit dans le fichier de config Apache /usr/local/clariprint/[platefrome]/config/clariprint.conf

C'est le paramètre suivant l'option -v :
{{{ WclCommand	$(CLARIPRINT_HOME)/bin/$(BINARY) -v -100 -auto -s 8 1 -wcl }}}


==== Rotate  Log ====

Nous préconisons la mise en place d'un rotateurs log pour éviter que les log finissent par atteindre la taille maximale.

Créez un fichier /etc/logrotate.d/clariprint.[plateforme] :

{{{
/usr/local/clariprint/___ plateforme___/logs/*.log
{
	daily
	missingok
	rotate 7
	compress
	delaycompress
	sharedscripts
	postrotate
	/etc/init.d/apache2 reload > /dev/null
	endscript
}

/usr/local/clariprint/___ plateforme___/tmp/*.log
{
        daily
        missingok
        rotate 7
        compress
        delaycompress
        sharedscripts
}
}}}

 Vérifiez que le fichier global de configuration de logrotate soit bien en mode daily  {{{/etc/logrotate.conf}}}


== Fonctionnement ==


=== La sélection papier ne fonctionne pas : listes vides ===
 * Verifier que les DNS sont bien configurée : le serveur doit connaitre son nom.
  * soit changer la configuration des DNS
  * soit completer le fichiers /etc/hosts avec le nom complet de la machine pour 127.0.0.1
 
=== Erreur lors de la mise à jour des traductions ===
 * vérifier que l'utilisateur web a les droits d'écriture sur le dossier locale de l'installations  /usr/local/clariprint/[plateforme|prod]/locale
  * debian : www-data      soit   ''chown -R www-data /usr/local/clariprint/prod/locale''   pour l'installation standard
  * centos  : apache
  * macosx : _www