Vous êtes sur la page 1sur 46

 

Net job scheduler 

Visual TOM
Formation
 Administrateurs

The job scheduling company 


 

Visual TOM-Support de formation administrateurs

SOMMAIRE

1 PRÉSENTATION................................................................................................................................4
1.1 VISUAL TOM SERVEURS (RÉFÉRENTIEL , ORDONNANCEUR)...............................................................................4
1.2 VISUAL TOM XVISION VT-XVI (CONCEPTION, PILOTAGE)...............................................................................4
1.3 VISUAL TOM CLIENTS (EXÉCUTION DES TÂCHES SUR UNE MACHINE)................................................................... 5
1.4 VISUAL TOM MODULES OPTIONNELS............................................................................................................5
2 ARCHITECTURE TECHNIQUE..........................................................................................................6

3 INSTALLATION DES MODULES DE BASE.......................................................................................8


3.1 INSTALLATION SOUS UNIX............................................................................................................................8
3.1.1 Préparatifs.................................................................................................................................. 8
3.1.2 Transfert du package logiciel......................................................................................................8
3.1.3 Le fichier de configuration de l'installation : install_vtom.ini.........................................................9
3.1.4 Déroulement de la procédure d’installation.................................................................................. 9
3.1.5 Validation de l’installation.......................................................................................................... 10
3.2 INSTALLATION SOUS WINDOWS NT.............................................................................................................13
3.2.1 Désinstallation..........................................................................................................................13
3.2.2 Conventions..............................................................................................................................13
3.2.3 Paramètres de l’installation....................................................................................................... 13
3.2.4 Déroulement de la procédure d’installation................................................................................ 15
3.2.5 Validation de l’installation.......................................................................................................... 15
4 CONFIGURATION DU SERVEUR VISUAL TOM..............................................................................17
4.1 LES PORTS DE COMMUNICATION DU SERVEUR VISUAL TOM.............................................................................. 17
4.2 LES VARIABLES  D’ENVIRONNEMENT DE L’ ADMINISTRATEUR DE VISUAL TOM POUR UN SERVEUR UNIX......................... 17
4.3 LES VARIABLES  D’ENVIRONNEMENT POUR UN SERVEUR WINDOWS......................................................................18
4.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................18
4.5 P ARAMÉTRAGE DE LA PROCÉDURE DE COMMUNICATION DES MOTEURS  AVEC LES CLIENTS.........................................19
4.6 L A MISE EN PLACE DES TRACES DES MOTEURS...............................................................................................20
4.7 PRODUCTION DE TABLEAUX  DE BORDS DES JOURNÉES D’EXPLOITATION PRÉCÉDENTES.............................................21
4.8 L’HISTORIQUE.........................................................................................................................................
21
5 LES COMMANDES D’UN MODULE SERVEUR...............................................................................22
5.1 S AUVEGARDE ET RESTAURATION D’UNE BASE.................................................................................................22
5.1.1 Sauvegarde du répertoire de la base de données..................................................................... 22
5.1.2 Liste le contenu de la base dans un fichier texte.......................................................................22
5.1.3 Import des objets définis dans un fichier texte........................................................................... 22
5.2 L A GESTION DES MOTEURS........................................................................................................................23
5.2.1 Démarrage d’un moteur sur un Environnement......................................................................... 23
5.2.2 Arrêt d’un moteur sur un Environnement................................................................................... 23
5.2.3 Remise à OFF du flag moteur de l’interface graphique pour un environnement.........................23
5.2.4 Test de présence d’un moteur actif pour un environnement......................................................23
5.2.5 Vérification des blocages de date..............................................................................................23
6 CONFIGURATION DU CLIENT VISUAL TOM.................................................................................. 24
6.1 LES PORTS DE COMMUNICATION UTILISÉS PAR UN CLIENT..................................................................................24
6.2 LES VARIABLES  D’ENVIRONNEMENT DE L’ ADMINISTRATEUR DU CLIENT VISUAL TOM SOUS UNIX.................................24
6.3 LES VARIABLES  D’ENVIRONNEMENT WINDOWS D’UN CLIENT VISUAL TOM............................................................25
6.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................25
6.5 LES QUEUE BATCH...................................................................................................................................
26
2/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

6.5.1 Configuration d’une queue batch sous un client Unix................................................................26


6.5.2 Configuration d’une queue batch sous un client Windows.........................................................27
6.6 LES SUBMITTER ......................................................................................................................................
27
6.7 GESTION DES LOGS.................................................................................................................................28
7 CONFIGURATION D’UNE IHM VISUAL TOM..................................................................................30
7.1 LES PORTS DE COMMUNICATION UTILISÉS PAR UNE IHM...................................................................................30
7.2 LES VARIABLES  D’ENVIRONNEMENT DE L’ ADMINISTRATEUR DE L’IHM SOUS UNIX................................................... 31
7.3 LES VARIABLES  D’ENVIRONNEMENT SYSTÈME WINDOWS D’UNE IHM.................................................................... 31
7.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................31
7.5 MISE EN PLACE DES FONCTIONNALITÉS DOCUMENTATION ET CONSIGNES..............................................................32
8 CONCEPTION ET PILOTAGE DE LA PRODUCTION EN MODE COMMANDE...............................34
8.1.1 Ajout ou modification d’objets dans le domaine d’exploitation....................................................34
8.2 AJOUT ET MODIFICATION D’UNE  APPLICATION..................................................................................................35
8.3 AJOUT OU MODIFICATION D'UN TRAITEMENT.................................................................................................... 37
8.4 SUPPRESSION D'UN TRAITEMENT.................................................................................................................39
8.5 SUPPRESSION D’UN LIEN...........................................................................................................................
39
9 INSTALLATION DES MODULES ISUPERVISER ............................................................................ 40
9.1 INSTALLATION DE LA PASSERELLE I-SERVER...................................................................................................40
9.2 INSTALLATION DU MODULE I-SUPERVISER......................................................................................................41
10 GUIDE DE L’UTILISATEUR DU SUPPORT STANDARD............................................................... 43
10.1 ASSISTANCE TELEPHONIQUE.....................................................................................................43
10.1.1 Comment nous contacter........................................................................................................43
10.1.2 Avant d’appeler le support.......................................................................................................43
10.1.3 Informations à fournir pour toute demande d’assistance technique.......................................... 43
10.1.4 Dans quels cas appeler le support.......................................................................................... 43
10.1.5 Conditions d’accès au support................................................................................................ 44
10.2 MAINTENANCE DES SYSTEMES VISUAL TOM........................................................................... 44
10.2.1 Sauvegarde et restauration ....................................................................................................44
10.2.2 Environnement de test ...........................................................................................................44
10.2.3 Gestion de vos espaces .........................................................................................................45
10.2.4 Installation de version ............................................................................................................ 45

Copyright © ABSYSS. All rights reserved 91157135.doc  3/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

1 Présentation
Les modules Visual TOM sont classées en quatre familles de modules

1.1 Visual TOM Serveurs (Référentiel, Ordonnanceur).

• Visual TOM Enterprise Server (VT-SES)


Visual TOM Enterprise Server est l’élément de base de toute architecture. Il inclut le
référentiel de production, les outils de conception du référentiel, le pilotage de
l’exploitation, le système expert de planification et d’ordonnancement, les APIs et la
documentation on-line. Il peut être installé indifféremment sur des machines UNIX ou
Windows NT.

• Visual TOM Departmental Server (VT-SDS)


Le serveur departemental gère l'autonomie des sites distants. Il répartit la charge
dans une architecture distribuée. Il nécessite la présence d’un module Enterprise
Server. Il peut être installé indifféremment sur des machines UNIX ou NT.

• Visual TOM Back Up Server (VT-SBU)


Le serveur BACKUP relaye automatiquement un serveur Visual TOM en cas
d’incident. Ce module est systématiquement mis en place dans les productions
nécessitant un niveau de sécurité optimal. Il peut être installé indifféremment sur des
machines UNIX ou NT.

1.2 Visual TOM XVision VT-XVI (Conception, Pilotage)

• Visual TOM IHM


C’est une interface graphique groupware déportée sur un LAN ou un Wan, connecté à
tout type de serveur Visual TOM (y compris les NetClients)
Elle permet la modélisation, la gestion et le pilotage de la production multi plates-
formes UNIX et Windows NT/95.

• Visual TOM I-Superviser 


C’est un ensemble de fonctionnalités permettant de suivre le déroulement d'une
production gérée par Visual TOM. Cette fonctionnalité a été étudiée pour permettre le
suivi de la production via un réseau bas débit (RTC, Internet).

• Visual TOM WebDoc


C’est une Interface internet permettant de visualiser les caractéristiques des objets de
vos domaines d’exploitation Visual TOM : (ressources, calendriers, environnements,
applications, traitements ..)

4/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

1.3 Visual TOM Clients (Exécution des tâches sur une machine)

• Visual TOM Client (VT-CS)


C’est un client Visual TOM permettant la production informatique en architecture
Client/Serveur. Ces modules dépendent d’un Visual TOM serveur; ils reçoivent les
ordres de soumission en provenance de ceux-ci et exécutent les traitements batch.
(exemple. : Exécution d’une tâche sur une machine). Il peut être installé
indifféremment sur des machines UNIX ou NT, VAX/VMS, Open VMS, AS400,
GCOS7 et GCOS8.
• Visual TOM Net Client (VT-CN)
C’est un client Visual TOM qui posséde en local son propre référentiel de production,
lui garantissant l’autonomie de fonctionnement.  Il peut être installé indifféremment sur 
UNIX ou NT.

1.4 Visual TOM Modules optionnels


• Visual TOM Xframework (VT-XFR) :
C’est un module d’intégration possedant une plate-forme de supervision de systèmes
et de réseaux et/ ou d’application. Dans le cas d’OpenMaster et de PATROL, les
modules sont livrés sous forme d'agents packagés et certifiés offrant ainsi une
intégration optimale.

• Visual TOM Xapplication (VT-XAP) :


C’est un module d’intégration entre l’application Visual TOM et les grands progiciels du
marché (comme SAP R/3, BAAN, JDE, PEOPLE SOFT, ORACLE APPLICATIONS,
…).

Copyright © ABSYSS. All rights reserved 91157135.doc  5/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

2 Architecture technique

 A rchitecture technique
Ges tion référentiel de prod u
Tcp/ip
Tengine

Vtom Gestion graphique


   l
