Vous êtes sur la page 1sur 54

Guide dinstallation du logiciel Ennov

CLI.MA.0386.004
Date dapplication : 29/06/2015

GUIDE D INSTALLATION DU
LOGICIEL ENNOV

Etablie par

Vrifie par

Approuve par

Kevin GAVEAU

Thierry VANNESTE
Responsable Qualit
06/06/2015

Afiss BILEOMA
Responsable Support et
Intgration - Ennov
29/06/2015

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 1 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

EVOLUTIONS
1 - Mise jour pour la version 7.1
000 - 23/12/2014 - Guide d'installation pour la version 7 d'Ennov., 001 - 23/01/2015 - 1 - Modification des parties
2.1.4 et 2.2.2 : log4j.xml peut tre directement remplac par sa version modifie prsente dans Outils_2.0
2 - Clarification de la partie 5.1, 002 - 12/02/2015 - 1- Options gros formulaires, solr, utf-8 recopier dans les
options JVM (2.1.3.7)
2 - Linux, Laissez les options JVM vides (2.2.1.1)
3 - Linux, Command sh remplace par bash (2.2.1.2)
4 - Linux, Remplacement automatique du log4j.xml -->Suppression de la partie remplacement manuel
, 003 - 15/04/2015 - 1 - Modification de la table des matires
2 - Clarification de l'avant-propos UTF8

Etablie par

Vrifie par

Approuve par

Kevin GAVEAU

Thierry VANNESTE
Responsable Qualit
06/06/2015

Afiss BILEOMA
Responsable Support et
Intgration - Ennov
29/06/2015

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 2 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Sommaire
1

INTRODUCTION .............................................................................................................................................................. 4
1.1
OBJECTIF DU DOCUMENT ...................................................................................................................................................... 4
1.2
FICHIERS FOURNIS................................................................................................................................................................ 4
1.3
AVANT-PROPOS .................................................................................................................................................................. 4
1.3.1
Bases de donnes pour la v7................................................................................................................................... 4
1.3.2
Avant propos Windows........................................................................................................................................... 4
1.3.3
Avant propos Linux ................................................................................................................................................. 4

INSTALLATION ................................................................................................................................................................ 5
2.1
INSTALLATION AVEC WINDOWS .............................................................................................................................................. 5
2.1.1
Extraction de Outils_2.x.zip .................................................................................................................................... 5
2.1.2
Lancement du install.bat ........................................................................................................................................ 5
2.1.3
Installation du logiciel Ennov .................................................................................................................................. 7
2.1.4
Vidage des tables Quartz ...................................................................................................................................... 34
2.1.5
Migration des bases en UTF8 sous SQL Server et Oracle ...................................................................................... 34
2.1.6
Lancement de lapplication................................................................................................................................... 34
2.1.7
Lancement de lapplication en service .................................................................................................................. 35
2.1.8
Paramtrage de la console dadministration ....................................................................................................... 35
2.2
INSTALLATION AVEC LINUX .................................................................................................................................................. 37
2.2.1
Installation dEnnov .............................................................................................................................................. 37
2.2.2
Vidage des tables Quartz ...................................................................................................................................... 40
2.2.3
Migration des bases en UTF8 sous SQL Server et Oracle ...................................................................................... 40
2.2.4
Lancement de lapplication................................................................................................................................... 41
2.2.5
Lancement de lapplication avec le systme......................................................................................................... 41
2.2.6
Lancement de lapplication au dmarrage ........................................................................................................... 41
2.2.7
Paramtrage de la console dadministration ....................................................................................................... 42

SERVEURS DE CONVERSION ET DE PUBLICATION ......................................................................................................... 43


3.1
3.2

CONVERSION .................................................................................................................................................................... 43
PUBLICATION .................................................................................................................................................................... 43

MISE A JOUR ................................................................................................................................................................ 44


4.1
CAS DUNE MISE A JOUR DE ENNOV 6 VERS ENNOV 7 ............................................................................................................... 44
4.2
MISE A JOUR WINDOWS ..................................................................................................................................................... 44
4.2.1
Arrt du serveur JBOSS ......................................................................................................................................... 45
4.2.2
Sauvegarde des donnes ...................................................................................................................................... 45
4.2.3
Lancement du setup ............................................................................................................................................. 46
4.3
MISE A JOUR LINUX ........................................................................................................................................................... 50
4.3.1
Gnration du properties ..................................................................................................................................... 50
4.3.2
Arrt du serveur Jboss .......................................................................................................................................... 53
4.3.3
Sauvegardes ......................................................................................................................................................... 53
4.3.4
Lancement du script maj.sh .................................................................................................................................. 53

AJOUT DUNE NOUVELLE SOURCE DE DONNEES ........................................................................................................... 54

F.A.Q. ........................................................................................................................................................................... 54

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 3 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

1 INTRODUCTION
1.1 Objectif du document
Ce document a pour but dexpliquer toutes les tapes ncessaires linstallation du logiciel Ennov 7 et de sa mise
jour.

1.2 Fichiers fournis


Pour cette installation vous devez rcuprer les fichiers suivants sur lextranet dEnnov :
- Outils_2.x.zip ou Outils_2.x.tar.gz qui contient les fichiers ncessaires pour linstallation de Java et
JBoss.
- ennov_n_x_y_build_zzz_yyyymmdd.zip ou ennov_n_x_y_build_zzz_yyyymmdd.tar.gz qui contient
la distribution Ennov installer.
- Les scripts SQL correspondant votre type de base de donnes (SQL Server ou Oracle) : script qui permet de
migrer les bases de donnes en utf8
Tout au long de ce document, on dcrira comment utiliser ces fichiers.

1.3 Avant-propos
1.3.1 Bases de donnes pour la v7
Si vous effectuez une installation ou une mise jour en version 7 de lapplication, des actions en base sont
ncessaires pour modifier lencodage en utf8.
MySQL : La procdure suivre est dcrite dans la note technique Migration de base MySQL en UTF8
(CLI.NT.0316) et doit tre excute avant linstallation dEnnov.
SQL Server et ORACLE : La procdure suivre est dans ce guide et se droule post-installation

