Post on 25-Dec-2018
TotEM
Guide d’installation de l’application
Décembre 2012 – R006
TotEM Guide d’installation de l’application
1. Introduction 3
2. Installer le serveur (autonome) 10
3. Installer le serveur (application War) 19
4. Installer le client TotEM 25
5. Sauvegarder les données de TotEM 35
6. Montée de version TotEM 1.1 vers 1.2 40
7. Problème de version Java 45
TotEM Guide d’installation de l’application
1. Introduction Le projet Actes Budgétaires 4
L’application TotEM 5
Prérequis techniques à l’installation 6
Modes de fonctionnement de TotEM 7
Guide d’installation de TotEM
Le projet AB – Dématérialisation des actes budgétaires s’inscrit dans une démarche de modernisation de l’Etat et des collectivités.
Il porte sur la modernisation des moyens de:
création
transmission
contrôle
des documents budgétaires émis par les collectivités.
Pour plus d’information sur le projet et la procédure de dématérialisation, veuillez consulter les documents de référence disponibles sur le site odm-budgetaire.org ainsi que sur le site de la DGCL :
Présentation générale du projet Actes Budgétaires
Notice explicative: «Comment entrer dans la démarche de dématérialisation des documents budgétaires?»
Guide d’utilisation de TotEM
4
Guide d’installation de TotEM
L’application TotEM (Totalisation et Enrichissement des Maquettes) est le composant du projet Actes Budgétaires à destination des collectivités.
Cet outil est mis à disposition des collectivités gratuitement par la Direction Générale des Collectivités Locales, et est téléchargeable librement sur le site odm-budgetaire.org.
Les prérequis fonctionnels indispensables à l’utilisation de TotEM sont détaillés dans les documents de référence. Pour rappel, afin de télétransmettre ses documents budgétaires, la collectivité doit :
Utiliser un progiciel financier compatible
Disposer d’un accès Internet
Avoir signé avec la préfecture une convention permettant la transmission au contrôle de légalité de pièces dématérialisées via l’application ACTES
5
Guide d’installation de TotEM
Des prérequis techniques sont indispensables pour installer TotEM :
Disposer des droits ADMINISTRATEUR sur la machine.
Si ce n’est pas le cas le message d’erreur suivant sera affiché :
Disposer d’une version récente de Java sur la machine (JRE 1.6 ou version supérieure).
Si ce n’est pas le cas le message suivant sera affiché :
Un lien sur le site odm-budgetaire.org
vous permet d’installer facilement la
dernière version de java sur votre PC.
Suivez les indications qui s’affichent à
l’écran pour télécharger gratuitement
Java et l’installer sur votre poste.
6
Guide d’installation de TotEM
Afin de s'adapter à la taille de votre collectivité et de vos équipes, TotEM permet les deux modes de fonctionnement suivants :
Monoposte :
Utilisez ce mode si vous travaillez seul sur l'enrichissement des flux budgétaires.
Les flux créés ou importés dans TotEM ne seront utilisables et disponibles que sur l’ordinateur où est installé TotEM.
TotEM est préconfiguré pour fonctionner dans ce mode sans aucune intervention de votre part.
Client-serveur (multiposte) :
Utilisez ce mode si vous travaillez en équipe sur l'enrichissement des flux budgétaires.
Les flux créés ou importés dans TotEM seront utilisables et disponibles sur tous les ordinateurs disposant de TotEM et reliés au serveur.
Ce mode nécessite l'installation préalable de TotEM serveur.
7
Guide d’installation de TotEM
Pour installer TotEM en mode monoposte, il suffit de suivre les indications contenues dans ce document dans le chapitre « Installer TotEM Client ».
Vous n’êtes pas concerné par les chapitres concernant TotEM Serveur.
8
Guide d’installation de TotEM
Pour installer TotEM en mode client-serveur, il faut:
Récupérer la « version serveur » de TotEM pour l’installer sur le serveur.
Chapitres « Installer TotEM Serveur Autonome » ou « Installer TotEM Serveur application War » selon le type de serveur.
Récupérer la « version monoposte ou client » de TotEM pour l’installer sur les PC des utilisateurs finaux de TotEM.
Chapitre « Installer TotEM Client ».
Remarque: il existe deux modes d’installation de la partie serveur:
Serveur autonome : il s’agit d’une installation clé en main du serveur. Un « installeur » simple est livré : il permet d’installer TotEM Serveur avec un serveur d’application intégré. Ce serveur autonome ne fonctionne que sous Windows (pas sous Linux, Unix…).
Serveur Application War : un War de TotEM Serveur est disponible. Il permet d’installer TotEM sur un serveur Tomcat par exemple. Vous pourrez le configurer comme vous le souhaitez. Ceci est à destination des utilisateurs avertis.
9
TotEM Guide d’installation de l’application
2. Installer le serveur (autonome) Télécharger TotEM Serveur Autonome 11
Installer TotEM Serveur Autonome 12
Configurer TotEM Serveur Autonome 13
Menu Démarrer 16
Service Windows 17
Installer les postes TotEM Client 18
Guide d’installation de TotEM
Un clic sur le lien permet d’enregistrer le fichier d’installation de la version Serveur Autonome
1
2
Le fichier sera enregistré sur le PC
3
11
Guide d’installation de TotEM
Cliquer sur le bouton Exécuter pour installation TotEM Serveur Autonome
1
Appuyer de nouveau sur le bouton Exécuter
2
L’assistant d’installation s’ouvre. Vous pouvez laisser les paramètres par défaut ou modifier: -Nom du répertoire d’installation -Libellé dans le menu Démarrer -Choisir de ne pas installer en tant que service automatique.
3
L’installation de la partie serveur est terminée
4
12
Guide d’installation de TotEM
A la fin de l’installation, il vous est proposé de configurer TotEM Serveur Autonome.
Pour une configuration ultérieure, l’accès se fait à partir du menu « Démarrer ».
L’écran de paramétrage s’affiche et
comporte 4 onglets:
HTTP
Général
DSC
PRINT COMP
13
Guide d’installation de TotEM
Dans l’onglet HTTP vous pouvez modifier:
Port d’écoute
Chemin de l’application serveur
Dans l’onglet Général vous pouvez modifier :
Dossier de travail :
Répertoire dans lequel sont stockés les flux documents budgétaires intégrés dans TotEM
Nombre maximal de thread de calcul :
Dans le cas où TotEM est exécuté sur une machine très puissante avec plusieurs processeurs par exemple, il est possible de spécifier le nombre de thread en parallèle qui pourront s’exécuter (1 par défaut)
URL de mise à jour :
URL du site qui héberge les maquettes des documents budgétaires mises à disposition par la DGCL
Dossier de travail temporaire :
Possibilité de stocker les fichiers de travail temporaire dans un répertoire différent du « user_home » de l’utilisateur connecté.
Les informations concernant le proxy:
Certaines informations sont à remplir obligatoirement si un proxy est utilisé pour accéder à Internet
14
Guide d’installation de TotEM
Dans l’onglet DSC ou PRINT-COMP, vous pouvez modifier :
Fichier jar :
Emplacement des fichiers dsc.jar ou print-comp.jar qui permettent de traiter les informations qui seront affichées dans le document budgétaire rematérialisé
URL de téléchargement :
URL du site qui héberge les maquettes budgétaires mises à disposition par la DGCL, les composants de totalisation entre autres.
Pour terminer la configuration:
Enregistrer la configuration
Arrêter et redémarrer le service TotEM Serveur.
15
Guide d’installation de TotEM
Une fois Totem Serveur installé, une entrée de menu TotEM serveur apparait dans le menu « Démarrer ».
Deux sous menus sont disponibles :
TotEM serveur (Service) : à utiliser si vous avez choisi le mode de démarrage automatique lors de l’installation (proposé par défaut).
TotEM serveur (Manuel) : à utiliser si vous n’avez pas choisi le mode de démarrage automatique lors de l’installation.
16
Guide d’installation de TotEM
Vous pouvez vérifier que TotEM Serveur tourne en tant que service Windows.
Cliquer sur « Services »
1
TotEM serveur apparait en tant que services Windows
2
17
Guide d’installation de TotEM
Une fois TotEM Serveur Autonome installé, vous pouvez installer TotEM Client sur les postes des utilisateurs finaux:
Vous devez noter l’adresse à fournir aux postes clients.
Cette adresse est au format :
http://<nom du serveur>:<port d’écoute>/<chemin de l’application serveur>
Par exemple : http://seurat:8080/
Veuillez vous référer au chapitre « Installer TotEM Client » de ce document pour poursuivre l’installation.
18
TotEM Guide d’installation de l’application
3. Installer le serveur (application War) Télécharger le serveur Application War 20
Installer le serveur Application War 21
Installer les postes TotEM Client 24
Guide d’installation de TotEM
Un clic sur le lien permet d’enregistrer le fichier d’installation de la version Serveur Application War
1
2
Le fichier sera enregistré sur le PC
3
20
Guide d’installation de TotEM
Vous avez récupéré un fichier War. Ce War doit être déployé dans un serveur d’application J2EE, avec un JRE 1.6 minimum.
Ce War a été testé dans le cadre d’un déploiement sous Tomcat 6.
Description succincte de l’installation :
Récupérer le fichier War
Ouvrir le fichier web.xml contenu dans le fichier War et le modifier en fonction de votre environnement.
Remarque: il n’y a pas d’écran de configuration dans TotEM serveur Application War. En effet, toutes les informations de configuration sont dans le fichier web.xml
21
Guide d’installation de TotEM
Les éléments à modifier dans le fichier web.xml sont :
root.location :
Répertoire dans lequel seront stockés:
• les documents budgétaires sur lesquels les utilisateurs travaillent
• les maquettes réglementaires récupérées automatiquement sur internet
Par défaut, la valeur de cette variable est : /Application/TOTEM_SERVEUR/repository
Il est préférable d’éviter de créer ces répertoires dans le répertoire webapp de tomcat pour éviter de tout perdre lors du redéploiement de l’application.
odm.dsc.jar.file :
Emplacement et nom du jar de totalisation (dsc.jar)
Par défaut, la valeur de cette variable est : /Application/TOTEM_SERVEUR/tools/dsc.jar.
Le répertoire tools et son contenu sont à mettre en place manuellement (cf. page suivante).
odm.print-comp.jar.file :
Emplacement et nom du jar de rematérialisation (print-comp.jar)
Par défaut, la valeur de cette variable est : /Application/TOTEM_SERVEUR/tools/print-comp.jar.
Le répertoire tools et son contenu sont à mettre en place manuellement (cf. page suivante).
22
Guide d’installation de TotEM
Il faut récupérer les fichiers dsc.jar et print-comp.jar sur le site odm-budgetaire.org. Ces fichiers devront être déposés dans le répertoire défini précédemment.
Vous pouvez récupérer dsc.jar ici.
1
Et vous pouvez récupérer print-comp.jar ici.
2
23
Guide d’installation de TotEM
Une fois TotEM Serveur Application War installé, vous devez démarrer le serveur d’application puis vous pouvez installer TotEM Client sur les postes des utilisateurs finaux:
Vous devez noter l’adresse à fournir aux postes clients.
Cette adresse est au format :
http://<nom du serveur>:<port d’écoute>/<chemin de l’application serveur>
Par exemple : http://seurat:8080/
Veuillez vous référer au chapitre « Installer TotEM Client » de ce document pour poursuivre l’installation.
Remarque : l’URL http://<serveur>:<port>/totem ne fonctionnera pas dans un navigateur. Il ne s’agit pas d’une application Web. Il faut renseigner cet url dans TotEM client et vérifier que ça fonctionne.
24
TotEM Guide d’installation de l’application
4. Installer le client TotEM Télécharger TotEM Client 26
Installer TotEM Client 28
Configurer TotEM Client 31
Pour un fonctionnement monoposte
Pour un fonctionnement avec un serveur
Guide d’installation de TotEM
L’application TotEM Client est disponible sur le site http://odm-budgetaire.org/
avec ce document d’installation.
TotEM Client doit être installé :
Si vous utilisez TotEM en mode monoposte:
Sur le poste de l’unique utilisateur de TotEM
Si vous utilisez TotEM en mode client-serveur:
Sur le poste de chaque utilisateur de TotEM
Seul le paramétrage de l’application TotEM Client, décrit à la fin de ce chapitre, sera différent selon le mode d’utilisation que vous avez choisi.
26
Guide d’installation de TotEM
Un clic sur le lien permet d’enregistrer le fichier d’installation de la version TotEM Client
1
2
Le fichier sera enregistré sur le PC
3
27
Guide d’installation de TotEM
Cliquer sur le bouton Exécuter pour débuter l’installation
Lancement de l’installation de TotEM Client
Appuyer sur le bouton « Suivant> »
Cocher la case « Je comprends et j’accepte… » après avoir lu le contrat de licence. Puis appuyer sur le bouton « Suivant > »
1
3 4
Puis appuyer de nouveau sur le bouton Exécuter
2
Cliquer sur le bouton « Suivant > » (modification du dossier d’installation possible)
5
28
Guide d’installation de TotEM
Cliquer sur le bouton « Suivant > » (modification possible du nom de l’entrée TotEM dans le menu « Démarrer »)
Lancement de l’installation de TotEM Client
6
Cliquer sur le bouton « Suivant > »
7
Le résumé de l’installation s’affiche. Si tout est correct, cliquer sur le bouton « Installer »
8
Cliquer sur le bouton « Terminer »
9
29
Guide d’installation de TotEM
L’installation est terminée.
TotEM apparait dorénavant parmi les applications disponibles dans le menu « Démarrer ».
Suite à l’exécution de TotEM, l’application TotEM s’ouvre.
30
Guide d’installation de TotEM
Lors du premier démarrage de TotEM Client, l’écran de configuration s’ouvre automatiquement.
Ultérieurement, pour accéder aux fonctionnalités de paramétrage de TotEM Client:
Cliquer sur le bouton en bas à gauche de l’écran d’accueil.
Cliquer sur le bouton pour accéder aux écrans de paramétrage
1 2
31
Guide d’installation de TotEM
Si vous avez choisi d’utiliser TotEM en
mode monoposte, vous devez choisir
« Monoposte »
L’onglet Général permet de modifier les informations concernant le proxy:
Certaines informations sont à remplir obligatoirement si un proxy est utilisé pour accéder à Internet.
Ces informations sont à récupérer auprès de votre administrateur réseau.
Les onglets DSC et PrintComp permettent de renseigner l’url de téléchargement des mises à jour des maquettes.
Ces informations sont pré-renseignées par défaut.
Lorsque la configuration est effectuée, vous devez fermer et redémarrer TotEM pour tenir compte des nouveaux paramètres.
Choisissez Monoposte
32
Guide d’installation de TotEM
Si vous avez choisi d’utiliser TotEM en mode client-serveur, vous devez
Choisir « Connecté à un serveur
TotEM ».
Choisissez « Connecté à un serveur TotEM »
Dans l’onglet général, vous devez renseigner l’url d’accès à TotEM Serveur.
2
La page suivante vous décrit la manière de récupérer l’url d’accès au serveur Totem.
1
33
Guide d’installation de TotEM
Dans les paramètres de configuration de Totem Serveur, dans l’onglet http, vous voyez le port d’écoute et le chemin de l’application. Avec ceci vous pouvez construire l’url à mettre dans l’onglet général du client : http://<nom DNS du serveur TotEM>:<Port d’écoute visible dans l’onglet HTTP>/<Chemin de l’application serveur visible dans l’onglet http>
Dans l’onglet général du poste client, vous pouvez alors renseigner l’url d’accès à TotEM Serveur.
4
5 Puis appuyer sur « Enregistrer » .
3
34
TotEM Guide d’installation de l’application
5. Sauvegarder les données de TotEM Sauvegarder les données 36
Restaurer les données 39
Guide d’installation de TotEM
Les documents budgétaires utilisés dans TotEM sont conservés sur le disque dur soit:
De l’ordinateur sur lequel est installé TotEM (utilisation en mode monoposte)
Du serveur (utilisation en mode client-serveur)
Une sauvegarde supplémentaire des données peut être effectuées via TotEM pour conserver un duplicata des documents sur un autre support que le disque dur.
Cliquer sur le bouton pour accéder à l’écran de sauvegarde
36
Guide d’installation de TotEM
Choisissez le nom du dossier dans lequel vous souhaitez enregistrer le fichier de sauvegarde des données
1
2 Choisissez le nom du fichier
Appuyez sur le bouton Enregistrer 3
Un fichier .zip est créé. Il contient l’ensemble des documents budgétaires (scellés et non-scellés) utilisés dans TotEM.
37
Guide d’installation de TotEM
Le fichier de sauvegarde ainsi récupéré représente le répertoire de travail de TotEM.
38
Le répertoire ou dossier de travail est paramétré dans l’onglet « Configuration », dans la zone « Dossier de travail ». Dans cette exemple, il s’agit d’un chemin relatif « ../repository ». Ce chemin prend son départ dans le répertoire racine de TotEM qui est C:\Program Files\TOTEM\bin.
1
3
Le répertoire de travail (repository) se retrouve dans le fichier zip. Remarque : Il est possible que le contenu du fichier zip s’affiche mal dans certain outils comme 7zip (le fichier semble vide!) alors que le contenu s’affiche bien avec Winzip par exemple.
2
Guide d’installation de TotEM
A partir d’un fichier de sauvegarde, vous pouvez restaurer TotEM et les documents tel qu’ils étaient lors de la sauvegarde.
Le répertoire de travail se retrouve dans le fichier zip. En fait c’est « le répertoire de plus haut niveau » dans lequel est déposé le repository : Par exemple, pour « ../chemin1/chemin2/chemin3 », le fichier zip contiendra « chemin3 ».
1
2
3
39
Vous devez vérifier ce qu’il y a dans le fichier zip comme répertorie racine pour être sûr d’extraire le contenu du fichier zip au bon endroit pour restaurer les informations dans TotEM. Remarque : • Vous devez au préalable arrêter TotEM client et
TotEM Serveur, puis quand vous aurez fini, vous pourrez les redémarrer,
• Vous devez « vider » le contenu de votre répertoire « repository » avant de restaurer le fichier zip,
• Il est possible que le contenu du fichier zip s’affiche mal dans certain outils comme 7zip (le fichier semble vide!) alors que le contenu s’affiche bien avec Winzip par exemple.
TotEM Guide d’installation de l’application
6. Montée de version de TotEM 1.1 vers TotEM 1.2 Sauvegarder les données 41
Installer TotEM 42
Restaurer les données 43
Guide d’installation de TotEM
Sur votre PC, TotEM 1.1 était installé et vous souhaitez maintenant installer TotEM 1.2.
Vous pouvez sauvegarder les données existantes dans TotEM si vous le souhaitez (tous les budgets existant par exemple).
Vous récupérez donc un fichier « avant_totem_1_2.zip ».
Vous devez vérifiez que la taille du fichier généré est différente de 0 Ko (il faut attendre quelques minutes) : si ce n’est pas le cas, il vous faudra contacter le support.
41
Cliquer sur le bouton pour accéder à l’écran de sauvegarde
Spécifier le nom du fichier (exemple avant_totem_1_2.zip) et appuyer sur enregistrer.
Guide d’installation de TotEM
Installer TotEM 1.2.X (TotEM client, TotEM serveur… : comme vous voulez) via les installeurs disponibles sur le site odm-budgetaire.org.
Une fois l’installation terminée, fermer TotEM et arrêter le service TotEM serveur si vous avez installé un serveur TotEM.
42
Guide d’installation de TotEM
Restaurer les données TotEM
A partir d’un fichier de sauvegarde, vous pouvez restaurer TotEM et les documents tel qu’ils étaient lors de la sauvegarde.
Si vous avez installé TotEM Client autonome, voici votre arborescence :
Vous devez supprimer le répertoire « repository »
Ensuite vous déposez le fichier zip précédemment récupéré (« avant_totem_1_2.zip ») dans le répertoire data, puis vous devez « extraire ici » le contenu du fichier zip.
43
Le répertoire data est un raccourci vers un autre répertoire, situé dans « Program Files » ou bien dans « ProgramData » selon la version de Windows utilisée
Guide d’installation de TotEM
Si vous avez installé TotEM Serveur, voici votre arborescence :
Vous devez supprimer le répertoire « repository »
Ensuite vous déposez le fichier zip précédemment récupéré (« avant_totem_1_2.zip ») dans le répertoire data, puis vous devez « extraire ici » le contenu du fichier zip.
44
Le répertoire data est un raccourci vers un autre répertoire, situé dans « Program Files » ou bien dans « ProgramData » selon la version de Windows utilisée
TotEM Guide d’installation de l’application
7. Problème de version java
45
Guide d’installation de TotEM
Problème avec java :
Le message « TOTEM nécessite JAVA version 1.6 ou supérieure. Veuillez corriger votre JAVA_HOME ou votre PATH et réessayer. Appuyez sur une touche pour continuer » s’affiche alors que java est installé.
Si java est installé, si vous tapez la commande « java –version » dans une fenêtre MS-DOS, vous obtiendrez en retour le numéro de version de java installé, qui doit être supérieur ou égal à 1.6 pour TotEM.
Si java n’est pas installé ou est mal configuré, vous obtiendrez un message d’erreur.
Résolution du problème
Si java n’est pas installé, pour pouvez l’installer via le lien présent sur le site odm-budgetaire.org.
46
Guide d’installation de TotEM
Résolution du problème (suite)
Si java est installé mais n’est pas accessible via les commandes proposées ci-dessus, alors il faut soit modifier le paramétrage de Windows pour que Java 6 devienne la version lancée par défaut, soit modifier le script de configuration de TotEM.
La modification du paramétrage de Windows n'est pas un sujet traitable ici. Rapprochez-vous de vos SAU (Service d'Assistance Utilisateur), administrateur Réseau, etc... pour réaliser cette opération.
La modification du script de configuration de TotEM est aisée :
1. Tout d'abord il faut savoir où Java 6 est installé. Généralement, il faut chercher dans le répertoire C:\Program Files\Java\jre6
2. Ensuite, modifiez le fichier C:\Program Files\Totem\bin\SetEnv.bat
3. Après, remplacez la ligne « rem set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_02 » par « set JAVA_HOME=C:\Program Files\Java\jre6 »
47