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