Skip to content

Manuel d'installation de BlueCourrier

Introduction

Contexte

Ce document détaille l'ensemble des manipulations nécessaires à l'installation de BlueCourrier et des composants associés.

Objectif

L'objectif de ce document est de présenter les opérations nécessaires à la mise en place des différents composants du projet à partir d'un environnement vierge. Ce document s'adresse aux équipes techniques des clients de BlueCourrier.

Installation

BlueDolmen peut être installé manuellement. Cependant, des installateurs sont disponibles pour effectuer une installation rapide.

Installation rapide (Windows)

L'installation peut être réalisée rapidement grâce au programme d'installation que vous pouvez télécharger :

  • soit à partir de la page d'accueil de BlueDolmen.com
  • soit à partir du site support si vous avez une souscription

Attention, n'oubliez pas d'installer préalablement Alfresco. La vidéo ci-dessous décrit l'ensemble de la procédure d'installation : Alfresco + BlueDolmen.

Installation manuelle

C'est méthode est la seule façon d'installer Blue Courrier pour Linux, Mac ou sur une instance alfresco existante (Windows, Linux ou Mac).

Cette ne nécessite pas de compétences techniques particulières mais doit être suivie avec attention. Elle vous permet en outre de mieux comprendre les éléments mis en oeuvre pour BlueCourrier.

BlueCourrier repose sur Alfresco et ExtJS qui doivent donc être installés préalablement.

Pour la signature électronique, actuellement en version beta et non supportée par BlueDolmen, le logiciel Ghostscript fourni avec Alfresco est réutilisé.

Prérequis

Alfresco

BlueCourrier repose sur Alfresco.

BlueCourrier 2.1-alf5.0 peut fonctionner avec Alfresco Enterprise 5.x ou Alfresco Community 5.x (Alfresco Community 2017XX).

Récupération du logiciel Alfresco 5.x

  • Téléchargez l'un des 2 packages suivants :
    • Alfresco Enterprise Edition depuis votre compte Alfresco Support
    • Alfresco Community Edition 5.x ou 2017XX depuis le site SourceForge comme indiqué ci-dessous

Les liens ci-dessous pointent sur la version 5.0.d d'Alfresco. Nous vous invitons à tester et utiliser Alfresco sur des versions plus récentes et à nous faire part de vos succès et dificultés sur les forums.

Windows 64 bits
Linux
MacOS X

Installation d'Alfresco

Quel que soit le système d'exploitation ou la version d'Alfresco utilisé, le processus d'installation est le même. La seule exception concerne les options de démarrage qui peuvent varier selon que vous êtes sur Windows ou MacOSX/Linux.

  • Double-cliquez sur l'archive que vous avez récupérée et cliquez sur Suivant/Next jusqu'au bout ;
  • Une fois Alfresco installé (2 à 5 minutes selon votre poste), Alfresco vous propose de démarrer ;
  • Démarrez Alfresco pour finaliser l'installation d'Alfresco ;
  • Stoppez le serveur tomcat hébergeant Alfresco ;
Arrêter Alfresco sous Windows

Il arrive de temps en temps que le service pour arrêter Alfresco via l'outil Services ne fonctionne pas. Dans ce cas, il est possible de lancer une console en tant qu'Administrateur pour arrêter le service.

Pour lancer une console en tant qu'Adminsitrateur :

  • Cliquez sur l'icône Start/Démarrer
  • Tapez cmd dans la zone de recherche
  • Le programme cmd apparaît
  • Faites un clic droit et sélectionnez l'action "Exécuter en tant qu'Administrateur"
  • Une console se lance en tant qu'administrateur

Vous pouvez alors taper les commandes suivantes :

    sc queryex alfrescoTomcat

Vous obtenez alors des informations sur le service correspondant, notamment son numéro de processus ou PID. Il suffit alors de taper la commande suivante :

    taskkill.exe /f /pid PID

où PID est le numéro de PID récupéré précédemment.