1.3.2 Avant propos Windows


Se connecter en tant quadministrateur local de la machine.
Les bases de donnes doivent tre dj cres.
On considrera que linstallation se fait sur le disque D: dans le rpertoire ENNOV et que notre base de donnes
est de type MySQL.

1.3.3 Avant propos Linux


Les bases de donnes doivent tre dj cres, on considre quelles sont de type MySQL
Perl doit dj tre install.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 4 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2 INSTALLATION
Linstallation se droule en 3 phases :
-

Linstallation des outils ncessaires Ennov


Linstallation du logiciel Ennov
Linstallation du service JBoss

2.1 Installation avec Windows


2.1.1 Extraction de Outils_2.x.zip
Vous devez extraire le fichier Outils_2.x.zip dans le mme rpertoire qui comprend la distribution
ennov_n_x_y_build_zzz_yyyymmdd.zip .
Veillez ce que les noms des rpertoires du chemin o se trouvent Outils_2.x.zip et la distribution ne
comportent despace.
Vous ne devez pas crer de rpertoire Outils mais obtenir les fichiers directement.

2.1.2 Lancement du install.bat


A partir de votre rpertoire, vous devez lancer Install.bat . Il vous sera demand de choisir ou de crer un
rpertoire qui contiendra votre installation dEnnov (D:\Ennov dans ce document).
Ensuite, lextraction, la cration des rpertoires ncessaires, linstallation de Java ainsi que la cration de la
variable denvironnement JAVA_HOME se fera automatiquement.
Un rpertoire C:\Ennov\confs sera aussi cr automatiquement, celui-ci contiendra les configurations de
lapplication Ennov.
A chaque nouvelle installation ou mise jour du logiciel, linstalleur fait une recherche des configurations existantes
dans ce dossier.
Le fichier de configuration est nomm ainsi : install-xxxxxxxxxxxxx.properties.
Il est possible, selon vos droits dutilisateur, quun message apparaisse pour demander lautorisation de
linstallation de Java. Cliquez sur Oui (ou Yes ) afin de poursuivre.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 5 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Si vous obtenez un message derreur comme ci-dessous, la variable denvironnement JAVA_HOME, na pas pu
tre cre.
Pour la crer, vous devez lancer le script variable_jdk.bat en tant quadministrateur (clic droit, excuter en tant
quadministrateur)

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 6 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3 Installation du logiciel Ennov


Dans le rpertoire D:\ENNOV\ ennov_n_x_y_build_zzz_yyyymmdd\ lancez le fichier Setup.bat (ne pas lancer ce
fichier en tant quadministrateur).
Au lancement de linstalleur, si vous obtenez ce message (encadr en rouge), suivez les procdures suivantes :
-

Quittez linstalleur
Fermez toutes les explorateurs Windows en cours
Relancez le fichier Setup.bat

2.1.3.1 Choix de la langue


Choisissez la langue dinstallation :

A tout moment dans linstallation vous pouvez cliquer sur le bouton

pour avoir de laide sur la page courante.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 7 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.2 Choix dinstallation


Choisissez loption Installation pour une nouvelle installation puis cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 8 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.3 Licence
Veuillez copier/coller la cl de licence dont vous disposez dans le champ Cl de licence .
Lors de la cration de vos sources de donnes, il faudra respecter les noms (notamment la casse) des sources
indiqus par la licence.

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 9 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.4 Slection des applications installer


Slectionnez les applications que vous choisissez dinstaller en les ajoutant dans la liste de droite grce au
bouton :

. On peut ajouter toutes les applications en cliquant directement sur le bouton :

On peut slectionner toutes les applications, elles seront dployes grce cet installeur mais seules les
applications lies votre licence seront actives.
Il faut toujours slectionner la console dadministration, les Services Web et la Webapp.
Si vous disposez dun Pack Sant, slectionnez ePortal. Se reporter au guide du pack sant pour des informations
supplmentaires.
Si vous disposez du module Report, slectionnez Moteur de rapports . Se reporter au guide dEnnov Report
pour des informations supplmentaires sur linstallation et la configuration de ce module.

Cliquez sur

aprs votre slection.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 10 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.5 Composants particulier pour chaque application


Pour chaque application, on a la possibilit dinstaller des composants spcifiques (exemple : CAS pour une
authentification forte) :

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 11 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.6 Slection du type et de la version du serveur applicatif


Choisissez le type de serveur et sa version. Par dfaut, le type est JBoss et la version est 4.0.5.
Ensuite renseignez le rpertoire de proprits de JBoss ou laissez la variable en rouge par dfaut (qui sera
automatiquement remplace par le bon rpertoire).
Requte : ${jboss.home.dir}/bin/${jboss.config.name}/ennovproperties

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 12 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.7 Serveur applicatif JEE


a) Choisissez le chemin du rpertoire de JBoss (D:\ENNOV\jboss-4.0.5 dans lexemple), le nom de la
configuration, les options pour la jvm, le nom dhte qui correspond au nom du serveur ou ladresse IP ou encore
son alias rseau (cette solution tant la plus souple).
Dans les options pour la jvm les valeurs Xms (minimum) et Xmx (maximum) doivent tre adaptes en fonction des
ressources du serveur :
Si RAM=1Go mettre 512M
Si RAM=2Go mettre 1024M
Ajoutez dans les options jvm le contenu du fichier D:\ENNOV\perl\gros_formulaire.txt
La configuration du planificateur de tches doit imprativement tre coche.
Slectionnez les autres paramtres comme ci-dessous puis sur longlet Tomcat .

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 13 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

b) Modifiez les ports HTTP, SSL, AJP et loptimisation si ncessaire puis cliquez sur longlet Logging .
Par dfaut, on nactive pas de SSL.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 14 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

