TotEM - Collectivités locales · Problème de version Java 45 . TotEM Guide d’installation de l’application 1. Introduction Le projet Actes Budgétaires 4 L’application TotEM

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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


Un clic sur le lien permet d’enregistrer le fichier d’installation de la version Serveur Application War

1

2


3

20


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


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


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


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

http://seurat:8080/totem






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


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


Un clic sur le lien permet d’enregistrer le fichier d’installation de la version TotEM Client

1

2


3

27


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


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


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


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


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


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


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


5. Sauvegarder les données de TotEM Sauvegarder les données 36

Restaurer les données 39


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


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


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


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.


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


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.


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


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


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


7. Problème de version java

45


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


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

Documents

TotEM - Collectivités locales · Problème de version Java 45 . TotEM Guide d’installation de l’application 1. Introduction Le projet Actes Budgétaires 4 L’application TotEM