Il faut maintenant installer les autres prérequis de Blue Courrier.

ExtJS 4.2.1

Le processus d'installation est le même quel que soit votre système d'exploitation.

Récupération du logiciel ExtJS

  • Téléchargez extjs.war. Cette version d'extjs est la version open source 4.2.1, développée par Sencha, que vous pouvez récupérer :

Il est possible de récupérer la version ExtJS-4.2.1 (http://cdn.sencha.com/downloads/docs/extjs-docs-4.2.1.zip) depuis le site de sencha mais il faut alors la repackager.

Installation d'ExtJS

  • Copiez le fichier téléchargé extjs.war dans le répertoire tomcat/webapps de votre installation d'alfresco

Installation, configuration et initialisation de BlueCourrier

Les prérequis étant installés, il ne vous reste plus qu'à installer Blue Courrier.

Récupération du logiciel BlueCourrier

Installation de BlueCourrier

  • Arrêtez Alfresco

  • Allez dans le répertoire tomcat où vous avez installé Alfresco cd /opt/alfresco/alfresco-community-5.0.d

  • Extrayez les fichiers de BlueCourrier à l'aide de la commande suivante : tar xzvf webapps-bluecourrier-2.1-alf5.0-77588.tar.gz

Les modules amps et amps_share ont été copiés dans leurs répertoires respectifs.

Il suffit alors de relancer la construction des webapps alfresco en exécutant la commande suivante :

    ./bin/apply-amps.bat (pour Windows)
    ./bin/apply-amps.sh (pour Linux et Mac)

En fonction des modules que vous avez installés préalablement, le système va reconstruire les fichiers alfresco.war et share.war à partir des fichiers présents dans les répertoires amps, amps_share et des webapps alfresco.war et share.war. En outre, les webapps déployées (tomcat/webapps/alfresco et tomcat/webapps/share) seront supprimées.

Cela a pour conséquence de supprimer toutes les adaptations que vous auriez pu faire en direct dans les webapps sans respecter les bonnes pratiques préconisées par Alfresco.

Une fois la commande précédente terminée, relancez Alfresco. Les webapps alfresco.war et share.war seront alors déployées.

Pour vérifier que l'installattion s'est déroulée correctement, le fichier bluecourrier-repo-2.1-alf5.X.jar doit se trouver à l'endroit suivant, depuis la racine de votre installation Alfresco :

* tomcat/webapps/alfresco/WEB-INF/lib/bluecourrier-repo-2.1-alf5.0.jar

Si ce n'est pas le cas, l'installation a vraisemblablement rencontré un problème. Repartez de l'installation d'Alfresco et recommencez ou venez sur nos forums décrire votre problème et votre contexte, nous vous aiderons dans votre diagnostic.

Configuration de BlueCourrier

alfresco-global.properties

  • Modifiez le fichier tomcat/shared/classes/alfresco-global.properties pour refléter votre configuration en ajoutant les lignes suivantes en début de fichier :
    # Be careful to uncomment only ONE gs.exe at a time:
# On Windows
gs.exe=C:/opt/gs/gs9.18/bin/gs918win64c.exe 
# On MacOS X avec homebrew
# gs.exe=/usr/local/bin/gs
# On Linux/Debian
# gs.exe=/usr/bin/gs

ds.worker.remote.enableUnsecureCommunication=true

share-config-custom.xml

  • Modifiez le fichier tomcat/shared/classes/web-extension/share-config-custom.xml en désactivant la configuration CSRF afin d'obtenir les lignes suivantes :
    <!-- Disable the CSRF Token Filter -->
<config evaluator="string-compare" condition="CSRFPolicy" replace="true">
    <filter/>
</config>

Attention, cette configuration n'est à désactiver que pour une installation en développement ou en test. Pour une installation en production, nous vous invitons à vous rapprocher de vos équipes d'exploitation.

Test

  • Relancez le serveur Alfresco

Une fois que le serveur Alfresco est lancé :

Après avoir affiché une erreur due à l'absence de la licence, BlueCourrier apparaît. Il n'est pas possible d'injecter de courrier car la licence n'est pas installée.

Installation de la licence BlueCourrier

Une fois installé BlueCourrier, il est possible de finaliser l'installation en configurant la licence.

Allez sur votre installation de BlueCourrier à l'adresse suivante :

  • http://VOTRE_SERVEUR:PORT/share/page/yamma
  • Connectez-vous en tant qu'administrateur
  • Cliquez en haut à droite sur votre nom d'utilisateur (administrateur)
  • Cliquez sur A Propos. Une fenêtre s'affiche avec un menu à droite intitulé Licence
  • Cliquez sur le menu Licence puis sur l'action 'Mettre à jour'
  • Téléchargez la licence qui vous a été fournie dans votre site BlueDolmen Partner Support :
    • Allez dans le répertoire Licences et récupérez le fichier licence-enc-VotreOrg-YYYY-MM-DD.txt
  • Le système vous indique qu'il faut recharger BlueCourrier (seulement au niveau du navigateur)

Après avoir rechargé BlueCourrier dans votre navigateur, retournez dans la fenêtre A Propos. Votre licence doit apparaître avec les informations suivantes :

  • Bénéficiaire
  • Date d'expiration
  • Identifiant de licence

Introduction

Tous les éléments sont installés et configurés, vous pouvez donc maintenant tester votre installation.

Ce document liste les actions à réaliser pour :

  • déposer un courrier numérisé, reçu d’un citoyen ;
  • assigner le traitement du courrier à un agent ;
  • traiter le courrier en déposant la réponse de l’organisation ;
  • superviser le traitement des courriers.

Pour vous connecter, allez sur votre instance BlueCourrier :

Utilisateurs

Direction: Secrétariat Général Prénom: Béatrice Nom: ROBIN Assistant: x Instructeur: x Manager: Superviseur: Login: brobin Passwd: brobin

Direction: Secrétariat Général Prénom: Jean-Charles Nom: BRIAND Assistant: Instructeur: x Manager: Superviseur: x Login: jcbriand Passwd: jcbriand

Direction: Service Courrier Prénom: Pierre Nom: ROBINET Assistant: x Instructeur: x Manager: Superviseur: Login: probinet Passwd: probinet

Direction: Service Courrier Prénom: Hélène Nom: MARTIN Assistant: Instructeur: x Manager: x Superviseur: Login: hmartin Passwd: hmartin

Direction: Service Population Prénom: Nom: Assistant: Instructeur: Manager: Superviseur: Login: Passwd:

Direction: Service Population Prénom: Vincent Nom: TABOUI Assistant: Instructeur: x Manager: Superviseur: Login: vtaboui Passwd: vtaboui

Direction: Service Population Prénom: Jean-Charles Nom: BRIAND Assistant: Instructeur: Manager: Superviseur: x Login: jcbriand Passwd: jcbriand

Connectez-vous alors avec les identifiants indiqués (probinet/probinet par exemple signifiant Nom d’utilisateur : probinet, Mot de passe : probinet)

Dépôt d’un courrier numérisé

Service Courrier

Connexion en tant que Pierre ROBINET (assistant, probinet/probinet)

Ajout d'un courrier
  • Cliquer sur le nuage en haut à droite ;
  • Dépôt du courrier UC1-C1.pdf : Demande d’une place en crèche ;
  • Double-clic sur le courrier : la fenêtre de prévisualisation apparaît ;
Indexation (renseignement des métadonnées)
  • Cliquer sur l’onglet Métadonnées : le formulaire apparaît ;
  • Sélection dans la fenêtre de prévisualisation de l’objet du courrier ;
  • Copier/Coller de la sélection précédente dans le champ objet du courrier (remplacement du ‘d’ initial par ‘D’) ;
  • Modification de la date de rédaction en 13/02/2014 ;
  • Modification de la date d’envoi en 15/02/2014 ;
  • Modification de la date de réception en 20/02/2014 ;
  • Modification de la date d’échéance en 20/03/2014 ;
  • Cliquer sur le bouton Enregistrer en bas du formulaire : les informations se mettent à jour. La date d’échéance apparaît en rouge car elle est dépassée ;
Distribution
  • Cliquer sur l’action ‘Distribution aux services’ ;
  • Sélectionner le type de traitement : Traitement ;
  • Sélectionner le circuit : Avec validation ;
  • Cliquer 2 fois sur service Population pour choisir l’action ‘Service de traitement destination’ ;
  • Cliquer sur ‘Enregistrer’ ;
  • Cliquer sur l’action ‘Démarrer les distribution’ (icône Camion).

Le courrier est mis à disposition du service courrier et peut être validé par le manager

Connexion en tant que Hélène MARTIN (manager, hmartin/hmartin)

Distribution
  • Cliquer sur l’action ‘Valider la distribution’ ;
  • Cliquer sur le bouton Distribuer.

Assignation du traitement

Service Population

Connexion en tant que Charlotte MAIGRET (assistante, cmaigret/cmaigret)

  • Cliquer sur l’action ‘Assignation du traitement un instructeur’ ;
  • Sélectionner Vincent TABOUI.

Traitement

Service Population

Connexion en tant que Vincent TABOUI (instructeur, vtaboui/vtaboui)

Acceptation du traitement et ajout d'une réponse
  • Cliquer sur l’action ‘Accepter le traitement’ ;
  • Cliquer sur l’action ‘Ajouter un fichier réponse’ ;
  • Sélectionner fichier local : dépôt de UC1-C1-R1.pdf : Réponse à la demande de place en crèche ;
Mise en validation
  • Cliquer sur l’action ‘Transmettre pour validation’ ;
  • Saisir ‘Emma’ ;
  • Sélectionner l’agent Emmanuel LE GAREC qui apparaît. C’est le responsable du service Population ;
  • Cliquer sur Lancer.

Connexion en tant que Emmanuel LE GAREC (man&ger, elegarec/elegarec)

  • Cliquer sur l’action ‘Valider le courrier sortant’ ;
  • Cliquer sur Accepter.

Connexion en tant que Charlotte MAIGRET (assistante, cmaigret/cmaigret)

  • Cliquer sur l’action ‘Marquer comme envoyé’
  • Le courrier est considéré comme envoyé

Annexes

Les guides d'installations proposés en annexes sont des exemples d'installations réalisées sur un projet BlueCourrier.

Installation et configuration d’AFC sur le serveur (Source document Abbyy)

Extraction des fichiers d’installation

  • Récupérez le fichier d’installation d’AFC ;
  • Lancez l'exécutable ;
  • Sélectionnez un répertoire où extraire les fichiers d’installation ;
  • Lancez l'extraction.

Installation des composants Serveur

  • Rendez-vous dans le répertoire ou se trouve les fichiers d’installation ;
  • Lancez le programme d'installation ;
  • Sélectionnez « Installation distribuée » ;
  • Sélectionnez « Installer les serveurs » ;
  • Sélectionnez la langue d’installation ;
  • Le programme va vérifier les pré-requis ainsi que les droits ;
  • Acceptez la licence d’utilisateur final ;
  • Entrez les informations d’utilisateur vous concernant ;
  • Sélectionnez les composants suivants à installer :
    • Serveur de traitement,
    • Serveur d’application,

Le programme vérifie ensuite la présence de framework .Net ; Les éléments sélectionnés sont ensuite installés sur la machine ; Une fois l’installation terminée le programme de gestion de licence est démarré de manière automatique.

Configuration

Activation de la licence

  • Cliquez le bouton « Activer la licence » ;
  • Entrez le numéro de licence dans les champs textes prévus à cet effet ;
  • Cliquez sur suivant ;
  • Sélectionnez votre méthode d'activation de la licence et suivre les consignes ;
  • Une fois la licence activée, assurez-vous qu'elle est sélectionnée (coche de couleur verte à côté du numéro de série).

Configuration de la base de donnée

  • Accédez à la console d'administration via le menu démarrer :

    «  Programmes > Serveur ABBYY FlexiCapture > Console d'administration et de suivi »

  • Une fenêtre Internet Explorer se lance et affiche l'interface d'administration d'AFC ;

    Lors d'un premier accès vous arrivez sur la page «  http://localhost/FlexiCapture11/Monitoring/DBConnection.aspx ». Cette page permet de configurer la base de données et le FileStorage utilisé par AFC ;

  • Cliquez sur « Créer une nouvelle base de donnée » ;

  • Sélectionnez « Oracle » dans la liste déroulante présentant les bases disponibles ;
  • Entrez les informations permettant d'accéder à la base Oracle ;
  • Cochez la case « Utiliser un FileStorage » ;
  • Sur un des disques dur du serveur, créez un dossier qui sera utilisé pour le FileStorage ;
  • Recopiez le chemin du dossier dans le champs « Chemin » du formulaire de création de base de donnée ;
  • Une fois les informations saisies, cliquez sur « Ok ».

Installation des postes clients. (Source document Abbyy)

Extraction des fichiers d’installation

  • Récupérez le fichier d’installation d’AFC ;
  • Lancez l'exécutable ;
  • Sélectionnez un répertoire où extraire les fichiers d’installation ;
  • Lancez l'extraction.

Installation des clients

  • Rendez-vous dans le répertoire d'extraction des fichiers ;
  • Lancez l'exécutable ;
  • Sélectionnez « Installation distribué » ;
  • Sélectionnez « Installer les stations de travail » ;
  • Sélectionnez la langue ;
  • Acceptez la licence d'utilisation finale ;
  • Le programme vérifie les pré-requis ;
  • Saisissez les informations demander ;
  • Sélectionnez le répertoire d'installation ;
  • Sélectionnez les composants à installer en fonction du postes ;
  • Les fichiers d'installations sont alors copiés sur le disque ;
  • Si FlexiLayoutStudio, FormDesigner, le Poste de vérification ou le Poste de configuration de projets est installé, spécifiez l'adresse du serveur de protection dans la boîte de dialogue suivante. Le serveur de protection s'installe via l'installation des serveurs. L'adresse ne doit pas contenir de barres obliques, par exemple : Serveur Principal.

Configuration des clients

  • Lancez les clients ayant été installés ;
  • Lorsqu'une boite de dialogue demande de saisir l'adresse du serveur FlexiCapture, entrez le nom de la machine hébergeant les serveurs FlexiCapture précédé du protocole http. Par exemple : http://serveurpricipal.

Si le programme parvient à joindre le serveur FlexiCapture, le client se lance.

ElasticSearch

  • Connectez-vous avec un utilisateur ayant les droits d'administration sur le serveur ;
  • Récupérez les fichiers d'ElasticSearch sur le site de la société Elastic ;
  • Extrayez les fichiers sur le serveur ;
  • Dans un shell, lancez la commande « service.bat install » depuis le répertoire bin d'ElasticSearch.

Kibana

  • Connectez-vous avec un utilisateur ayant les droits d'administration sur le serveur ;
  • Récupérez les fichiers de Kibana sur le site de la société Elastic ;
  • Extrayez les fichiers sur le serveur ;
  • Créez un service windows pour kibana à l'aide de la commande windows : «  sc  ».

Logstash

Logstash est un élément à installer sur le serveur hébergeant Alfresco.

  • Connectez-vous avec un utilisateur ayant les droits d'administration sur le serveur ;
  • Récupérez les fichiers de logstash sur le site de la société Elastic ;
  • Extrayez les fichiers sur le serveur.

Script pour les statistiques

  • Récupérez le script « getdata.py »
  • Déposez le script sur la machine hébergeant Alfresco dans un dossier (par exemple : /applis/stats/getdata.py)
  • Editez la table cron du système afin de lancer le script toutes les minutes.