tomDBd
dserver 
   e serveur 
   é
   r
gw d
gserver 
   s
VT-SDS
   p
ntfy
pserver 
   m
VT-SES
   e
   t
Gestion des événements
   n
   e
   n Vtom tomDBd
dserver 
   o
   i
   t backup
   a gw d
gserver 
   c
   i
   l serveur 
   p ntfy
pserver 
   é
   R VT-SBU

tomDBd
Vtom
client bdaemon
bdaemon
VT-CS
vtom
Soumission des
batchs
tomDBd
Q u e u e sbatchs
Vtom gw d Queueksh
VT-XVISION ntfy Queue SAP
MrTOM A ffichage S crip
batch et log

Visual TOM possède une architecture de type Client/Serveur basée sur le protocole de
communication TCP/IP.

La communication avec le module serveur Visual TOM s’effectue à l’aide de trois processus.

 Le processus dserver  gère la base de données de la production . Ce processus


utilise le port de communication TCP tomDBd.

 Le processus gserver  gère les mises à jour graphiques sur toutes les IHM
connectées via le port TCP gwd.
6/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

 Le processus pserver reçoit, via le port TCP ntfy, les notifications de modifications


de la base de données.

 Le processus vtlserver gère la procédure de gestion des licences

La communication avec le module client s’effectue à l’aide du processus bdaemon ; ce


processus utilise le port TCP bdaemon.

Le processus vtom permet de lancer l’interface graphique

Le tableau suivant fournit la liste valeurs par défaut des ports TCP utilisés par Visual TOM.

tomdbd 20001/tcp
gwd 20002/tcp
ntfy 20003/tcp
bdaemon 20004/tcp
vtlicense 20006/tcp
NB : ces numéros de ports ne sont que des propositions. Il est possible de prendre
n’importe quel numéro de port non utilisé, mais pour la communication entre les
différentes machines, il est impératif que ces ports soient définis de la même manière sur 
chacune des machines .
Si les services de votre système Unix sont administrés par un serveur NIS, il sera nécessaire
de les mettre à jour sur  la machine serveur NIS s'ils ne sont pas présents.

Copyright © ABSYSS. All rights reserved 91157135.doc  7/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

3 Installation des modules de base


Les modules de base de Visual TOM sont :
 le module Serveur 
 le module Client
le module IHM

3.1 Installation sous Unix

3.1.1 Préparatifs
Pour installer Visual TOM, il est nécessaire d’avoir un compte utilisateur qui sera
administrateur de Visual TOM. Par  défaut  on utilise le compte vtom, mais il est possible de
 prendre n’importe quel autre utilisateur du système d’exploitation.
Visual TOM est fourni avec des procédures d’administration en c-shell, tc-shell, bourne shell
ou korn shell, ainsi l’utilisateur qui administrera Visual TOM pourra fonctionner 
indifféremment avec l'un de ces quatre shells.
 Attention, pour  l’installation de Visual TOM sur plusieurs machines (ex : 1 machine
serveur et deux clients distants), si l’utilisateur d’administration est le même , il doit avoir 
le même uid et gid sur toutes les machines.
 
Le mot de passe de root sera également nécessaire pour installer Visual TOM.

3.1.2 Transfert du package logiciel


 A partir du CDROM, sélectionnez le répertoire correspondant à votre système d’exploitation :
AIX ou HPUX ou SOLARIS, …
Puis, sélectionnez le package que vous allez installer. Le tableau suivant vous donne la
correspondance entre la solution Visual TOM à mettre en œuvre et le package à installer.

Solution Visual Package Pack Pack IHM Pack Client


TOM Serveur 
Enterprise server VT-SES  

Departemental VT-SDS  
Server 
Back-up server VT-SBU  

Client VT-CS 

Client Light VT-CSL 

Net Client VT-CN   

Net Client Light VT-CNL   

Xvision VT-XVI 

Copiez du CD-ROM vers le répertoire temporaire d’installation les fichiers nécessaires pour 
l’installation. Ces fichiers sont :
install_vtom script d'installation
install_vtom.ini fichier de configuration de l’installation
<module.os.version> module pour l'installation
Pour la copie des fichiers nécessaires à l’installation, il est recommandé d’utiliser un
système Windows, disposant d’un lecteur CD-ROM, et de transférer les fichiers par FTP. Les
modes de transfert des fichiers sont les suivants :
8/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

bin pour le fichier <module.os.version>


ascii pour les fichiers install_vtom et install_vtom.ini

 A partir de la version 4 de Visual TOM, il faut mettre en place le fichier de licences license.lic,
dans le cas d’une installation d’un module serveur. Ce fichier vous est fourni par le service
support d’Absyss et doit être copié dans le sous-répertoire bin du répertoire d’installation du
module Serveur de Visual TOM (cf paragraphe répertoires d’installation
<répertoire_installation_serveur>/vtom/bin).

3.1.3 Le fichier de configuration de l'installation : install_vtom.ini


Pour définir les paramètres de votre installation de Visual TOM, vous pouvez lancer 
directement le script d'installation. Il est cependant possible de paramétrer le fichier de
configuration install_vtom.ini, qui contient les paramètres par défaut (ex: installation de
plusieurs clients Visual TOM avec les mêmes paramètres).

3.1.4 Déroulement de la procédure d’installation

3.1.4.1 Lancement du script d’installation


Dans le répertoire d’installation temporaire où vous avez extrait les fichiers, sous l'utilisateur 
root, vérifiez que le fichier install_vtom est en mode exécutable, puis tapez la commande
suivante :

> ./install_vtom [ liste des modules à installer ]

Exemples :
installation de Visual TOM Enterprise Server et Visual TOM Client, version 4.2 HP-UX :
./install_vtom VT-SES-HPUX.42.Z VT-CS-HPUX.42.Z 

Une fois l’installation terminée il faut copier le fichier license.lic  dans le sous répertoire
bin du répertoire d’installation du pack serveur (../vtom/bin).

3.1.4.2 Confirmation des paramètres d’installation


 Après initialisation (lecture du fichier install_vtom.ini), les paramètres de l'installation vous
sont proposés.
- Type d'installation : client, serveur, IHM (seuls les packs à installer sont 
affichés)
- Solution serveur de backup : si vous disposez de cette solution, ses
 paramètres sont affichés
