Installation Interface IE Transics

Installation de l'interface Informatique embarquée
Transics
1.
2.
3.
4.
Pré requis ............................................................................................................................ 2
Installation Java .................................................................................................................. 2
Installation Tomcat ............................................................................................................. 2
Installation SynIE ............................................................................................................... 3
4.1. config.properties .......................................................................................................... 3
4.1.1. transicsID ............................................................................................................. 3
4.1.2. typeDB ................................................................................................................. 3
4.1.3. get.tachyDataTable ............................................................................................... 3
4.1.4. synersysXML ....................................................................................................... 4
4.1.5. Resources ............................................................................................................. 4
4.2. dbcp.properties ............................................................................................................ 4
4.2.1. Connexion à la base Transics ............................................................................... 4
4.2.2. Connexion à la base Synersys .............................................................................. 4
5. Configuration Synersys ...................................................................................................... 5
5.1. Paramètres ................................................................................................................... 5
5.2. Traitements asynchrones ............................................................................................. 6
1. Pré requis
-
-
Connaître les informations de connexion à la base de donnée Transics :
o Type (Oracle ou Sybase)
o IP, port, login et mot de passe
Synersys installé avec sur l'un des serveurs les services SynBatch et
SextantMessageService opérationnels.
2. Installation Java
Le module qui lit et écrit dans la base Transics (SynIE) est une WebApplication écrite en Java
et qui s'exécute avec le serveur Tomcat.
L'installation de Java, Tomcat et SynIE doit donc se faire sur le même serveur, celui –ci peut
être différent de celui où se trouvent Synbatch et SextantMessageService.
Pour installer Java lancer le setup qui se trouve dans le répertoire "1 Installation Java" et
laisser les paramètres par défaut.
3. Installation Tomcat
Pour installer Tomcat lancer le setup qui se trouve dans le répertoire "2 Installation Tomcat".
Tout peut être laissé par défaut sauf sur cet écran :
Pour le mot de passe mettre 'admin'. Le port doit être modifié s'il est déjà utilisé sur ce serveur
ou sur le réseau (voir avec le service informatique du client).
Pour vérifier que l'installation s'est bien effectuée ouvrir un navigateur et taper cette url :
http://127.0.0.1:8080/ (Remplacer 8080 par le bon port si vous l'avez modifié pendant
l'installation).
Tomcat s'installe comme service ("Apache Tomcat"). Avant de poursuivre vérifier que le
service est en type de démarrage Automatique et qu'il est arrêté.
4. Installation SynIE
Adresse de téléchargement pour la dernière version :
http://sextant.nerim.net/SynIE/
Dans le répertoire "3 Installation SynIE » exécuter le fichier SynIE_xx
Suivant la version de Tomcat installée, vérifier le répertoire d’installation.
Ex :
C:\Program Files\Apache Software Foundation\Tomcat 6.0
Plusieurs fichiers de configuration sont à modifier, ils se trouvent dans :
SynIE\WEB-INF\classes
4.1.
config.properties
4.1.1. transicsID
Indiquer le numéro de système Transics. Si le client ne le connaît pas se connecter à la base
Transics et effectuer la requête suivante :
select max(NR_SYSTEM) from BCI_ANSWER_TRA
Ex pour Transalliance :
transicsID=2250
4.1.2. typeDB
Indiquez le type de base de donnée : dbOracle ou dbSybase.
4.1.3. get.tachyDataTable
Supprimer cette ligne si client != Transalliance. Cette option est nécessaire aux clients qui
évoluent en mode Transics désynchronisé, pour le moment seul Transalliance est dans ce cas.
4.1.4. synersysXML
Indiquer ici l'IP du serveur qui héberge le service SextantMessageService.
4.1.5. Resources
Si cette option est égale à 1 cela active la connexion à la base Synersys, il faut alors entrer
correctement les paramètres de connexion dans le fichier dbcp.properties.
La liste des paramètres ainsi que leur fonctionnalité est décrite dans le menu « Informations »
de SynIE
4.2.
dbcp.properties
ATTENTION AUX ESPACES
4.2.1. Connexion à la base Transics
Si Sybase indiquer l'IP et le port de la base Transics, ex:
jdbc.URL=jdbc:sybase:Tds:192.168.0.26:2638
Si Oracle indiquer l'IP, le port et le nom de l'instance, ex :
jdbc.URL=jdbc:oracle:thin:@10.35.1.47:1521:TRANSSTG
Indiquer les identifiants de connexion à la base Transics.
4.2.2. Connexion à la base Synersys
Exemple de config pour la connexion SynSTG :
#Synersys AS400############## com.ibm.as400.access.AS400JDBCDriver
jdbc.driver.synersys=com.ibm.as400.access.AS400JDBCDriver
jdbc.URL.synersys=jdbc:as400://192.168.0.48/SYNSTGFO
user.synersys=SYNERSYS
password.synersys=SYNERSYS
#jdbc.validityCheckStatement.synersys=
Une fois les modifications effectuées démarrer le service Apache Tomcat.
Puis taper cette url dans un navigateur :
http://127.0.0.1:8080/SynIE
Cet écran présente les statistiques de lecture et d'écriture dans la base Transics. Si tout est
correct les compteurs vont s'incrémenter au fil des minutes. De plus chaque donnée lue est
transmise au service SextantMessageService. Ce dernier stocke les données dans des fichiers
XML nommé XXX_0.xml (avec XXX qui s'incrémente) dans le répertoire
C:\sextant\SextantMessageService0 du serveur sur lequel il est installé.
Tomcat génère un fichier log (SynIE.log) dans C:\Program Files\Apache Software
Foundation\Tomcat 6.0\ ou c:\windows\system32
5. Configuration Synersys
5.1.
Paramètres
Les paramètres suivants doivent être renseignés.
[IESERVER] IE_TRANSICS_7201_0
Contient l'adresse du serveur Tomcat (IP:PORT:/SynIE/RPC) Ex :
192.168.0.203:8080:/SynIE/RPC
Cette variable est utilisée en émission (envoi / annulation de mission, envoi de messages
libres).
[MESSAGESERVER] SERVERADDRESS
Contient l'adresse du serveur sur lequel se trouve le service SextantMessageService
(IP:PORT) Ex :
192.168.0.203:9000
Cette variable est utilisée en réception pat le traitement asynchrone LMSGRE (cf. plus bas).
[INFORMATIQUE_EMBARQUEE] IE_MESSAGES_MAX_ENREGS
Nombre maximum d'enregistrements dans la table IEMSGP. A définir en fonction de la taille
de la flotte. (Chez STG : 2 000 000).
[INFORMATIQUE_EMBARQUEE] IE_PRESENTE
=> Vrai
[INFORMATIQUE_EMBARQUEE] TRANSICS_ID_EXPLOITANT
=> 1
[INFORMATIQUE_EMBARQUEE] TRANSICS_PRESENT
=> Vrai
[INFORMATIQUE_EMBARQUEE] TYPE_CII_CONDUCTEUR
=> 7101
[INFORMATIQUE_EMBARQUEE] TYPE_CII_EXPLOITANT
=> 7103
[INFORMATIQUE_EMBARQUEE] TYPE_CII_VEHICULE
=> 7102
[INFORMATIQUE_EMBARQUEE] TYPE_IE
=> 7201
[INFORMATIQUE_EMBARQUEE] ENVOI_OT_AUTO
=> 2
[INFORMATIQUE_EMBARQUEE] DECLENCHE_ENVOI
=> 0
5.2.
Traitements asynchrones
Plusieurs traitements asynchrones sont à créer :
LMSGRE
Ce traitement récupère les données issues de la base Transics et qui ont été stockées dans le
répertoire C:\sextant\SextantMessageService0 par SextantMessageService. Ensuite il les
insère dans le table IEMSGP. Il prend un paramètre de type numérique qui correspond au
nombre de messages qu'il va lire à chaque exécution (Important : ne pas fixer ce paramètre à
plus de 900). Dans l'agenda le programmer toutes les minutes.
Une fois créé, vérifier que de nouvelles données intègrent la table IEMSGP.
TIEMSG
Ce programme traite les données insérées dans IEMSGP. Dans l'agenda le programmer toutes
les minutes.
Lorsqu'il s'exécute il traite les données qui ont IETIMS = 1, puis met à jour les champs
suivant :
IETIMS : 2 si ok, 3 si erreur, 4 si avertissement
IDTIMS : Date et heure système
ITXIMS : Erreur / Trace
Une fois créé, vérifier que les données sont traitées.
Remarque : le document IE_MESSAGES.doc décrit le contenu de la table IEMSGP.
TIEEND
Envoi des dossiers aux Quattro, doit être planifié toutes les minutes.