c) Longlet Logging permet de cocher les fichiers .log que lon veut gnrer et si lon veut les gnrer sparment
ou pas.

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 15 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.8 Certificat Https / SSL


Le certificat Ennov pour les connexions en HTTPS, est install automatiquement. Il permet aussi la signature des
applets. Par dfaut un certificat existant dans le keystore n'est pas modifi, il est possible en activant loption
Forcer la gnration de forcer la gnration du certificat (par exemple si celui-ci expire bientt).

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 16 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.9 Source de donnes console


Renseignez la source de donnes, qui sera utilise par la console dadministration, en choisissant son type, son
nom, le port utilis et les identifiants de connexion. Si vous possedez une base de type sql server, choisissez
toujours le type sqlserver et non sqlserver-ms .
Le nom dhte correspond au nom de la machine serveur, son adresse IP ou encore son alias rseau.

Attention, si votre base de donnes est de type MySQL, il faut ajouter une option UTF8 dans le nom de la base de
donnes qui va tre utilise dans la chane de connexion.
Chane ajouter : ?useUnicode=true&characterEncoding=UTF-8

Une fois ces donnes renseignes, cliquez sur


pour vrifier que la connexion est effectue. Une fentre
apparatra pour indiquer si la connexion est russie ou non.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 17 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Il est possible dutiliser une autre source de donnes pour les tches automatiques (jobs). Dans ce cas cochez
Utiliser une autre source pour le planificateur afin de renseigner cette source dans ltape suivante. Par dfaut,
on laisse cette option dcoche.
Cliquez sur

2.1.3.10 Sources de donnes


a) En gnral les sources de donnes sont au nombre de 3 et sont nomms ainsi : prod, test et quartz.
Ajoutez la source de donnes que vous utilisez en cliquant sur le bouton

Vous pouvez nommer vos sources selon votre choix mais on vitera de mettre un numro de version dans le nom.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 18 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

LURL du serveur web correspond au nom de la machine serveur, son adresse IP ou son alias. La langue par
dfaut est le franais (fr).
Si vous possdez une base de type sql server, choisissez toujours le type sqlserver et non sqlserver-ms .
Le schma de la base de donnes est utile pour le type Oracle si lutilisateur et le schma sont diffrents.
Gnralement, le nom du schma est le mme que le nom dutilisateur.
Renseignez pour le type, le port, le nom et les identifiants pour se connecter la base.
b) De nouveau, cliquez sur

pour vrifier la connexion la base de donnes.

On peut configurer le gestionnaire de persistance en cliquant sur longlet Kodo, activer Documentum et Exalead.
Longlet Datamart concerne le module Report, voir le guide dEnnov Report pour plus dinformations concernant la
configuration du Datamart.
c) Faites ces oprations pour chaque source de donnes. (Y compris la source de donnes console enregistre
ltape 2.1.3.9).
On peut facilement supprimer, renommer ou dupliquer une source grce aux boutons

Cliquez sur

aprs avoir configur chaque source.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 19 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.11 Systme de mail


Paramtrez le systme de mail en renseignant ladresse du serveur SMTP, le port du serveur :
Si vous utilisez lauthentification SMTP, remplir les champs Utilisateur et Mot de passe .
Changez de port si vous utilisez un systme de mail externalis.
Il y a possibilit dutiliser le protocole TLS.
Dans la partie Options renseignez le nom afficher, ladresse expditrice des mails qui sera utilise au niveau
de lapplication, ladresse de rponse (par exemple : noreply) et lutilisateur pour lenvoi des mails.
Loption Debug permet dafficher dans les logs les envois de mails effectus ou non.

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 20 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.12 Configuration des composants optionnels


Slectionnez les composants optionnels installer en les cochant.
Pour une installation classique, cochez Options gnrales , Planificateur de tches , Authentification ;
cochez galement Authentification unique dans les cas suivants : si vous disposez dePortal ou si vous
installez un module SSO ou encore si vous utiliserez le Web SSO.

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 21 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.13 Planificateur de tches


Vous avez la possibilit de configurer le planificateur de tches pour chaque source de donnes que vous avez
cr.
On peut ajouter ou supprimer des tches en les passant dune liste lautre.
Notez que pour la v7, 4 nouvelles tches sont slectionner pour la recherche plein texte : search-full-indexing,
search-incremental-indexing, search-utilities-full-indexing, search-utilities-incremental-indexing
Ci-dessous, les tches habituellement slectionnes :

Cliquez ensuite sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 22 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.14 Options gnrales


Les options gnrales permettent de configurer les options concernant la recherche et la conversion brouillon.
Taille dune page est 250 par dfaut, ce qui signifie quon demande la fonctionnalit Recherche dafficher
250 rsultats maximum sur une page. Modifiez la valeur si vous le souhaitez.
Vous pouvez activer la conversion brouillon si vous disposez du serveur de publication.
Vous avez la possibilit de modifier la mmoire minimum et maximum de la base de donnes allouer Ennov.

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 23 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.15 Authentification (modules de connexions)


Ajoutez les modules souhaits (se trouvant dans la liste droulante) et en cliquant sur le bouton +Ajouter .

Le module Test est un module, comme son nom lindique, de test. Il nest pas scuris, on sy authentifie
uniquement avec un login, sans mot de passe.
Le module Ldap permet de se connecter avec une saisie didentifiants rseau (login et mot de passe) ; une
vrification est faite lauthentification auprs du serveur Ldap. Il est possible de cumuler plusieurs modules Ldap
si vous possdez des annuaires diffrents.
Le module Single Sing On (SSO) permet de se connecter sans saisie didentifiants grce aux identifiants dj
renseigns lors de la connexion sur le poste Windows. Voir Authentification unique (SSO) pour plus de dtails.
Il est important de noter que si vous configurez un module SSO, il faut obligatoirement avoir coch le composant
optionnel Authentification unique .
Le module Anonyme permet de se connecter automatiquement et directement lapplication sans identifiants
mais en mode Anonyme. Il faut se dconnecter de lapplication pour sidentifier avec un compte non anonyme.
Le module Base de donnes interroge une base de donnes externe qui contient les identifiants.
Lordre des modules renseigns sera respect lorsquun utilisateur se connectera lapplication. Cet ordre est
donc important.
Dans ce guide, on paramtre 2 modes dauthentification : Ldap et Single Sing On.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 24 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