-  Administrateur Visual TOM 
- Répertoire de base de l'installation : sous lequel seront installées les
répertoires admin, abm (pack client), vtom (pack serveur) et visual (pack 
IHM).
-  Autres répertoires utilisés par Visual TOM (il est possible de les définir 
indépendamment du répertoire d'installation).
- Navigateur HTML si défini.
Si les paramètres de l'installation vous satisfont, validez, sinon tapez n puis Entrée.

3.1.4.3 Redéfinition des paramètres d’installation


Pour chacun des choix qui vous seront proposés, validez pour accepter le choix. Entrez la
nouvelle valeur suivie d'Entrée pour le redéfinir.
- Pack d'installation
- Solution serveur de backup : nom du serveur primaire ou de backup
- Répertoire de base de l'installation
-  Administrateur de Visual TOM 

Copyright © ABSYSS. All rights reserved 91157135.doc  9/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

- Navigateur HTML
- Répertoire de la base de données
- Répertoire de backup de la base de données
- Répertoire des fichiers statistiques
- Répertoire des traces du moteur 
- Répertoire des fichiers logs

3.1.4.4 Sauvegarde d'une installation précédente


Dans le cas où vous installez Visual TOM sur une installation existante, la base de données
est toujours conservée, les anciens répertoires admin et abm/config sont renommés en
admin.old  et abm/config.old , ce qui vous permet de conserver le paramétrage de la
précédente installation.
De plus, si vous avez choisi de sauvegarder l'installation précédente, tous les autres
répertoires seront conservés (renommés en .old).

3.1.4.5 Génération des fichiers de configuration :

vtom_init.[shell]
Il existe quatre fichiers d’initialisation vtom_init pour les shells sh, ksh, csh et tcsh.
Ces fichiers sont générés lors de l’installation et contiennent les définitions des
différentes variables d’environnement utiles à Visual TOM.

.vtom.ini
Le fichier .vtom.ini contient des paramètres de Visual TOM. Il est installé dans le
répertoire d’administration. Un lien est fait sur le home directory de l’administrateur 
Visual TOM.

.cshrc (ou .login) et .profile de l'administrateur de Visual TOM


On ajoute un appel au script vtom_init.[$SHELL].

fichiers boot_start_client et boot_start_server 


Ces fichiers, intégrés à la procédure de boot système, permettent de lancer Visual
TOM client ou serveur lors du démarrage de la machine.
fichier services.new
Ce fichier contient les noms et numéros de services TCP utilisés par Visual TOM.
Le contenu de ce fichier doit être inséré dans le fichier /etc/services.

3.1.4.6 Répertoires temporaires et script de désinstallation


Lors de l'installation, tous les fichiers et répertoires sont supprimés (cas d'une réinstallation)
et sont temporairement transférés dans le répertoire install_vtom.tmp.
De plus, un script de désinstallation est généré : uninstall_vtom.
Ce script permet de revenir à la situation de départ (avant l'installation) en cas de problème
lors du déroulement de l'installation.
Ce répertoire temporaire et le script de désinstallation sont normalement supprimés à la fin
de l'installation.
Vous pouvez cependant les conserver en interrompant le script d'installation lorsqu’ un
message est affiché (10 secondes vous sont alloués pour cette opération).

3.1.4.7 Journal d'installation


Vous trouverez la trace de cette installation de Visual TOM dans le fichier install_vtom.log.

3.1.5 Validation de l’installation


 Attention : Si on utilise exceed pour lancer xvision x11, dans la configuration exceed, au
niveau de la définition de l'écran, le paramètre "use native WM for embedded client" doit être
décoché.si ce paramètre est coché "à tort", cela peut provoquer des plantages sur xvision.
10/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

3.1.5.1 Accès à Visual TOM 

Connexion sous l’utilisateur d’administration Visual TOM


Connectez vous sous l’utilisateur d’administration Visual TOM défini lors de
l’installation afin de disposer des variables d’environnement Visual TOM.
Appel du menu admins
Lancez le menu d’administration Visual TOM par la commande admins :
> admins↵

Démarrage des serveurs


Dans le menu admins, choisissez l’option 2 - Démarrage des serveurs.
Lancement de l’interface graphique
Dans le menu admins, choisissez l’option Visual TOM. La fenêtre de login à Visual
TOM apparaît.
Connexion à Visual TOM
Un utilisateur Visual TOM est défini par défaut :
Utilisateur TOM
Mot de passe TOM
Domaine = <nom_de_la_machine_serveur_vtom>

3.1.5.2 Mise à jour de la base de données de test 


Une base de données par défaut est générée lors de l’installation. Il est nécessaire de la
modifier pour tenir compte des paramètres tels que le nom de la machine ou celui de
l’utilisateur d’administration vtom.
Utilisateur 
 Avec le menu Domaine Exploitation / Utilisateurs , appelez la fenêtre de définition des
utilisateurs.
Cliquez sur  Nouveau et saisissez le nom de votre administrateur Visual TOM.
Machine
 Avec le menu Domaine Exploitation / Machines , appelez la fenêtre de définition des
machines.
Sélectionnez default_machine , cliquez sur  Modifier , et remplacez ce nom par celui de
votre serveur Visual TOM.
Date
 Avec le menu Domaine Exploitation / Dates, appelez la fenêtre de définition des
Dates d'exploitation.
Sélectionnez date_exp et cliquez sur  Modifier . La fenêtre de définition de la date
apparaît. Cliquez sur  système puis sur  automatique pour la mettre à jour.
Répertoires des scripts et des traces moteur 
 Avec le menu Domaine Exploitation / Environnements, appelez la fenêtre de
définition des environnements.
Sélectionnez l’environnement exploitation et Cliquez sur  Modifier . La fenêtre de
définition de l’environnement apparaît.
Modifiez les champs Répertoire des Scripts et Répertoire des traces moteur en
remplaçant {Rep_local}/Visual_TOM  par le répertoire d’installation.

Copyright © ABSYSS. All rights reserved 91157135.doc  11/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

3.1.5.3 Validation du bon fonctionnement de la partie serveur de Visual TOM 


Ce paragraphe explique comment faire fonctionner la base de données de test en mode
simulation. L’exécution des scripts en mode simulation permet de valider le bon
fonctionnement de la partie serveur (planification et ordonnancement) de Visual TOM.
Appel du pilote graphique
Sélectionnez la fonction Pilote Graphique du menu Pilote. La fenêtre du pilote
graphique de l’environnement exploitation apparaît.
Vous êtes dans le graphe des applications. Pour visualiser les traitements, cliquez
deux fois sur l’application.
Les jobs sont tous A VENIR (couleur jaune).
Lancement du moteur (tengine)
Démarrez le tengine en cliquant sur l’icône OFF, confirmez en validant.
Les trois jobs doivent exécuter successivement, c’est à dire passer de l’état A VENIR
(jaune) à l’état EN COURS (bleu) puis à l’état TERMINE (vert).

3.1.5.4 Validation du bon fonctionnement du client 


Ce paragraphe nous explique comment exécuter les traitements et consulter leur 
fichier log.

Modification du mode d’exécution des traitements


Sélectionnez la fenêtre du graphe des applications (si vous êtes dans le graphe des
traitements cliquez sur la flèche en haut à droite).
Cliquez sur l’application test avec le bouton gauche de la souris et sélectionnez
Définition, la fenêtre de définition de l’application s’affiche.
Dans le champ Mode d’Exécution, sélectionnez exécution et validez.
Lancement du démon client : bdaemon.
Retournez à la fenêtre UNIX où vous avez lancé le menu admins.
Choisissez l’option Gestion du client, puis démarrage.
Lancement de l’exécution des traitements
Sélectionnez la fenêtre du pilote graphique au niveau du graphe des applications.
Cliquez sur l’application test avec le bouton droit de la souris, choisissez le menu
 Actions, puis forcer A VENIR.
Basculez sur la fenêtre du pilote graphique au niveau du graphe des traitements (si 
vous avez fermé cette fenêtre, cliquez deux fois sur l’application).
Les traitements sont tous passés A VENIR et vont s’exécuter les uns après les
autres.
Visualisation du fichier log
Cliquez deux fois sur un des traitements.
La Liste des logs pour ce traitement s’affiche. Cliquez deux fois sur le traitement, puis
choisissez sortie standard.

3.1.5.5 Repartir d’une base de données vierge


Une fois validée votre installation, vous pouvez repartir d'une base de données vierge. Pour 
cela, arrêtez Visual TOM (moteur, IHM et serveurs) et effacez le contenu du répertoire de la
base de données :
Sous Unix :
cd $TOM_BASES

rm -r *

 Au redémarrage des serveurs, la base de données sera recréée vierge.

12/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

3.2 Installation sous Windows NT


L’installation d’un module Serveur ou d’un mode Client doit se faire dans une session d’un
compte administrateur local.
Remarque : L’installation d’une application à l’aide d’un outil comme TSE nécessite
l’utilisation de la fonction Windows « Ajout /Suppression d’un programme »

3.2.1 Désinstallation
Dans le cas d’une réinstallation, il est nécessaire d’effectuer une désinstallation de Visual
TOM.
Pour désinstaller Visual TOM, il faut arrêter tous les process de Visual TOM :
- Les moteurs (processus tengine )
- L’interface graphique (processus vtom)
- Les services (processus dserver, gserver, pserver, vtlserver et 
bdaemon )

Lorsque Visual TOM est inactif (services et moteurs arrêtés), vous pouvez lancer le
programme de désinstallation automatique. Pour cela utilisez la fonction Windows
« Démarrer\Panneau de configuration/Ajout/suppression de programmes »
Certains répertoires ne sont pas supprimés après la désinstallation :

- Le fichier vtom.ini dans le répertoire %windir% qui contient des paramètres de


configuration. Ce fichier sera copié sous vtom.old lors d'une nouvelle installation et pourra
donc être réutilisé.

- Les services TCP de Visual TOM dans le fichier %windir%\system32\drivers\etc\services ;


ils seront les ports par défaut lors de la prochaine installation (mais pourront être modifiés).

- Les répertoires modifiés après l'installation (ex: la base de données) qui pourront être
conservés, ou être éliminés par le gestionnaire de fichiers.
Dans le cas d’une réinstallation sur de nouveaux répertoires, il faudra alors supprimer les
variables d’environnement système telles que : ABM\BIN, ABM_LOG, TOM_BIN,
TOM_STATS, TOMSTATS, ND_PATH.

3.2.2 Conventions
Lors de l'installation des fenêtres apparaissent pour confirmer les paramètres de
l'installation. Ces fenêtres contiennent les boutons suivants:
- Back / précèdent : revient à l'écran précédent
- Next / suivant : valide les paramètres à l'écran
- Browse / Parcourir : sélection d'un fichier ou d'un répertoire
- Cancel / Annuler : quitte la procédure d'installation

3.2.3 Paramètres de l’installation


Il est possible d'installer un des quatre packages suivants:
1. Client / Serveur /IHM = VT-SES-WNT ou VT-SDS-WNT
2. Client = VT-CS-WNT
3. X-VISION = VT-XVI-WNT

Copyright © ABSYSS. All rights reserved 91157135.doc  13/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

 ATTENTION : Un paramètre d’installation commun aux quatre packages est le répertoire de


destination (base d'installation de Visual TOM). Il ne faut pas choisir un nom de répertoire de
destination composé de plusieurs mots séparés par des espaces comme « Program Files ».

3.2.3.1 Pack Serveur : Client /Serveur /IHM 


Ce pack permet l'utilisation complète de Visual TOM.
Paramètres d’installation à définir :
- répertoire de destination (base d'installation de Visual TOM)
- répertoire de la base de données
- répertoire des logs (où seront archivés les traces d'exécution des jobs)
- répertoire des statistiques (où seront stockés les fichiers d'analyse)

3.2.3.2 Pack X-Vision


Ce pack permet l’installation de l’IHM, du Isuperviser et du Webdoc. Les modes opératoires
d’installation des modules ISuperviser Webdoc sont décrits dans le chapitre « Installation
des modules Isuperviser et Webdoc ».
 
Paramètres d’installation de l’IHM à définir:
- répertoire de destination (base d'installation de Visual TOM)
- nom de la machine serveur (nom ou adresse IP du serveur Visual TOM)

3.2.3.3 Pack Client 


Ce pack permet l'exécution de traitements déclenchés par un serveur Visual TOM distant.
Les paramètres d’installation à définir sont : répertoire de destination (base d'installation de
Visual TOM) et répertoire des logs (où seront archivées les traces d'exécution des jobs).

14/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

3.2.4 Déroulement de la procédure d’installation

3.2.4.1 Lancement de l’installation


Pour lancer l’installation double-clicquez sur le fichier 

<lecteur_CD-ROM>\<type_de_package>/NT\VT-XXX-WNT\setup où

XXX = SES Entreprise Server 


XXX = SDS Departmental Server 
XXX = SBU Backup Server 
XXX = CS Client
XXX= XVI Interface graphique
XXX= CN Net Client

exemple d’installation d’un pack serveur :

 A la fin de l’installation, on vous propose d’éditer le compte-rendu d’installation contenu dans


le fichier Readme.txt situé dans le répertoire d’installation.

Pour terminer l’installation de Visual TOM, il est nécessaire


- de copier le fichier license.lic   dans le sous répertoire bin du répertoire
d’installation du pack serveur (..\vtom\bin).
- et de redémarrer la machine.

3.2.4.2 Création de Groupes de programmes Visual TOM 


Lors de l'installation, un groupe de programmes Visual TOM a été créé. Ce groupe de
programme est accessible par le menu Démarrer (Start)

Il contient les icônes suivantes:


- IHM Visual TOM Lancement de l'interface graphique de Visual
TOM
- ReadMe Lecture du rapport d’installation
-  Arrêt des serveurs Arrêt des services Visual TOM
- Démarrage serveurs Démarrage des services Visual TOM
- Fichier Vtom.ini Fichier de configuration de Visual TOM

3.2.5 Validation de l’installation

3.2.5.1 Démarrage/ Arrêt des services Visual TOM 


Lors de l’installation d’un pack serveur ou un pack client des services Windows sont créés.

Copyright © ABSYSS. All rights reserved 91157135.doc  15/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

Pour un pack serveur les services suivants sont créés :


-  AbsyssGestionGraphique gère tous les évènements graphiques
-  AbsyssOrdonnanceur gère tous les accès à la base de données
-  AbsyssNotificateur gère les notification d'évènements
graphiques aux autres IHM connectés
-  AbsyssLicense gère le fichier de licences

Pour un pack client, un seul service est créé :


-  AbsyssBatchManager gère le lancement des jobs

Les services peuvent être gérés par l'intermédiaire du panneau services du panneau de
configuration:
Démarrer / Panneau de Configuration / Services

Les services de Visual TOM sont configurés pour démarrer automatiquement lors du
démarrage de la machine. Il est possible de désactiver cette option via le bouton Démarrage
dans la fenêtre des Services.

3.2.5.2 Accès à Visual TOM 


Pour accéder à Visual TOM, il suffit de lancer l’exécutable de lancement de l’interface
graphique vtom.exe dans le répertoire visual.
Vous pouvez aussi démarrer l’interface graphique par le menu Démarrer\programmes\Visual
TOM\IHM Visual TOM.

Créez un environnement de test et validez l’installation.

16/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

4 Configuration du serveur Visual TOM


La configuration d’un serveur Visual TOM se base sur les définitions de trois types de
paramètres :
- les numéros de port des communication des processus dserver, pserver ,
gserver, vtlderver et bdaemon qui ont pour noms respectifs tomDBd, ntfy,
gwd , vtlicense et bdaemon
- les variables d’environnements de l’administrateur de Visual TOM pour un
serveur Unix et les variables d’environnement système pour un serveur 
Windows NT
- les paramètres de configuration définis dans vtom.ini

4.1 Les ports de communication du serveur Visual TOM


Les numéros de ports de communication doivent être définies dans le fichier /etc/services
pour un système Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un
système Windows NT.
Pour un système Unix, les définitions des numéros de ports doivent être faites manuellement
à la fin de l’installation du serveur.
Pour un système Windows, les définitions des numéros de port sont faites automatiquement
au cours de la phase d’installation.
Ces numéros de communication doivent avoir des valeurs identiques sur toutes les
machines utilisant Visual TOM .
Les valeurs par défaut de ces ports de communication sont les suivantes :
tomDBd 20001
gwd 20002
ntfy 20003
bdaemon 20004
vtlicense 20005

4.2 Les variables d’environnement de l’administrateur de Visual


TOM pour un serveur Unix
Les variables d’environnement de l’administrateur du serveur de Visual TOM sont définies
dans le fichier vtom_init.[$SHELL].

La valeur de la variable $SHELL indique le type de shell associé à l’administrateur du


serveur de Visual TOM : ksh pour korn shell, …

Les valeurs de ces variables d’environnement sont positionnées lors de l’ouverture d’une
session par l’administrateur de Visual TOM et elles sont utilisées par les différents processus
de Visual TOM ; par exemple la variable $TOM_BASES qui contient le nom du répertoire de
la base de données de Visual TOM est utilisée comme argument lors du lancement des
processus dserver, pserver et gserver.

Le fichier vtom_init.[$SHELL] est généré automatiquement dans le sous-répertoire


$TOM_ADMIN lors de l’installation du module serveur de Visual TOM, et il est intégré au
fichier .profile de l’administrateur de Visual TOM.

Copyright © ABSYSS. All rights reserved 91157135.doc  17/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

Ci dessous un tableau qui donne la liste des variables d’environnement utilisées par le
module serveur de Visual TOM

Générales
HOST Nom de la machine
TOM_HOME Répertoire d’installation de Visual TOM
TOM_ADMIN Répertoire des scripts d’administration
TOM_USER_ADMIN Administrateur Visual TOM
Serveur 
VTOM Répertoire de la partie serveur  
TOM_BACKUP Répertoire de backup des bases
TOM_BASES Répertoire de la base de données Visual TOM
TOM_BIN Répertoire des exécutables serveur  
TOM_STATS Répertoire des statiques
TOM_TRACES Répertoire des traces moteur et serveurs
PATH Le path comprend le répertoire vtom/bin

4.3 Les variables d’environnement pour un serveur Windows


Les variables d'environnement créées lors de l’installation d’un serveur Visual TOM Windows
NT sont les suivantes :

- TOM_BIN = répertoire des exécutables du serveur Visual TOM


- TOM_STATS = Répertoire des statiques
- TOMSTATS = Répertoire des statiques

Le répertoire contenant la base de données du serveur Visual TOM est défini dans le fichier 
vtom.ini :

[GLOBALES]
bases=e:\vtom\bases Répertoire de la base de données

La visualisation des valeurs des variables d’environnement système de Windows se fait à


l’aide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement .

4.4 Le fichier de configuration vtom.ini


Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du
serveur; c’est un fichier caché .vtom.ini.
Sous Windows, ce fichier est généré au cours de la phase d’installation du serveur dans le
répertoire %windir%V.
La structure de ce fichier est organisée en sections.

18/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

4.5 Paramétrage de la procédure de communication des moteurs


avec les clients.
Les paramètres à mettre en place doivent être intégrées dans la section [general] pour Unix
et dans section [GLOBALES] pour Windows.
Sous Unix,

[general]
delaiWait:30 Délai d'attente "en secondes" d'une réponse d’un client suite à une
demande de soumission d’un traitement ou une demande sur l’état d’exécution d’un
traitement

delaiRetry:60 Délai d’attente "en secondes" avant une nouvelle tentative de contact
avec un client qui n’a pas répondu à une demande

nbWaitRetry:10 Nombre de tentatives de contact avec un client avant la


modification du statut d’un traitement

StatusFailSubmit:ENCOURSNouveau statut d'un traitement qui n'a pas pu être


soumis à un client

StatusFailExist:ENCOURS Nouveau statut d'un traitement dont on a perdu le


contact

Copyright © ABSYSS. All rights reserved 91157135.doc  19/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

4.6 La mise en place des traces des moteurs


La mise en place des traces moteurs de Visual-Tom s’effectue en renseignant la section
[_engine_trace] dans le fichier vtom.ini du serveur VTOM (%windir%\vtom.ini sous windows
et $TOM_ADMIN/.vtom.ini sous UNIX) , de la manière suivante :

Sous UNIX,

[_engine_trace]
nom_environnement1:1
nom_environnement2:1
nom_environnement3:1
Directory:/home/vtom/traces
FileSize:10
FileCount:3  

Sous WINDOWS,

[engine_trace]
nom_environnement1=1
nom_environnement2=1
nom_environnement3=1
Directory=c:\vtom\traces
FileSize=10
FileCount=3  

Ces paramètres ont la signification suivante :

nom_environnement1=1 (permet de préciser les noms des environnements pour 


nom_environnementX=1 lesquel la trace moteur sera active, ainsi que leur 
niveau de trace respectifs, 1 étant conseillé par défaut)

Directory= (Indique le répertoire destination où seront générées les traces)


Filesize= X (Indique la taille en Mo de chacun des fichiers traces)
Filecount= N (Permet une rotation d’écriture des traces
sur N fichiers + 1 fichier par défaut)

 ATTENTION, il faut s’assurer que le répertoire définit par Directory, possède l’espace disque
suffisant pour héberger l’ensemble des fichiers traces, à savoir :

(Filecount +1) x Filesize x Nombre d’environnements déclarés dans la section [engine_trace]

 A NOTER, le paramétrage des traces moteurs est pris en compte dynamiquement et


ne nécessite aucun arrêt/relance de processus.

20/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

4.7 Production de tableaux de bords des journées d’exploitation


précédentes
 Au cours de son activité quotidienne, les moteurs de Visual TOM alimentent la table de la
base de données stats.dbf, appelée fichier des statistiques. Les fonctions d’analyse de
traitements ou des statistiques permettent de produire les tableaux de bord de l’exploitation
réalisée (cf les menus de l’interface graphique Analyse\Analyse des traitements ou
Statistiques).
Ces tableaux de bord sont générés à partir du fichier des statistiques stats.dbf.
 Attention : le fichier stats.dbf n’est pas purgé automatiquement par Visual TOM ; ce qui
peut provoquer un ralentissement de l’activité des processus du serveur. La
commande vtstools gère l’export ou la purge d’une partie ou de la totalité du fichier 
stasts.dbf.
Sous Unix, la fonction d’alimentation du fichier des statistiques est active par défaut, par 
contre sous Windows, il faut mettre la valeur du paramètre stats à 1 pour que cette fonction
soit active ou mettre la valeur 0 pour inhiber cette fonction. Le paramètre stats se trouve
dans le fichier vtom.ini.

[ GLOBALES ] 
stats=1 Activation de la fonction analyse des traitements

4.8 L’historique
Cette fonction permet de consulter l’historique des actions effectuées sur les objets du
domaine d’exploitation. Cette fonction est active que lorsque le paramètre histo est
positionné à 1 dans le fichier de configuration de Visual TOM.
Sous Unix, il faut déclarer ce paramètre dans la general .
[general]
histo :1 pour activer la fonction historique
[GLOBALES]
histo=1 pour activer la fonction historique

De la même manière que pour les statistiques, les moteurs de Visual TOM alimentent la
table de la base de données histo.dbf . La fonction « historique » permet de générer un
tableau récapitulant toutes les actions effectuées sur les objets du domaine d’exploitation.
(cf le menu de l’interface graphique \historique).
Ce tableau est généré à partir du fichier de l’historique histo.dbf .
 Attention : le fichier histo.dbf  n’est pas purgé automatiquement par Visual TOM ; ce qui
peut provoquer un ralentissement de l’activité des processus du serveur. La
commande vthtools gère l’export ou la purge d’une partie ou de la totalité du fichier 
histo.dbf.

Copyright © ABSYSS. All rights reserved 91157135.doc  21/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

5 Les commandes d’un module serveur 


5.1 Sauvegarde et restauration d’une base
On peut sauvegarder une base de production en utilisant :
- la commande tbackup
- ou la commande texport

5.1.1 Sauvegarde du répertoire de la base de données


tbackup /target=<path_de_sauvegarde>

Cet outil de sauvegarde de la base de données fonctionne en client/serveur, c'est-à-dire que


l'on peut réaliser une sauvegarde de la base depuis une autre machine en positionnant la
variable TOM_REMOTE_SERVER avec le nom de la machine sur laquelle on veut faire la
sauvegarde de la base de données Visual TOM.
Sous le répertoire défini par le path_de_sauvegarde est créé un répertoire qui correspond à la
JJMMAA-HHMMSS sous lequel l'ensemble des fichiers de la base de données est
sauvegardé.
Pour restaurer une base, Il faut dans un premier temps arrêter tous les process Vtom puis
copier la base sauvegardée puis relancer les services Vtom et l’IHM.

5.1.2 Liste le contenu de la base dans un fichier texte


texport > nom_fichier (base)

Options : texport env/app/job > nom_fichier 

Liste le contenu de la base de données dans un fichier ASCII (cf. Les tableaux comparatifs
des options des commandes taddjob et taddapp et leurs formats au mode import/export).
Il est possible d'exporter tout le contenu de la base (comportement par défaut) ou de
sélectionner un environnement, une application ou un traitement.
Le fichier généré peut être modifié (en tenant compte des règles syntaxiques) avant d'être
importé dans une autre base de données (ou dans la même base de données).

5.1.3 Import des objets définis dans un fichier texte


timport nom_fichier 

La commande timport permet de récupérer des objets exportés d'une autre base de données
par la commande texport (cf. Les tableaux comparatifs des options des commandes taddjob et 
taddapp et leurs formats au mode import/export).
Les objets définis dans le fichier d'export sont créés dans la base de données courante, ou
s'ils existent déjà, sont mis à jour. Si les applications ou les traitements exportés utilisent des
objets qui n'existent pas dans la base de données courante, ceux-ci sont créés tels que
définis dans le fichier d'export.
 Attention, pour les valeurs par défaut, on récupère les valeurs par 
défaut de la nouvelle base de données (environnement ou
applications).

22/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

5.2 La gestion des moteurs

5.2.1 Démarrage d’un moteur sur un Environnement


estart nom_environnement]

Démarre le moteur de Visual TOM pour l’environnement nom_environnement  

5.2.2 Arrêt d’un moteur sur un Environnement


estop nom_environnement

Demande l’arrêt du moteur Visual TOM pour l’environnement [nom_environnement].

Messages de retour possibles:


environnement non trouve
l’environnement a été trouvé, mais le moteur n’est pas actif 
arret du moteur demande
l’environnement a été trouvé, mais le moteur n’est pas actif 

5.2.3 Remise à OFF du flag moteur de l’interface graphique pour un


environnement
eclear nom_environnement

Force à OFF le flag signalant un Moteur actif pour l’environnement [nom_environnement] 


(dans le cas où le flag moteur est à ON mais aucun process tengine n’y est associé).

Message de retour possibles :

 Aucun moteur ne tourne sur cet environnement


l’environnement a été trouvé, mais le moteur n’est pas actif 
Environnement trouve , absence d’un ;moteur signalée dans la base
l’environnement a été trouvé, mais le moteur n’est pas actif 
arrêt du moteur demande
l’environnement a été trouvé, mais le moteur n’est pas actif 

5.2.4 Test de présence d’un moteur actif pour un environnement


epresent nom_environnement

Signale si un Moteur est actif pour l’environnement [nom_environnement]

5.2.5 Vérification des blocages de date


Pour UNIX : tchkdate /nom=date [/env=env]
Pour NT : idem

Copyright © ABSYSS. All rights reserved 91157135.doc  23/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

6 Configuration du client Visual TOM


Le client Visual TOM est chargé de :
- l'exécution des scripts associés aux traitements
- l’édition des scripts
- et la visualisation et la suppression des logs d’exécution des scripts

Lors de la réception d’une demande de soumission d’un traitement envoyée par un serveur 
Visual TOM, le client stocke les références du traitement (pid, nom du script, …) dans une
file d’attente appelée queue batch. Et selon le paramétrage de cette queue batch (nombre de
 jobs simultanés, …), le client décide ou non de lancer l’exécution du script associé au
traitement.
Le lancement de l’exécution d’un script d’un traitement est effectué par un script shell sous
Unix ou un fichier de commandes sous Windows appelé Submitter ; à chaque queue batch
est associé un Submitter. Un client peut gérer plusieurs queue batch.

La configuration d’un client Visual TOM se base sur les paramétrages de trois types
d’objets :
- le numéros de port de communication
- les variables d’environnements de l’administrateur de Visual TOM pour un
client Unix et les variables d’environnement système pour un client
Windows
- les paramètres de configuration définis dans vtom.ini
- les queue batch
- les fichiers de commandes ou shells associés aux queue batch
(submitters)
- le fichier de commande ou script shell de gestion des fichiers logs

6.1 Les ports de communication utilisés par un client


En dehors du port bdaemon, un seul port de communication est utilisé par un client Visual
TOM. C’est le port tomDBd du processus dserver du module serveur. La valeur par défaut
de ce port est 20001 et elle est définie dans le fichier /etc/services pour un système Unix ou
dans le fichier %windir%\systtem32\drivers\etc\services pour un système Windows NT. Cette
valeur est mise à jour automatiquement lors de l’installation d’un client Windows NT, par 
contre, sur un système Unix, la mise à jour de la valeur du port tomDBd doit être faite
manuellement.

Pour tester l’état de la communication d’un client vers un serveur, il suffit de positionner la
valeur de la variable d’environnement TOM_REMOTE_SERVER avec le nom de la machine
du serveur Visual et de lire la valeur d’une ressource de Visual TOM avec la commande tval
Tval –name <nom_ressource>

6.2 Les variables d’environnement de l’administrateur du client


Visual TOM sous Unix
Comme pour un serveur Visual TOM Unix, les variables d’environnement de l’administrateur 
du client de Visual TOM sont définies dans le fichier vtom_init.[$SHELL] ; la valeur de la
variable $SHELL donne le type de shell associé à l’administrateur du client de Visual TOM :
ksh pour korn shell, …
Les valeurs de ces variables d’environnement sont positionnées lors de l’ouverture d’une
session par l’administrateur de Visual TOM et elles sont utilisées par le processus bdaemon;
par exemple la variable $ABM_LOGS qui contient le nom du répertoire des logs est utilisée à
la fin de l’exécution des traitements.
24/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

Le fichier vtom_init.[$SHELL] est généré automatiquement dans le répertoire


$TOM_ADMIN lors de l’installation du module client Visual TOM, et il est intégré au fichier 
.profile de l’administrateur de Visual TOM.
Dans la cas d’une installation d’un module serveur et d’un module client sur la même
machine un seul fichier vtom_ini est généré et il contient les variables d’environnement pour 
les processus du serveur et du client.
 
Ci dessous un tableau qui donne la liste des variables d’environnement utilisées par le
module client de Visual TOM

Générales
HOST Nom de la machine
TOM_HOME Répertoire d’installation de Visual TOM
TOM_ADMIN Répertoire des scripts d’administration
TOM_USER_ADMIN Administrateur Visual TOM
Client
 ABM Répertoire d’installation du client ABM
 ABM_BIN Répertoire des exécutables
 ABM_LOGS Répertoire des logs
 ABM_SPOOL Répertoire de la file d’attente des traitements

6.3 Les variables d’environnement Windows d’un client Visual


TOM
Lors de l’installation d’un client, les variables d'environnement système suivantes sont
créées :
-  ABM_BIN = répertoire des exécutables du client Visual TOM
-  ABM_LOG = Répertoire des logs

La visualisation des valeurs des variables d’environnement système de Windows se fait à


l’aide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement .

6.4 Le fichier de configuration vtom.ini


Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du
client ; c’est un fichier caché .vtom.ini.
Sous Windows, ce fichier est généré lors de l’installation dans le répertoire %windir%.
Dans le cas d’une installation d’un serveur et d’un client sur la même machine, un seul
fichier vtom.ini est généré avec les paramètres du serveur et du client.
 
Nota : Toute modification de ce fichier nécessite un arrêt et une relance des processus de
Visual TOM pour qu’elle soit prise en compte .

Copyright © ABSYSS. All rights reserved 91157135.doc  25/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

6.5 les queue batch


Une queue batch est un objet de Visual TOM qui permet à un client de gérer des files
d’attente de traitements à soumettre. A chaque queue batch est associé un script shell sous
Unix ou un fichier de commandes sous Windows qui « en capsule » l’exécution du script d’un
traitement. Ce script shell ou fichier de commandes est appelé submitter; par exemple :
- Sous un client Unix, un traitement défini avec la queue batch queue_ksh
sera soumis par le script shell tom_submit.ksh
- Sous un client Windows NT, un traitement défini avec la queue batch
queue_wnt sera soumis par le fichier de commandes
Submit_queue_wnt.bat

6.5.1 Configuration d’une queue batch sous un client Unix


 A chaque queue batch correspond un sous-répertoire sous le chemin $ABM/config/queues.
Ce sous-répertoire contient les fichiers suivants :
o fichier de configuration de la queue: queue.conf 
o définition des utilisateurs: users

La description du fichier queue.conf est la suivante :


N: Nombre maximum de jobs en exécution simultanée
M: Nombre Maximum de jobs en attente
Shell : Chemin et nom du shell ; le nom du shell doit être le même que l’extension du nom
de la queue. Par exemple, pour la queue batch queue_test, le shell soit le nom test
P: priorité des jobs dans la queue (non utilise sous UNIX)

Exemple :
Fichier $ABM/config/queues/prod/queue_config de la queue prod 
15 

 /user/bin/tcsh
4
Le queue prod a droit a 15 jobs en exécution simultanée et a 5 jobs en
attente.
Elle utilisera le shell /user/bin/tcsh
La priorité des jobs dans la queue est de 4 (non utilise sous UNIX).

6.5.1.1 Configuration des administrateurs


Un administrateur est un utilisateur du système d’exploitation qui peut gérer toutes les
queues et tous les jobs. Il est le seul habilité à arrêt et à démarrer le client. La liste des
administrateurs est définie dans le fichier $ABM_CONFIG/managers

6.5.1.2 Configuration des utilisateurs


Un utilisateur peut être associé a une ou plusieurs queues batch qu'il peut utiliser. Pour 
chaque user, on indique :
o le nombre de jobs batch qui peuvent être exécutés en même temps.
o le nombre de jobs batch en attente.

La syntaxe de saisie est la suivante : "Nom_Login:Max_Exe:Max_Wait". Cette liste des


utilisateurs est définie dans le fichier users.
NB : La déclaration du user "any" dans une queue rend accessible cette queue à tout les
users non déclarés.

Exemple : le fichier $ABM/config/queues/prod/users de la queue prod 


26/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

oracle:1:1
L’utilisateur oracle a droit a un seul job en exécution et un seul job en attente dans la queue
prod
 

6.5.2 Configuration d’une queue batch sous un client Windows


La liste des queue batch est déclarée dans le paramètre ABM_QUEUE de la section
[bdaemon] du fichier vtom.ini.
 A l’installation, il n y a qu’une seule queue qui est déclarée, c’est la queue queue_wnt. Dans
le fichier vtom.ini généré à l’installation on trouve :

[bdaemon]
 ABM_QUEUES :/queue_wnt:1

Si voulez rajouter la queue queue_test, il suffit de rajouter le nom de la queue et le nombre


de jobs simultanés autorisés (par exemple 10) sur la ligne ABM_QUEUE.

 ABM_QUEUE : /queue_wnt :1 /queue_test :10

Il faut aussi créer un submiter associé à toute nouvelle queue_batch et arrêter et redémarrer 
le service AbsyssBatchManager.

6.6 Les Submitter 


On rappelle qu’un Submitter est un script shell ou un fichier de commandes associé à une
quueue batch. Le submiter est exécuté avant la soumission de tout traitement.
Sous Unix, les submiier se trouvent dans le répertoire pointé par la variable $TOM_ADMIN
sous Ubix, et sous Windows ces submitter se trouvent dans le répertoire pointé par la
variable %ABM_BIN%

Exemple d’exécution d’un traitement ayant pour script job_test et pour queue batch
queue_test :
- le Client Visual TOM Unix déclenchera alors le script tom_submit avec 
l’extension test soit $TOM_ADMIN/tom_submit.test, en lui transmettant le
nom du script à exécuter et une liste de valeurs de variables
d’environnement 
- Le client Visual TOM Windows déclenchera alors le fichier de commandes
%ABM_BIN%/Submit_queue_test.bat en lui transmettant le nom du script 
à exécuter et une liste de valeurs de variables
d’environnementparamètres
 

Copyright © ABSYSS. All rights reserved 91157135.doc  27/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

Le tableau ci-après liste les variables d'environnement qui sont transmises par le client
Visual TOM au Submiter :

TOM_REMOTE_SERVER Nom de la machine serveur Visual TOM qui a lancé


le traitement.
TOM_JOB_ID Identifiant du traitement dans la base de données
TOM_JOB Nom du traitement
TOM_APPLICATION Nom de l’application
TOM_ENVIRONMENT Nom de l’environnement
TOM_DATE Nom de la date d’exploitation
TOM_DATE_VALUE Valeur de la date d’exploitation
TOM_USER Utilisateur exécution du traitement
TOM_SCRIPT Nom du script a exécuter  
TOM_SCRIPT_ARGS Liste des paramètres du script ou job
TOM_QUEUE_PRIORITY Priorité du job
TOM_JOB_RETRY Nombre de reprises effectuées
TOM_JOB_POINT Point de reprise. La valeur de la variable
d’environnement TOM_JOB_POINT est égale à 0
par défaut. La modification de la valeur de cette
variable d’environnement s’effectue à l’aide de la
commande tstep (tstep –l <valeur), ce qui permet la
relance du script à un step donné
TOM_JOB_EXEC Mode exécution
TOM_FAMILY Nom de la famille statistique
TOM_QUEUE Nom de la queue batch associée
TOM_LOG_ACTION Action à effectuer sur les fichiers log
TOM_HOST Nom de la machine d’exécution

Ces variables d’environnement peuvent être utilisées pour personnaliser le submitter ;


Par exemple l’envoi d’un message sur une console lorsqu’un traitement se termine en erreur.

L’exécution d’un Submitter standard se déroule de la manière suivante ::


- L’affichage dans la log des valeurs des variables d’environnement
- L’exécution du script
- La gestion du code retour du traitement, acquittement ou remontée d'erreur à Visual
TOM par la commande tsend
- La gestion des fichiers logs en fin de traitement

6.7 Gestion des logs


Tout traitement soumis par le client Visual TOM génère deux fichiers de traces d'exécution
appelée fichiers log. Ces fichiers sont générés sur le sous-répertoire pointé par la  variable
d’environnement ABM_LOGS  pour Unix et ABM_LOG pour Windows et portent l’identifiant
suivant :

- nom_env_nom_appli_nom_ job _ AAMMJJ-HHMMSS .o sortie


standard

- nom_env_nom_appli_nom_ job _ AAMMJJ-HHMMSS .e sortie erreur  

Par défaut Visual TOM génère deux fichiers log pour chaque exécution d’un traitement. Il est
possible de modifier ce comportement par l'intermédiaire du menu fin de traitement (voir 
28/46 91157135.doc   Copyright © ABSYSS. All rights reserved
04/04/12
 

Visual TOM – Support de formation administrateurs

définition d’un u traitement). Les options de ce menu sont : impression de la log, suppression
de la log et copie de la log.
Les valeurs des actions choisies dans la définition d’un traitement sont transmises par 
l’intermédiaire de la variable d’environnement TOM_LOG_ACTION, et sont traitées par le
script ou fichier de commandes gestlog situé dans le répertoire $TOM_ADMIN pour Unix ou
%ABM_BIN % pour Windows.

Pour modifier le comportement par défaut de la gestion des logs, il suffit de personnaliser le
script ou fichier de commandes gestlog en tenant compte des variables d’environnement
suivantes :

TOM_SCRIPT : nom du script


TOM_LOG : nom de la log
TOM_LOG_ACTION : action à accomplir sur la log

Copyright © ABSYSS. All rights reserved 91157135.doc  29/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

7 Configuration d’une IHM Visual TOM


L’interface graphique de Visual TOM permet :
- de définir et de modifier les objets de la base de données du serveur 
- piloter l’exploitation
- d’éditer les scripts associés aux traitements
- et de visualiser les logs d’exécution des scripts

L’interface graphique communique


- avec le serveur en utilisant les ports de communications tomDBd, gwd et ntfy
- avec les clients (pour l’édition des scripts et la consultation des logs) en
utilisant le port de communication bdaemon

L’exécutable qui permet de lancer l’interface graphique est vtom ; il est situé dans le
répertoire d’installation de l’interface graphique « visual »

La configuration d’une IHM Visual TOM se base sur les paramétrages de trois types
d’objets :
- les numéro de port des communication du tomDBd, gwd, ntfy et bdaemon

- les variables d’environnements de l’administrateur de Visual TOM pour 


une IHM Unix et les variables d’environnement système pour une IHM
Windows

- les paramètres de configuration définis dans vtom.ini

 Attention : Si on utilise exceed pour lancer xvision x11, dans la configuration exceed, au
niveau de la définition de l'écran,le paramètre "use native WM for embedded client" doit être
décoché.si ce paramètre est coché "à tort", cela peut provoquer des plantages sur xvision.

7.1 Les ports de communication utilisés par une IHM


Les ports de communication utilisés par l’interface graphique sont
- tomDB pour communiquer le processus dserver du module serveur ; la
valeur par défaut de ce port est 20001
- gwd pour communiquer le processus gwd du module serveur ; la valeur 
par défaut de ce port est 20002
- ntfy pour communiquer le processus pserver du module serveur ; la valeur 
par défaut de ce port est 20003
- bdaemon pour communiquer les processus des clients Visual TOM ; la
valeur par défaut de ce port est 20004
Ces ports de communication sont déclarés dans le fichier /etc/services pour un système Unix
ou dans le fichier %windir%\systtem32\drivers\etc\services pour un système Windows. La
déclaration des ports de communication est faite automatiquement lors de l’installation de
l’iHM Windows, par contre, sur un système Unix, cette déclaration doit être faite
manuellement.

30/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

7.2 Les variables d’environnement de l’administrateur de l’IHM


sous Unix
L’administrateur d’une IHM Visual TOM est le même que l’administrateur du serveur Visual
car l’installation d’une IHM sous Unix n’est possible qu’avec une installation d’un module
serveur.
Les variables d’environnement de l’administrateur de l’IHM de Visual TOM sont définies dans
le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL donne le type de shell associé
à l’administrateur de l’IHMVisual TOM : ksh pour korn shell, …
Les valeurs de ces variables d’environnement sont positionnées lors de l’ouverture d’une
session par l’administrateur de Visual TOM

Le fichier vtom_init.[$SHELL] est généré automatiquement dans le sous-répertoire


$TOM_ADMIN lors de l’installation du module client Visual TOM, et il est intégré au fichier 
.profile de l’administrateur de Visual TOM.
 
Ci dessous un tableau synthétise les variables d’environnement utilisées par le module IHM
de Visual TOM

Générales
HOST Nom de la machine
TOM_HOME Répertoire d’installation de Visual TOM
TOM_ADMIN Répertoire des scripts d’administration
TOM_USER_ADMIN Administrateur Visual TOM
IHM (Interface graphique)
TOM_VISUAL Répertoire d’installation de l’interface graphique
TOM_LP Script associé à l'impression dans l'interface
graphique
ND_PATH Chemin pour les fichiers de configuration Neuron
Data ($TOM_VISUAL)

7.3 Les variables d’environnement système Windows d’une IHM


Une seule variable d'environnement système est créée lors de l’installation d’une IHM Visual
TOM Windows, ND_PATH qui contient le nom du répertoire des fichiers de configuration
Neuron Data.

7.4 Le fichier de configuration vtom.ini


Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du
serveur et de l’IHM; c’est un fichier caché .vtom.ini.
Sous Windows, Ce fichier est généré lors de l’installation dans le répertoire %windir%.
Dans le cas d’une installation d’un serveur (avec IHM) et d’un client sur la même machine,
un seul fichier vtom.ini est généré avec les paramètres du serveur, de l’IHM et du client.
 
Nota : Toute modification de ce fichier nécessite un arrêt et une relance de l’IHM Visual 
TOM pour être prise en compte.

Fichier vtom.ini pour Unix

Copyright © ABSYSS. All rights reserved 91157135.doc  31/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

[vtom]
documentation:/…/documentation/nom_serveur ou http://webdoc/documentation

[aide] (Aide en ligne au format html)


browser:/appli/netscape/netscape

Fichier vtom.ini pour Winows


[GLOBALES]
 pourcent=0  faire apparaitre % dans pilote graphique pour Supra Manager 
[VTOM]
ND_PATH=e:\vtom\visual\
documentation=e:\vtom\visual\
[aide]
browser=c:\Program Files\Microsoft Internet\IEXPLORER.exe

L’utilisation des paramètres documentation et browser sera abordée dans le chapitre « mise
en place de la fonctionnalité documentation et consignes.

7.5 Mise en place des fonctionnalités documentation et consignes


Cette fonctionnalité permet l'accès depuis l'IHM Visual TOM à des pages au format HTML
Vous pouvez créez pour chaque entité (application et traitement)

- un dossier d’exploitation qui contient tout le descriptif de l'entité à laquelle il est associé

- un dossier qui contient les consignes d'exploitation destinées aux exploitants dans
lesquelles on trouve les informations relatives au contexte de production telles que la
valeur des paramètres, les consignes de reprise.

L'accès à ces document dossiers se fait par l'intermédiaire d’items dans les menus
contextuels des applications et des traitements :

- En mode définition on accède aux deux types de documents liés à l'entité sélectionnée

- En suivi ou pilotage on accède aux consignes liées à l'entité sélectionnée.

Les documents identifiés par le nom de l'entité associée doivent être générés dans des
répertoire référencé dans le fichier vtom.ini par le paramètre « documentation » de la
section [vtom]:

Nommage d’un document de type documentation pour une application :

env_app_ doc.htm; env = nom de l’environnement ; app = nom de l’application

Nommage d’un document de type consignes pour une application :

env_app_ recovery.htm ; env = nom de l’environnement ; app = nom de l’application

Nommage d’un document de type documentation pour un traitement :

env_app_job_ doc.htm; env = nom de l’environnement ; app = nom de l’application ;


job = nom du traitement

32/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM – Support de formation administrateurs

Nommage d’un document de type consignes pour un traitement :

env_app_job_ recovery.htm; env = nom de l’environnement ; app = nom de l’application ;


job = nom du traitement

L’accès à ces dossiers d’exploitation et de consignes se fait à l’aide d’un browser que vous
aurez référencé dans le paramètre « browser » de la section [aide] du fichier vtom.ini.

Copyright © ABSYSS. All rights reserved 91157135.doc  33/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

8 Conception et Pilotage de la production en


mode commande
Ces commandes ne sont disponibles que sur machine serveur Visual TOM.

8.1.1 Ajout ou modification d’objets dans le domaine d’exploitation

tlist - liste les objets du domaine d'exploitation

La commande tlist permet de récupérer en ligne de commande les noms des objets du
domaine d'exploitation.
Pour les applications, tlist renvoie aussi le nombre de traitements qu'elle contient, et le
nombre de traitements qui sont statués (etats autres que A VENIR ou EN COURS).
Utilise sans arguments, tlist renvoie son usage.
 

34/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM-Support de formation administrateurs

8.2 Ajout et modification d’une application


Pour UNIX : taddapp /nom=env/app [options]
Pour NT : idem

La commande taddapp permet la création d’une application dans un environnement et une application avec toutes ses caractéristiques définies en
options (voir le tableau des options de la commande taddapp ci-après).
Si l'application existe déjà, elle est mise à jour avec les nouvelles valeurs transmises en argument à la commande taddapp. Si des options ne sont
pas précisées, l'application conserve ses anciennes valeurs pour ces champs.
En mode création, seul le nom de l'application est obligatoire. Pour les champs qui ne sont pas précisés, l’application hérite alors des caractéristiques
par défaut de l’environnement.
Les options de la commande taddapp pour UNIX et NT

Caractéristique Mode commande Mode export valeurs / format défaut 


Nom /Nom [job:<env>/<app >] <nom de l’application> obligatoire
Commentaire /Comm commentaire <"commentaire"> aucun
Famille /Family famille <« famille »> aucune
Date d’exploitation /date Date <nom date d’exploitation> obligatoire
Type de périodicité /TypePer Type_periodicite periodique | demande  periodique
Cyclique /Cyclique cyclique oui | non non
période du cycle /Cycle Cycle <heure> 00:00:00 
Periodicité /Per periodicite journaliere | hebdomadaire | mensuel | annuel  journalière
Heure de départ minimum /Hdeb heure_debut <heure> 00:00:00 
Heure de départ maximum /Hfin heure_fin <heure> illimite
Mode d'exécution /Mode mode job | stop | exec | test | simu  job
Machine /Machine machine <"machine"> defaut de l'application
Queue batch /Queue queue <"queue"> defaut de l'application
Utilisateur /User User <"utilisateur"> defaut de l'application
ne pas déplanifier les successeurs /NonDepl ne_pas_deplanifier oui | non non
Heure de déplanification /Hdepl heure_deplanification <heure> 23:59:59
Liste des paramètres /Par parametres < par1 >[,< par2 >,...,< parn >] aucun
Lien de ... /LienDe Liens_de < env >/< appli >/< job >[< type de lien >] aucun
type de lien : obli | facu | excl | cond | erre

Copyright © ABSYSS. All rights reserved 91157135.doc  35/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

Lien vers ... /LienVers Liens_vers < env >/< appli >/< job >[< type de lien >] aucun
type de lien : obli | facu | excl | cond | erre
Calendrier /Cal calendrier <calendrier> defaut de l’application
Jours de la semaine /Jsem jour_semaine O,C,R,F c * 7 OOOOOOO (O * 7)
Jours du mois /Jmois jour_mois O,C,R,F c * 31 C * 31
Semaines du mois /Smois semaine_mois O,C,R,F OOOOO
Mois de l'année /Mannee Mois_annee O,C,R,F c * 12 OOOOOOOOOOOO
Formule /Formule aucune
Ressources /Res ressource aucune
Statut /status status NO (non planfié) | AV (a venir) | EN (en cours) | ER (en erreur)  AV (a venir)
| TE (terminé) | DE (deplanifié)
Géométrie /Geom geometrie hxl+y+x h:hauteur, l: largeur, y: ordonnée, 90x16+0+0 
 x:abscisse
couleur bordure /Cbord sfrmclr   defaut IHM 
couleur fond /Cfond sbgclr   defaut IHM 
couleur titre /Ctitre sfrblclr   defaut IHM 
Copie de ... /De NON DISPONIBLE  < env >/< appli > aucun
Mise en exploitation /exploit 1 pour la mise en exploitation

36/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM-Support de formation administrateurs

8.3 Ajout ou modification d'un traitement


Pour UNIX : taddjob /nom=env/app/job /script=<nom_script> [ options ]
Pour NT : idem

La commande taddjob permet la création ou la modification d’un job dans un environnement et une application avec toutes ses caractéristiques
définies en options (voir le tableau des options de la commande taddjob  ci-après).
En mode création, seuls le nom et le script du traitement sont obligatoires. Le traitement hérite alors de toutes les caractéristiques par défaut de
l’application.
Si le nom du traitement n'existe pas dans l'application et l'environnement références, le traitement est créé, sinon il est mis à jour.

Les options de la commande taddjob pour UNIX et NT

Caractéristique Mode commande Mode export valeurs / format défaut 


Nom /Nom [job:<env>/<app>/<job>] <nom du job> obligatoire
Script /Script Script <script> obligatoire
Commentaire /Comm commentaire <"commentaire"> aucun
Famille /Family Famille <« famille »> aucune
Type de périodicité /TypePer type_periodicite periodique | demande  periodique
Cyclique /Cyclique cyclique oui | non non
période du cycle /Cycle Cycle <heure> 00:00:00 
Periodicité /Per periodicite journaliere | hebdomadaire | mensuel | annuel  journalière
Heure de départ minimum /Hdeb Heure_debut <heure> 00:00:00 
Heure de départ maximum /Hfin Heure_fin <heure> illimite
Mode d'exécution /Mode Mode stop | exec | test | simu exec 
Machine /Machine machine <"machine"> defaut de l'application
Queue batch /Queue Queue <"queue"> defaut de l'application
Utilisateur /User User <"utilisateur"> defaut de l'application
ne pas déplanifier les successeurs /NonDepl ne_pas_deplanifier oui | non non
Heure de déplanification /Hdepl Heure_deplanification <heure> 23:59:59
Blocage de la date d'exploitation /Bloquant bloquer_la_date oui | non oui 
mettre l'application en erreur /ApplErr mettre_application_en_erre oui | non oui 
ur 
Liste des paramètres /Par parametres < par1 >[,< par2 >,...,< parn >] aucun

Copyright © ABSYSS. All rights reserved 91157135.doc  37/46 


04/04/12
 

Visual TOM-Support de formation administrateurs

Lien de ... /LienDe liens_de < env >/< appli >/< job >[< type de lien >] aucun
type de lien : obli | facu | excl | cond | erre
Lien vers ... /LienVers liens_vers < env >/< appli >/< job >[< type de lien >] aucun
Calendrier /Cal calendrier <calendrier> defaut de l’application
Jours de la semaine /Jsem jour_semaine O,C,R,F c * 7 (ouvert, ferme, calculé, rien) OOOOOOO (O * 7)
Jours du mois /Jmois jour_mois O,C,R,F c * 31 C * 31
Semaines du mois /Smois semaine_mois O,C,R,F OOOOO
Mois de l'année /Mannee mois_annee O,C,R,F c * 12 OOOOOOOOOOOO
Formule /Formule aucune
Ressources /Res ressource aucune
Statut /status Status NON_PLANIFIE | EN_ERREUR | A_VENIR |  A_VENIR 
EN_COURS | EN_ERREUR | TERMINE
Géométrie /Geom geometrie hxl+y+x h:hauteur, l: largeur, y: ordonnée, 90x16+0+0 
 x:abscisse
couleur bordure /Cbord sfrmclr   defaut IHM 
couleur fond /Cfond Sbgclr   defaut IHM 
couleur titre /Ctitre sfrblclr   defaut IHM 
Copie de ... /De NON DISPONIBLE  < env >/< appli >/< job > aucun
utilisation ou non du mode /useformule [o,n]
"Formule" dans un planning
utilisation ou non du mode /useplanning [o,n]
"Planning" dans un planning
Mise en exploitation /exploit 1 pour la mise en exploitation

38/46 91157135.doc   Copyright © ABSYSS. All rights reserved


04/04/12
 

Visual TOM-Support de formation administrateurs

8.4 Suppression d'un traitement


Pour UNIX : tdeljob -a app –e env -j job
Pour NT : idem

La commande tdeljob permet de supprimer un job donné d'une application donnée d'un
environnement donné.

8.5 Suppression d’un lien


Pour UNIX : tdellink env/app/job (de)env/app/job(vers)
Pour NT : idem

La commande tdellink permet de supprimer un lien entre traitements ou applications.


L'option "-f" permet de supprimer des liens n'ayant pas d'existence graphique. Attention !!!
Ce mode est à utiliser avec précautions, sauvegarde de base et arrêt du moteur.
 Remarque
X-Lien ET et Lien OU non supportés

Copyright © ABSYSS . All rights reserved 39/46


Réf. : 91157135.docdoc 04/04/12
 

Visual TOM-Support de formation administrateurs

9 Installation des modules Isuperviser 


Le module I-Superviser utilisent une passerelle applicative appelée I-Server qui permet de
communiquer avec les domaines d’exploitation de Visual TOM.

9.1 Installation de la passerelle I-server 


L’installation du module I-Server doit se faire dans une session d’un compte administrateur 
local.
Les fichiers nécessaires à l’installation du module I-Server sont : iserver.exe, iserver.ini et
security.ini. L’exécutable iserver.exe est situé dans le répertoire bin du répertoire
d’installation du module serveur ../vtom/bin pour Unix et ..\vtom\services\bin pour Windows.

Sous Unix, créez la variable d’environnement $ISERVER_INI et positionner la valeur de


cette variable avec le chemin complet du fichier iserver.ini :
export $ISERVER_INI=<nom_fichier>.

Sous Windows, créez et positionnez la variable d’environnement système ISERVER_INI


avec le nom du fichier iserver.ini, ou, il suffit de copier mettre le fichier iserver.ini dans le
répertoire pointé par la variable %windir%.  

Paramétrez les fichiers iserver.ini et security.ini.


L’exécutable iserver.exe doit avoir un accès en mode lecture et écriture sur ces deux
fichiers.

Contenu du Ficher iserver.ini :

[server]
name = nom de la machine d’installation du I-server 
location = nom de la société
contact = adresse E-mail du responsable technique
listenPort = numéro de port d’écoute du service Iserver 

[domain]
host = nom ou adresse IP du domaine d’exploitation de Visual TOM
dserverPort = numéro de port du dserver 
gserverPort = numéro de port du gserver 
pserverPort = numéro de port du pserver 
bdaemonPort= numéro de port du bdaemon
 
[security]
file = nom complet du fichier security.ini (..\security.ini)

[extras]
ping nom complet du script permettant de tester la présence d’une machine
(unix seulement )
BaseUrl Url de base de la documentation et des consignes
La documentation et les consignes doivent se trouver dans le répertoire
BaseUrl/NomDomaine/

40/46 91157135.doc  
 

Visual TOM-Support de formation administrateurs

[options]
FamilylnLists = 1 1 pour que la famille soit passée dans les listes, 0 sinon
LastExeclnLists = 0 0 pour que la date de la dernière exécution soit passée dans les
listes, 1 sinon

Contenu du Ficher security.ini :


 
Ce fichier peut être installé dans un répertoire sécurisé. Ce fichier contient la liste des
utilisateurs pouvant avoir accès aux fonctionnalités de la passerelle I-server :

[USER1]
name = nom de l’utilisateur 
password = mot de passe
alias = alias Visual TOM
enable = 1 actif, 0 inactif (cet utilisateur est actif par défaut)

[USER2]
……..

Sous Unix : 
L’ activation de la passerelle I-server s’effectue en tapant la commande suivante :
nohup iserver & 

Sous Windows :
Le processus iserver fonctionne sous le service Windows Absyss iServer.
La commande d’installation du processus iserver en tant que service Windows est la
suivante :
  IServer –install
La commande de désinstallation du processus iserver en tans que service Windows
est la suivante :
  IServer –remove

Le démarrage et l’arrêt de la passerelle I-server s’effectue en utilisant la


fonction Windows :
Démarrer -> paramètres -> panneau de configuration ->services

9.2 Installation du module I-Superviser 


Le module I-Superviser est écrit en langage Java, il faut donc, au préalable installer 
l’environnement JRE 1.3 (voir java.sun.com).

Copiez le contenu du répertoire d’archivage du logiciel I-Superviser sur le répertoire


d’installation de la machine cible . Le répertoire d’installation contiendra les fichiers
suivants : isuperviser.jar (pour Unix) ou isuperviser.exe pour Windows et isuperviser.ini.

Paramétrez le fichier de configuration isuperviser.ini. Ce fichier possède la structure


suivante :

[iserver]
host = nom de la machine où est installé le module I-Server 
port = numéro de port d’écoute du I-server (listenPort dans le fichier 
iserver.ini)

Copyright © ABSYSS . All rights reserved 41/46


Réf. : 91157135.docdoc 04/04/12
 

Visual TOM-Support de formation administrateurs

user = utilisateur par défaut

[interface]
fullscreen = 1 si plein écran ou 0 taille normale (la valeur par défaut est 0)

[options]
sortByLastExec =1 1 pour le tri par dernière exécution, 0 sinon
la valeur par défaut est 0

Sous Unix, le lancement du module isuperviser s’effectue de la manière suivante :


   java –jar isuperviser.jar isuperviser.ini

Sous Windows, il suffit de lancer en mode commandes le fichier isuperviser.exe.

42/46 91157135.doc  
 

Visual TOM-Support de formation administrateurs

10 Guide de l’utilisateur du support standard


10.1ASSISTANCE TELEPHONIQUE

10.1.1 Comment nous contacter 


 Appeler au 01.40.84.89.01 ou hotline@absyss.fr 
De 8 heures à 19 heures
Du lundi au Vendredi

10.1.2 Avant d’appeler le support


Sources d’informations à consulter.

Une abondante documentation technique est mise à votre disposition :


- Guides d’utilisation et d’installation en format word et HTML .
- Releases notes en word.
- FAQS en word et en HTML.

Cette documentation est disponible sur :


- chaque CD d’installation du produit Visual Tom .
- le site internet pour les FAQS sur ‘’ www.absyss.com ‘’ en cliquant sur 
support, l’utilisateur = nom de votre société et le password = abs ! suivi des 3
premières lettres de votre société .
10.1.3 Informations à fournir pour toute demande d’assistance technique
-Votre nom.
-Votre adresse
-Votre numéro de téléphone
-Votre numéro de fax, le cas échéant
-Votre mail
-Votre N° d’appel hotline si celui-ci est déjà ouvert
-La machine et le système d’exploitation (OS)
-La version actuelle de Visual Tom
-Une description précise de l’incident

Il Peut être demandé par le support :

- L’envoi de fichiers (fichiers traces, dumps, test cases : un ’ test case’ est un
ensemble programmes-jeu de données, permettant de reproduire l’incident de façon
systématique ).
- La connexion sur le site client avec un modem pour une télé-maintenance.

10.1.4 Dans quels cas appeler le support


Une assistance technique peut être sollicitée dans les cas suivants :

- Questions sur l’installation


- Identification, résolution ou contournement d’erreurs logicielles (bogues)
- Demande d’amélioration du produit .

Copyright © ABSYSS . All rights reserved 43/46


Réf. : 91157135.docdoc 04/04/12
 

Visual TOM-Support de formation administrateurs

Toute question ou tout problème soumis au support donne lieu à la création d’une
‘Demande d’Assistance Technique ‘ ( DAT ).

Chaque Demande d’Assistance Technique (DAT) permet ainsi d’identifier un


problème unique et de le suivre jusqu’à sa résolution : un N° d’appel (de référence)
est communiqué lors de création de la demande d’assistance.

Ce numéro est à rappeler lors de toute communication avec le support tehnique.

Fermeture d’une DAT :

Un appel est considéré comme clos lorsqu’une réponse, une solution ou un


contournement mutuellement acceptable a été fourni .
Un appel fermé peut être réouvert si nécessaire à condition que le problème
rencontré soit le même.

On peut convenir de fermer un appel après un certain délai, si aucune nouvelle n’a
été donnée concernant un incident signalé.

Suivi du DAT :

Une synthèse mensuelle de tous vos appels ouverts vous est envoyée par courrier 
électronique.

10.1.5 Conditions d’accès au support


Tout client ayant un contrat de maintenance peut demander une assistance
technique auprès du support .

Il est souhaitable que les personnes qui appellent le support technique connaissent
le produit et leur environnement opérationnel.

10.2MAINTENANCE DES SYSTEMES VISUAL TOM

10.2.1 Sauvegarde et restauration


Tout client doit impérativement mettre en place des procédures de sauvegarde et de
restauration afin d’éviter la perte de données.
Nous vous conseillons de faire régulièrement vos sauvegardes et de pratiquer des
simulations de restauration afin de vous assurer des résultats.
En supplément des utilitaires de vos OS, vous disposez dans la documentation Visual
Tom de tous les outils de sauvegarde et de restauration.

Remarque : nous pouvons vous offrir des services, conseils pour le choix et
l’élaboration d’une stratégie de sauvegarde adéquate . Ces services font
l’objet d’une tarification.
10.2.2 Environnement de test
L’environnement de test constitue un élément essentiel de votre système. Il permet :
de tester toute modification locale proposée.
Il permet d’aider à isoler des anomalies par rapport à l’environnement réel.
Il permet de fournir un cadre pour l’élaboration de scénarios de tests
reproductibles.
44/46 91157135.doc  
 

Visual TOM-Support de formation administrateurs

Il permet de tester de nouvelles versions.


Il permet de tester vos stratégies de sauvegardes et de restauration.

Bien qu’il ne soit évidemment pas toujours possible de reproduire ,dans votre
environnement de test, les volumes de données ou les transactions de votre
environnement réel, il n’en demeure pas moins qu’un environnement de test permet
de minimiser l’impact des changements sur votre environnement réel.

10.2.3 Gestion de vos espaces


Vous devez vous assurer en permanence que les machines ‘ client‘ et ‘ serveur’
disposent d’un espace suffisant pour le système de fichiers, notamment pour les
répertoires de trace.

10.2.4 Installation de version


 Avant de réaliser votre installation, nous vous conseillons :
- d’obtenir la dernière version
- de lire toute la documentation. Nous vous rappelons que la documentation est
disponible sur le CD et sur internet.
- de vérifier tous les pré-requis logiciels et matériels.
- de valider votre environnement de test avant l’installation réelle de la production.

Copyright © ABSYSS . All rights reserved 45/46


Réf. : 91157135.docdoc 04/04/12
 

Visual TOM-Support de formation administrateurs

HOTLINE 01 40 84 89 01

Hotline@absyss.fr 

 ABSYSS
15/17, boulevard du Général de Gaulle
92120 - MONTROUGE - FRANCE
33 (0) 1 40 84 89 01
33 (0) 1 40 84 88 40 Fax
info@absyss.com
www.absyss.com
46/46 91157135.doc  

Vous aimerez peut-être aussi