a) Pour chaque module ajout, un nom doit tre renseign. En gnral, le nom du module correspond au nom
quon saisit.

b) Pour chaque module, il faut configurer les options en double-cliquant sur le module ou en cliquant sur le bouton
aprs lavoir slectionn.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 25 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Ldap, renseignez :
- Serveur Ldap (mettez un nom de machine (DNS) ou un alias rseau plutt quune adresse IP)
- le port de connexion au serveur
- lattribut correspondant au login
- les prfixes ou suffixes du DN (lidentifiant unique)

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 26 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

SSO, renseignez si le nom dutilisateur est suffisant la connexion ou sil faut ajouter le nom de domaine
au login :

Longlet Standard vous permet de choisir des options sur la connexion.


Si vous configurez un seul module dauthentification, son drapeau (flag) doit tre renseign en required .
Si vous configurez plusieurs modules, il est recommand de les mettre en sufficient .

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 27 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

c) Il est possible de modifier lordre des modules en slectionnant le module et en cliquant sur les boutons Haut ou
Bas.
Lordre des modules de connexions prsents doit tre le suivant :

Cliquez ensuite sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 28 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.16 Authentification unique (SSO)


Lauthentification unique permet de se connecter lapplication sans avoir renseigner ses identifiants.
Lauthentification se fera grce aux identifiants entrs dans la fentre de connexion Windows.
Le Web Single Sign On, permet de naviguer dune application Ennov une autre en ne renseignant ses identifiants
quune seule fois.
Si vous avez configur un module de connexion SSO dans ltape 2.1.3.15Authentification (modules de
connexions) , vous devez avoir coch loption Authentification unique dans Configuration des composants
optionnels
Si vous nutilisez que le web SSO, il ne faut pas configurer le module SSO.
a) Vous pouvez configurer le SSO pour les applications choisies sauf les consoles dadministration :

Slectionnez les applications pour lesquelles vous voulez activez le SSO. Par exemple eDoc : Gestion
Electronique de Document (GED) , eProcess : Gestion des Procdures dEntreprise(BPM) et ePortal .
Choisissez le support selon votre environnement serveur(en gnral Natif) et la mthode (par dfaut Ntlm).

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 29 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Veuillez remplir les champs de la manire suivante :


Domaine : <Indiquez le nom du domaine ou lalias>
Contrleur : <Indiquez le nom, ladresse IP ou lalias du contrleur de domaine>
Cliquez sur le bouton
, le domaine par dfaut prend comme valeur le domaine prcdemment renseign. Si
vous avez plusieurs domaines, veuillez saisir de nouveau le nom du 2me domaine et le contrleur de domaine
puis cliquez sur
Nom dutilisateur pour la pr authentification : <Indiquez le login dun utilisateur qui a le droit de naviguer dans
lannuaire Ldap>
Mot de passe pour la pr authentification : <Indiquez le mot de passe de lutilisateur qui a le droit de naviguer dans
lannuaire Ldap>

Vous pouvez modifier certaines options en cochant les cases correspondantes.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 30 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

b) Il est possible dactiver le Web Single Sing On en cliquant sur longlet Web Single Sing On et en cochant la
case Activer le Web Single Sign On. Cette option est utile si vous utilisez plusieurs applications Ennov afin de
naviguer dune application lautre sans renseigner chaque fois ses identifiants.

Cliquez ensuite sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 31 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.3.17 Installation, Gnration


La dernire tape permet dinstaller Ennov.
Le bouton Mise jour des proprits cre uniquement le fichier install-xxxxxxxxxxxx.properties de votre
configuration courante dans le dossier C:\ennov\conf.
Le bouton Gnrer gnre un fichier correspondant configuration courante de linstallation.
Cliquez sur Installer et confirmer linstallation en cliquant sur Oui

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 32 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

On peut voir les dtails de linstallation en cliquant sur le bouton

Lorsque linstallation est termine ( Succs ), vous avez la possibilit de retourner linstalleur (pour gnrer un
fichier des paramtres de la configuration par exemple) en cliquant sur Back to installer ou de le quitter en
cliquant sur Terminer.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 33 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.4 Vidage des tables Quartz


Sil sagit dune migration en v7, il faut supprimer le contenu des tables Quartz pour rcuprer les nouveaux liens
des notifications par mail.
Passez les requtes suivantes sur la base qui sert de source de donnes console (en gnral quartz) :
delete from QRTZ_JOB_LISTENERS;
delete from QRTZ_TRIGGER_LISTENERS;
delete from QRTZ_FIRED_TRIGGERS;
delete from QRTZ_SIMPLE_TRIGGERS;
delete from QRTZ_CRON_TRIGGERS;
delete from QRTZ_BLOB_TRIGGERS;
delete from QRTZ_TRIGGERS;
delete from QRTZ_JOB_DETAILS;
delete from QRTZ_CALENDARS;
delete from QRTZ_PAUSED_TRIGGER_GRPS;
delete from QRTZ_LOCKS;
delete from QRTZ_SCHEDULER_STATE;

2.1.5 Migration des bases en UTF8 sous SQL Server et Oracle


Sil sagit dune migration en v7, il faut migrer les bases en UTF8.

2.1.5.1 SQL Server


Excutez le script drop_indexes.sql pour supprimer certains indexes gnant pour la migration en utf8
Excutez le script sqlserver_update_to_utf8.sql pour migrer la base en utf8
Excutez le script create_indexes.sql pour recrer les indexes supprims

2.1.5.2 Oracle
Excutez le script oracle_update_to_utf8.sql pour migrer la base Oracle en utf8

2.1.6 Lancement de lapplication


Allez dans le rpertoire bin de votre dossier JBoss. Vous trouverez le fichier run-%configname%.bat (configname
tant le nom que vous aviez donn lors du paramtrage de linstallation). Vous naurez plus qu le lancer et
accder lapplication via ladresse suivante :
http://serveur:port/ennov/mydatasource
serveur correspond au nom de lhte ou son adresse IP.
port correspond au port JBOSS utilis.
mydatasource correspond la source de donne laquelle on veut se connecter.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 34 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.7 Lancement de lapplication en service


Allez dans votre rpertoire JBoss (D:\ENNOV\jboss-4.0.5\bin par exemple) et diter si ncessaire le fichier
install.bat afin de le paramtrer en fonction de votre configuration. Vrifiez que le rpertoire dinstallation et le nom
de configuration (voir Serveur applicatif JEE) correspondent aux vtres.
Set ENNOV_HOME=D:\ENNOV

Set JBOSS_CONFIG_NAME=ennov
Lancez le fichier install.bat en tant quadministrateur (clic droit et excuter en tant quadministrateur), cliquez sur
oui.
Une console de commande saffiche pour confirmer linstallation de Jboss :

Allez dans les gestionnaire de service pour dmarrer le service Jboss et configurez le type de dmarrage en
Automatique (dbut diffr) . Windows indique que le service est dmarr, mais il lest vritablement quaprs
environ 1 minute.

2.1.8 Paramtrage de la console dadministration


2.1.8.1 Dmarrage des nouveaux Jobs
Aprs le lancement de lapplication, il faut paramtrer les tches planifies (jobs) dans la console dadministration
(eConsole) pour les redmarrer.
Pensez lancer les 4 jobs ajouts dans le planificateur de tches lors de linstallation pour lindexation SOLR.
Lindexation complte (full) SOLR peut-tre relativement longue en fonction du volume de donnes indexer,
modifiez la frquence de lancement du job SearchFullIndexingJob. Il est conseill de la paramtrer toutes les
semaines, par exemple tous les dimanches 4 heures : 0 00 04 ? * SUN

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 35 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.1.8.2 Chargement des PDF


Afin que le chargement des PDF volumineux fonctionne correctement, il faut mettre la valeur application/pdf
au paramtre : ByteRangeServingDenyMimeType

Cliquez ensuite sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 36 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.2 Installation avec Linux


2.2.1 Installation dEnnov
2.2.1.1 Partie Windows
On considre quon installe Ennov dans le dossier /opt/ennov sur le serveur Linux.
Pour installer Ennov sur Linux, on crera pralablement une configuration de la distribution que lon veut installer
sous Windows.
Cest--dire quon aura une configuration dans un fichier install-xxxxxxxxxxxxx.properties quon utilisera
lorsquon installera Ennov sous Linux.
Crez les 3 rpertoires \opt\ennov\jboss-4.0.5 (dans le disque D: par exemple).
Crez aussi les rpertoires C:\ennov\confs .
Utilisez un outil de dcompression (ex : 7zip) pour dcompressez
ennov_n.x.y_build_zzz_ddmmyyyy.tar.gz dans un rpertoire (ex : D:\ENNOV\ ).

la

distribution

dennov

Avant de poursuivre, assurez-vous quune version de Java (1.6.0_18 minimum) est installe sur votre serveur
Windows avant de lancer Setup.bat
Suivez les instructions de linstalleur expliqu dans la partie Installation du logiciel Ennov lexception de la
configuration du serveur applicatif :
Dans la partie Slection du type et de la version du serveur applicatif , copiez collez le chemin :
/opt/ennov/jboss-4.0.5/bin/ennov/ennovproperties

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 37 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Lors de la configuration du serveur applicatif avec le setup.bat, Il faut mettre un rpertoire JBoss qui sera valide sur
Linux. Copiez collez le chemin : /opt/ennov/jboss-4.0.5
Supprimez les options pour la JVM :

A la fin de la configuration, ne cliquez pas sur Installer mais sur Mise jour des proprits .
Vous pourrez ainsi
C:\ennov\confs\

rcuprer

le

fichier

install-xxxxxxxxxxxxx.properties

dans

le

rpertoire

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 38 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.2.1.2 Partie Linux


a) Sur Linux, crer un dossier /opt/ennov et donner les droits via la commande :

chmod -R 744 /opt/ennov


Placez le fichier properties gnr, dans votre dossier /opt/ennov
Vrifiez que votre fichier properties est bien configur :
-

Nom de machine correcte


Bases de donnes identiques celles installes

Dans ce mme dossier vous devez avoir votre archive de distribution Ennov et une archive Outils_2.x.tar.gz :
/opt/ennov/ennov_n_x_y_build_zzz_yyyymmdd.tar.gz
/opt/ennov/Outils_2.x.tar.gz
b) Dcompressez Outils_2.x.tar.gz :

tar -xvzf /opt/ennov/Outils_2.x.tar.gz


c) Lancez l install.sh dans un terminal avec la commande :

bash install.sh 2>&1 | tee install.log


Install.sh permet de :
Dcompresser la distribution dEnnov dans un rpertoire du mme nom.
Dcompresser larchive Jboss.
Dcompresser Java.
Configurer les bases de donnes et Jboss.
Installer lapplication.
Remplace le fichier log4j.xml par le nouveau pour les logs Solr.
Crer un rpertoire source_files o sont dplacs les fichiers propres linstallation.
Crer le script de lancement du serveur dapplication.
Ce dernier script vous permettra de lancer lapplication Ennov.
Lors de linstallation automatique de Java, il est possible quune page web souvre si vous utilisez un
environnement graphique. Il ne faut pas tenir compte de cette page, vous pouvez la fermer.
Note : A la fin du script install.sh, si vous utilisez loutil putty, tapez Ctrl+C pour revenir sur le prompt.
Il est possible que le script du service ennov nait pas pu tre dplac automatiquement dans /etc/init.d.
Dans ce cas, vous devez passer en root pour effectuer ce dplacement manuellement :

su root
mv ennov /etc/init.d

Rendez le script excutable :

chmod +x /etc/init.d/ennov

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 39 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.2.2 Vidage des tables Quartz


Sil sagit dune migration en v7, il faut supprimer le contenu des tables Quartz pour rcuprer les nouveaux liens
des notifications par mail.
Passez les requtes suivantes sur la base qui sert de source de donnes console (en gnral quartz) :
delete from QRTZ_JOB_LISTENERS;
delete from QRTZ_TRIGGER_LISTENERS;
delete from QRTZ_FIRED_TRIGGERS;
delete from QRTZ_SIMPLE_TRIGGERS;
delete from QRTZ_CRON_TRIGGERS;
delete from QRTZ_BLOB_TRIGGERS;
delete from QRTZ_TRIGGERS;
delete from QRTZ_JOB_DETAILS;
delete from QRTZ_CALENDARS;
delete from QRTZ_PAUSED_TRIGGER_GRPS;
delete from QRTZ_LOCKS;
delete from QRTZ_SCHEDULER_STATE;

2.2.3 Migration des bases en UTF8 sous SQL Server et Oracle


Sil sagit dune migration en v7, il faut migrer les bases en UTF8.

2.2.3.1 SQL Server


Excutez le script drop_indexes.sql pour supprimer certains indexes gnant pour la migration en utf8
Excutez le script sqlserver_update_to_utf8.sql pour migrer la base en utf8
Excutez le script create_indexes.sql pour recrer les indexes supprims

2.2.3.2 Oracle
Excutez le script oracle_update_to_utf8.sql pour migrer la base Oracle en utf8

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 40 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

2.2.4 Lancement de lapplication


Afin de dmarrer le serveur dapplication, lancer le fichier run-%config_ennov%.sh en tapant dans un terminal :

bash /opt/ennov/jboss-4.0.5/bin/run-%config_ennov%.sh
%config_ennov% tant le nom de votre configuration dEnnov tel quil a t dfini dans le fichier installxxxxxxxxxxxxx.properties.
Lancez lURL correspondante lapplication ainsi qu la source de donnes (correspondante la valeur du
paramtre data source dfini dans le fichier install-xxxxxxxxxxxxx.properties en respectant la casse) :
http://serveur:portJBOSS/ennov/mydatasource
Larrt du serveur JBOSS se fait partir du fichier /opt/ennov/jboss-4.0.5/bin/shutdown jboss.sh ou en faisant
un Ctrl+C dans le terminal o le serveur a t lanc.

2.2.5 Lancement de lapplication avec le systme


Lancez lapplication avec la commande :

/etc/init.d/ennov start
Le dmarrage du service est effectif aprs environ 1 minute.
Pour arrter le serveur applicatif :

/etc/init.d/ennov stop

2.2.6 Lancement de lapplication au dmarrage


Afin de que le service soit lanc automatiquement chaque dmarrage de la machine, il faut modifier le script
ennov dans /etc/init.d/ .
Si vous tes sur un systme dexploitation type Debian il faut ajouter les lignes suivantes au dbut du
fichier (aprs len tte # !/bin/sh) :
### BEGIN INIT INFO
# Provides:

ennov

# Required-Start:

$remote_fs $syslog

# Required-Stop:

$remote_fs $syslog

# Should-Start:

$all

# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description:

Serveur Applicatif Ennov

# Description: Demarrage du serveur applicatif Ennov


### END INIT INFO

Ensuite en tant que root lancer la commande suivante :

update-rc.d ennov defaults

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 41 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Si vous tes sur un systme dexploitation type Red Hat il faut ajouter les lignes suivantes au dbut du
fichier (aprs len tte # !/bin/sh):
# chkconfig: 2345 99 99
# description: Demarrage du serveur applicatif Ennov
# processname: ennov
# pidfile: /var/run/ennov.pid

Ensuite en tant que root lancer la commande suivante :

chkconfig --add ennov

2.2.7 Paramtrage de la console dadministration


2.2.7.1 Dmarrage des nouveaux Jobs
Aprs le lancement de lapplication, il faut paramtrer les tches planifies (jobs) dans la console dadministration
(eConsole) pour les redmarrer.
Pensez lancer les 4 jobs ajouts dans le planificateur de tches lors de linstallation pour lindexation SOLR.
Lindexation complte (full) SOLR peut-tre relativement longue en fonction du volume de donnes indexer,
modifiez la frquence de lancement du job SearchFullIndexingJob. Il est conseill de la paramtrer toutes les
semaines, par exemple tous les dimanches 4 heures : 0 00 04 ? * SUN

2.2.7.1 Chargement des PDF


Afin que le chargement des PDF volumineux fonctionne correctement, il faut mettre la valeur application/pdf
au paramtre : ByteRangeServingDenyMimeType

Cliquez ensuite sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 42 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

3 SERVEURS DE CONVERSION ET DE PUBLICATION


3.1 Conversion
Si vous utilisez un serveur de conversion, il faut mettre celui-ci jour avec la nouvelle distribution fourni dans
lextranet. Suivez le guide dinstallation du serveur de conversion pour mettre celui-ci jour (RD.IN.0320)
Les anciennes versions du serveur de conversion (antrieures la 7.0.2) ne sont plus compatibles avec la v7.

3.2 Publication
Si vous utilisez un serveur de publication, il faut mettre celui-ci jour avec la nouvelle distribution fourni dans
lextranet. Suivez le guide dinstallation du serveur de conversion pour mettre celui-ci jour (RD.TN.287)

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 43 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

4 MISE A JOUR
4.1 Cas dune mise jour de Ennov 6 vers Ennov 7
Dans le cas dune mise jour majeure dun environnement v6 en v7, il est conseill dutiliser un nouveau serveur
pour accueillir le nouvel environnement ou alors dutiliser un nouveau dossier dinstallation Ennov dans votre
arborescence de fichier.
Il faut :
-

Suivre la procdure depuis la partie Avant-propos au lieu de la procdure de Mise jour dcrite cidessous.
Si vous utilisez le mme serveur :
o Dsinstaller le JDK du serveur.
o Dans le dossier C:\ennov\confs, dplacer le fichier install-xxxxxxxxxxx.properties dans un autre
dossier afin quau lancement de linstalleur il ne propose pas une mise jour de lapplication mais
une installation.

4.2 Mise jour Windows


Afin de faire une mise jour du logiciel Ennov ou de faire des modifications, plusieurs tapes doivent tre suivies :
- Larrt du serveur dapplication JBOSS
- Sauvegardes des bases de donnes et de la configuration de la version prcdente
- Lancement du setup.
Dans le cas dune mise jour majeure, la bonne excution et installation du logiciel ENNOV peut ncessiter la
mise jour des outils JDK et JBOSS. Dans ce cas avant de commencer les tapes ci-dessous, il est recommand
de dsinstaller le JDK et le JBOSS de la version prcdente, puis dextraire le nouvel Outils_2.x.zip dans le
mme rpertoire contenant votre nouvelle distribution Ennov (ennov_n.x.y_build_zzz_ddmmyyyy) et lancer le
fichier .bat install.bat permettant de crer les rpertoires Java et JBOSS, dinstaller ces outils et dextraire la
nouvelle distribution dans un nouveau dossier Ennov.
Sil sagit dune mise jour mineure, dcompressez uniquement
(ennov_n.x.y_build_zzz_ddmmyyyy) dans votre dossier dinstallation (D:\ENNOV\).

la

nouvelle

distribution

Si vous tes sur Windows Server 2008 : Avant toute mise jour, excutez en tant quadministrateur le script
avant_maj.bat . Il se trouve dans Outils_2.x.zip ou en tlchargement sur lextranet dans la catgorie Ennov
Tools. Il permet dviter une erreur lors de la mise jour de linstalleur (impossibilit de supprimer certains fichiers).

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 44 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

4.2.1 Arrt du serveur JBOSS


Faites un Ctrl+C sur la console JBOSS afin darrter le service si il est lanc manuellement. Sinon, il faut le
stopper via le Server Manager.
Un exemple de console JBOSS lance :

4.2.2 Sauvegarde des donnes


Avant de procder la mise jour, il faut vider le cache de JBOSS. Pour cela il suffit de supprimer les rpertoires
tmp , work et data situ au chemin suivant :
D:\ENNOV\Jboss-4.0.5\server\nom_config\
Le nom de votre configuration tant par exemple ennov .

Il est fortement recommand de sauvegarder toutes les bases de donnes utilises par le logiciel Ennov et de
copier la configuration actuelle du logiciel que vous possdez (en cas derreur de manipulation). Cette
configuration est situe dans plusieurs dossiers aux chemins suivants :
D:\ENNOV \jboss-4.0.5\bin\nom_config\
D:\ENNOV \jboss-4.0.5\server\nom_config\

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 45 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

4.2.3 Lancement du setup


Lancer le Setup.bat se trouvant au chemin : D:\ENNOV\ennov_n.x.y_build_zzz_ddmmyyyy\ correspondant
votre nouvelle distribution. Il ne faut pas lancer ce fichier en tant quadministrateur.
Choisissez la langue et loption Mise jour/Mise niveau

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 46 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Le setup cherche automatiquement les configurations existantes sur votre machine. Slectionnez la configuration
que vous voulez mettre jour ou niveau.
Si vous voulez paramtrer de nouveau votre configuration avant de la mettre jour, cochez Reconfigurer . Cela
vous permettra de reconfigurer en dtail toute votre configuration actuelle avant de mettre jour Ennov.

Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 47 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Si vous navez pas coch Reconfigurer il vous suffit dentrer votre cl de licence.

Si vous avez coch Reconfigurer , il vous faut suivre les tapes dune installation normale expliques dans la
partie Installation du logiciel Ennov .
Cliquez sur

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 48 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Cliquez sur Mise jour/Mise niveau puis confirmez linstallation. Votre configuration se mettra jour
automatiquement.
Comme la premire installation, vous pouvez visualisez les dtails de la mise jour en cliquant sur le bouton
.
Le bouton mise jour des proprits modifie uniquement votre fichier .properties de votre configuration actuelle
mais ne met pas jour concrtement votre logiciel.

Une fois la mise jour termine, cliquez sur Terminer .

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 49 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

4.3 Mise jour Linux


Afin de faire une mise jour du logiciel Ennov, plusieurs tapes sont ncessaires :
- La gnration du nouveau fichier properties sur Windows
- Larrt du serveur dapplication JBOSS sur Linux
- Sauvegardes des bases de donnes et de la configuration de la version prcdente
- Lancement du script de mise jour
Dans le cas dune mise jour majeure (exemple : v7), la bonne excution et installation du logiciel ENNOV peut
ncessiter la mise jour des outils JDK et JBOSS. Dans ce cas avant de commencer les tapes ci-dessous, il est
recommand de dsinstaller le JDK et le JBOSS de la version prcdente, puis dextraire le nouvel
Outils_2.x.tar.gz
dans
le
mme
rpertoire
contenant
votre
nouvelle
distribution
Ennov
(ennov_n.x.y_build_zzz_ddmmyyyy) et dutiliser le fichier install.sh (au lieu du maj.sh) dans la partie
53Lancement du script maj.sh4.3.4 permettant de crer les rpertoires Java et JBOSS, dinstaller ces outils et
dextraire la nouvelle distribution et de linstaller.
Sil
sagit
dune
mise

jour
mineure,
placez
uniquement
la
nouvelle
(ennov_n.x.y_build_zzz_ddmmyyyy.tar.gz) dans votre dossier dinstallation (/opt/ennov)

distribution

4.3.1 Gnration du properties


Le fichier properties contient les paramtres de lapplication que vous possdez actuellement. Ce fichier properties
se situe dans le rpertoire /opt/ennov/ et se nomme : install-xxxxxxxxxxxxx.properties (les x reprsentant
des chiffres).
Si vous utilisez le mme serveur Windows que lors de votre premire installation, vous devez dj avoir un fichier
properties dans le rpertoire C:\ennov\confs
Sinon, sur un serveur Windows crez un rpertoire C:\ennov\confs et mettez-y votre ancien fichier properties
(Faites une sauvegarde de ce fichier en cas derreur).
Crez aussi larborescence opt\ennov\jboss-4.0.5 sur le disque D: par exemple.
Dans un dossier ENNOV, dcompressez la distribution ennov_n.x.y_build_zzz_ddmmyyyy.tar.gz
(Tlchargez un outil de dcompression comme 7zip pour dcompresser une archive linux).
Avant de poursuivre, assurez-vous quune version de Java (1.6.0_18 minimum) est installe sur votre serveur
Windows.
Comme dans la partie installation Linux (2.2.1), Lancez le setup.bat se trouvant
D:\ENNOV\ennov_n.x.y_build_zzz_ddmmyyyy\ correspondant votre nouvelle distribution.

au

chemin

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 50 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Aprs avoir slectionn la langue, choisissez loption Mise jour/ Mise niveau

Le setup cherchera automatiquement les configurations existantes dans le rpertoire C:\ennov\confs , donc le
properties que vous utilisez sur Linux.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 51 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

Choisissez dans la liste droulante le chemin qui correspond votre configuration sur Linux et cochez la case
Reconfigurer si ncessaire. Si la liste est vide, slectionnez manuellement le fichier properties en cliquant sur
le bouton

Cliquez sur

Si vous avez coch Reconfigurer , configurez lapplication selon les nouveaux paramtres.
A la fin de la configuration, ne cliquez pas sur le bouton Installer mais sur le bouton Mise jour des
proprits afin de mettre jour uniquement le fichier properties.
Vous pourrez ainsi rcuprer le fichier install-xxxxxxxxxxxxx.properties, qui a t mis jour, dans le
rpertoire C:\ennov\confs\
Placez ce nouveau fichier properties gnr dans votre dossier /opt/ennov sur Linux

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 52 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

4.3.2 Arrt du serveur Jboss


Excutez la commande : ./etc/init.d/ennov stop ou tapez Ctrl+C dans la console du serveur
applicatif sil a t lanc manuellement.

4.3.3 Sauvegardes
Il est recommand de sauvegarder toutes les bases de donnes utilises par le logiciel Ennov et de copier la
configuration actuelle du logiciel que vous possdez (en cas derreur de manipulation). Cette configuration est
situe dans plusieurs dossiers aux chemins suivants :
/opt/ennov/jboss/bin/nom_config/
/opt/ennov/jboss/server/nom_config/
Le nom de votre configuration tant par exemple ennov .
Avant de procder la mise jour, il faut vider le cache de JBOSS. Pour cela il suffit de supprimer les rpertoires
tmp , work et data situ ce chemin :
/opt/ennov/jboss/server/nom_config/

4.3.4 Lancement du script maj.sh


Assurez vous avant de lancez ce script quil nexiste pas danciennes archives de la distribution Ennov dans le
dossier, ni danciens fichiers properties, uniquement le nouveau properties et la nouvelle distribution.
Lancez le script maj.sh afin de mettre jour Ennov.

Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 53 / 54

Guide dinstallation du logiciel Ennov


CLI.MA.0386.004
Date dapplication : 29/06/2015

5 AJOUT DUNE NOUVELLE SOURCE DE DONNEES


Lancez le Setup.bat qui se trouve dans le dossier D:\ENNOV\ ennov_n.x.y_build_zzz_ddmmyyyy\
Choisissez la langue et choisissez loption Mise jour puis cliquez sur

Slectionnez la configuration que vous voulez modifier.


Suivez les tapes dans la partie 18Sources de donnes afin dajouter votre nouvelle source de donnes.
Cliquez sur suivant jusqu la dernire tape de linstalleur.
Ensuite cliquez sur Mise jour/Mise niveau.
Vrifiez que votre nouvelle source
4.0.5\server\ennov\ennovproperties\ds\

de

donnes

existe

dans

le

rpertoire

D:\ENNOV\Jboss-

6 F.A.Q.
1. La configuration actuelle de mon logiciel napparat pas dans la liste lorsque je veux faire une mise jour ou une
reconfiguration.
Pour que vos configurations apparaissent automatiquement ce niveau, il faut que ce dossier existe ce
chemin : C:\Ennov\confs\
Cest dans ce dossier que vos configurations doivent tre places pour quelles soient reconnues
automatiquement.
Si ce dossier na pas t cr au pralable, il est cr automatiquement par linstaller au chemin :
C:\Users\UtilisateurActuel\Ennov\

2. Le serveur SMTP a chang. Comment le modifier dans le logiciel Ennov ?


Pour modifier vos renseignements sur le serveur SMTP, il vous suffit de :
Lancer le Setup.bat
Choisir la partie Mise jour
Choisir votre configuration
Cliquez sur Suivant jusqu la page de configuration du systme de mail
Suivre ltape 2.1.3.11
Cliquez sur Suivant jusqu la dernire tape
Cliquer sur Mise jour/Mise niveau

3. Suite une mise jour, je ne dispose plus des pages pour le Portail.
Pour rcuprer les pages lies au portail, il suffit de copier ces pages partir de votre ancienne
sauvegarde du fichier de configuration et de les coller dans votre nouveau fichier.
Lancer le Setup.bat
Suivre les tapes de la partie 4.2.3 sans cocher Reconfigurer .
Proprit dEnnov Group. Toute COPIE et/ou DIVULGATION interdite sans accord crit pralable.
Suivant modle QUA.MO.291.003

Page 54 / 54