VT Admin Guide

Net job scheduler
Visual TOM Guide dadministration
The job scheduling company
Visual TOM-Guide d administration
SOMMAIRE
1 2 3
AVANT-PROPOS ......................................................................................................................... 5 PRSENTATION DE VISUAL TOM ............................................................................................ 5 ARCHITECTURE DE VISUAL TOM ............................................................................................ 6
3.1 VISUAL TOM SERVEURS (RFRENTIEL, ORDONNANCEUR).............................................................. 6 3.2 VISUAL TOM XVISION (VT-XVI = CONCEPTION, PILOTAGE) ............................................................. 6 3.3 VISUAL TOM CLIENTS (EXCUTION DES TCHES SUR UNE MACHINE) ................................................. 7 3.4 VISUAL TOM MODULES OPTIONNELS ............................................................................................... 7 3.5 EXEMPLES DARCHITECTURE ............................................................................................................ 8 3.5.1 Architecture centralise ......................................................................................................... 8 3.5.2 Architecture rpartie ou districbue ....................................................................................... 9 4 PRINCIPES DE FONCTIONNEMENT DES PROCESSUS DE VISUAL TOM .......................... 10
4.1 PROCESSUS DU MODULE SERVEUR................................................................................................. 10 4.1.1 Les processus de gestion de la production ......................................................................... 10 4.1.2 Les processus dordonnancement....................................................................................... 11 4.2 PROCESSUS DU MODULE CLIENT .................................................................................................... 12 4.3 PROCESSUS DU MODULE INTERFACE GRAPHIQUE ............................................................................ 12 4.4 ARCHITECTURE TECHNIQUE ........................................................................................................... 13 5 ADMINISTRATION DES PROCESSUS DE VISUAL TOM ....................................................... 14
5.1 ADMINISTRATION SOUS UN SYSTME UNIX ...................................................................................... 14 5.1.1 Appel du menu : admins ...................................................................................................... 14 5.1.2 Appel du menu : adminc ...................................................................................................... 15 5.2 ADMINISTRATION SOUS UN SYSTME W INDOWS NT......................................................................... 16 5.2.1 Processus du Serveur ......................................................................................................... 16 5.2.2 Processus du Client............................................................................................................. 16 5.2.3 Processus de lIHM.............................................................................................................. 16 6 CONFIGURATION DU SERVEUR VISUAL TOM...................................................................... 17
6.1 LES PORTS DE COMMUNICATION DU SERVEUR VISUAL TOM............................................................. 17 6.2 LES VARIABLES DENVIRONNEMENT DE LADMINISTRATEUR DE VISUAL TOM POUR UN SERVEUR UNIX 17 6.3 LES VARIABLES DENVIRONNEMENT SYSTME POUR UN SERVEUR W INDOWS .................................... 18 6.4 LE FICHIER DE CONFIGURATION VTOM.INI ........................................................................................ 19 6.5 PARAMTRAGE DE LA PROCDURE DE COMMUNICATION DES MOTEURS AVEC LES CLIENTS. ............... 19 6.6 PRODUCTION DE TABLEAUX DE BORDS DES JOURNES DEXPLOITATION PRCDENTES ..................... 19 6.7 PRODUCTION DE TABLEAUX DE BORD DE LEXPLOITATION DES JOURNES DEXPLOITATION FUTURES : PLANNING PRVISIONNEL.......................................................................................................................... 20 6.8 LA MISE EN PLACE DES TRACES DES MOTEURS ................................................................................ 21 6.8.1 Fonctionnement des Traces sous Visual TOM.................................................................... 21 6.8.2 Options des traces dans vtom.ini......................................................................................... 22 6.8.3 Visualisation d'un fichier de traces ...................................................................................... 22 6.8.4 Modification des options d'un fichier de traces.................................................................... 23 7 LES COMMANDES DU SERVEUR VISUAL TOM .................................................................... 24
7.1 DMARRAGE ET ARRT DES PROCESSUS DU SERVEUR .................................................................... 24 7.1.1 Dmarrage du dmon serveur de donnes......................................................................... 24 7.1.2 Dmarrage du dmon serveur de notifications.................................................................... 24
2/65 vt-admin-guide.doc
Copyright ABSYSS. All rights reserved

13/09/02
Visual TOM Guide dadministration 7.1.3 Dmarrage du dmon serveur de graphisme...................................................................... 24 7.1.4 Arrt dun processus dmon Visual TOM............................................................................ 24 7.2 SAUVEGARDE ET RESTAURATION DUNE BASE ................................................................................. 25 7.2.1 Sauvegarde du rpertoire de la base de donnes .............................................................. 25 7.2.2 Liste le contenu de la base dans un fichier texte................................................................. 25 7.2.3 Import des objets dfinis dans un fichier texte .................................................................... 25 7.3 LA GESTION DES MOTEURS ............................................................................................................ 26 7.3.1 Dmarrage dun moteur sur un Environnement .................................................................. 26 7.3.2 Arrt dun moteur sur un Environnement............................................................................. 26 7.3.3 Remise OFF du flag moteur de linterface graphique pour un environnement ................ 26 7.3.4 Test de prsence dun moteur actif pour un environnement ............................................... 26 7.4 GESTION DE LA PRODUCTION ......................................................................................................... 27 7.4.1 Production dun fichier danalyse des excution des traitements........................................ 27 7.4.2 Purge des statistiques ......................................................................................................... 28 7.5 GESTION DE LA PLANIFICATION ....................................................................................................... 29 7.5.1 Demande de planification dun travail la demande ..................................................... 29 7.5.2 Forage A VENIR des traitements dun environnement................................................... 29 7.5.3 Evaluation de planification pour un Traitement ou une Application..................................... 29 7.5.4 Affichage de la planification d'une application ou d'un traitement pour une priode donne30 7.5.5 Vrification des blocages de date........................................................................................ 30 8 CONFIGURATION DU CLIENT VISUAL TOM .......................................................................... 31
8.1 LES PORTS DE COMMUNICATION UTILISS PAR UN CLIENT ................................................................ 31 8.2 LES VARIABLES DENVIRONNEMENT DE LADMINISTRATEUR DU CLIENT VISUAL TOM SOUS UNIX......... 31 8.3 LES VARIABLES DENVIRONNEMENT SYSTME W INDOWS DUN CLIENT VISUAL TOM .......................... 32 8.4 LE FICHIER DE CONFIGURATION VTOM.INI ........................................................................................ 33 8.5 GESTION DES RESSOURCES DE TYPE FICHIER ................................................................................. 33 8.6 PROCDURE DE MISE EN PLACE DE LA GESTION DES UTILISATEURS PAR UN CLIENT VISUAL TOM SOUS W INDOWS NT OU W INDOWS 2000............................................................................................................ 33 8.6.1 Dmarrage du service AbsyssBatchManager ..................................................................... 33 8.6.2 Gestion des utilisateurs par le client Visual TOM ................................................................ 34 8.7 LES QUEUE BATCH ......................................................................................................................... 35 8.7.1 Configuration dune queue batch sous un client Unix ......................................................... 35 8.7.2 Configuration dune queue batch sous un client Windows.................................................. 36 8.8 LES SUBMITTER ............................................................................................................................ 36 8.9 GESTION DES LOGS ....................................................................................................................... 37 8.10 GESTION DES PRIORITS DEXCUTION DANS LES QUEUE BATCH .................................................. 38 9 LES COMMANDES DU CLIENT VISUAL TOM ........................................................................ 40
9.1 DMARRAGE ET ARRT DU DMON CLIENT ...................................................................................... 40 9.1.1 Dmarrage du dmon client ................................................................................................ 40 9.1.2 Arrt du dmon client........................................................................................................... 40 9.2 STATISTIQUES DUTILISATION DES FILES DATTENTE DU CLIENT ......................................................... 40 9.3 STATISTIQUES DUTILISATION DES FILES DATTENTE PAR UN UTILISATEUR .......................................... 41 9.4 LA GESTION DE LORDONNANCEMENT ............................................................................................. 41 9.4.1 Valorisation ou consultation dune ressource ...................................................................... 41 9.4.2 Ajout d'un lment dans une pile......................................................................................... 41 9.4.3 Suppression du 1er lment d'une pile ............................................................................... 41 9.4.4 Suppression de tous les lments d'une pile ...................................................................... 42 9.5 LA GESTION DU CODE RETOUR ET DES REPRISES DES TRAITEMENTS ................................................ 42 9.5.1 Envoi du statut de fin dun traitement au serveur ................................................................ 42 9.5.2 Notification du label de reprise ............................................................................................ 42 10 10.1 10.2 10.3 10.4 10.5 10.6 11 11.1
13/09/02
CONFIGURATION DUNE IHM VISUAL TOM .......................................................................... 44 LES PORTS DE COMMUNICATION UTILISS PAR UNE IHM .............................................................. 44 LES VARIABLES DENVIRONNEMENT DE LADMINISTRATEUR DE LIHM SOUS UNIX .......................... 44 LES VARIABLES DENVIRONNEMENT SYSTME W INDOWS DUNE IHM............................................. 45 LE FICHIER DE CONFIGURATION VTOM.INI .................................................................................... 45 MISE EN PLACE DES FONCTIONNALITS DOCUMENTATION ET CONSIGNES ...................................... 46 MISE EN PLACE DE LA FONCTION IMPRESSION DES LOGS ET DES SCRIPTS ..................................... 47 CONCEPTION ET PILOTAGE DE LA PRODUCTION EN MODE COMMANDE ..................... 48 AJOUT OU MODIFICATION DOBJETS DANS LE DOMAINE DEXPLOITATION ........................................ 48
vt-admin-guide.doc 3/65
11.1.1 liste des objets dfinis dans le domaine d'exploitation ........................................................ 48 11.1.2 Ajout ou modification d'une date d'exploitation.................................................................... 49 11.1.3 Suppression d'une date d'exploitation ................................................................................. 49 11.1.4 Ajout ou modification d'une ressource................................................................................. 49 11.1.5 Ajout ou modification d'un utilisateur ................................................................................... 49 11.1.6 Suppression d'un utilisateur................................................................................................. 50 11.1.7 Modification du nom d'une machine .................................................................................... 50 11.1.8 Ajout dune queue................................................................................................................ 50 11.2 AJOUT ET MODIFICATION DUNE APPLICATION .............................................................................. 51 11.3 AJOUT OU MODIFICATION D'UN TRAITEMENT................................................................................. 53 11.4 SUPPRESSION D'UN TRAITEMENT ................................................................................................ 55 11.5 SUPPRESSION DUN LIEN ............................................................................................................ 55 12 12.1 12.2 12.3 12.4 13 SERVEUR DE BACKUP ............................................................................................................ 56 SYNCHRONISATION DES BASES ................................................................................................... 56 MCANISME DE BASCULEMENT AUTOMATIQUE ............................................................................. 56 PROCDURE DE BASCULEMENT ................................................................................................. 57 RETOUR AU MODE NORMAL ........................................................................................................ 57 CONFIGURATION DES MODULES I-SUPERVISER ET WEBDOC ...................................... 58
13.1 CONFIGURATION DE LA PASSERELLE I-SERVER............................................................................ 58 13.1.1 Fonctionnement de la passerelle I-server ........................................................................... 58 13.1.2 Dmarrage et arrt de la passerelle I-Server ...................................................................... 58 13.1.3 Fichier de configuration iserver.ini ...................................................................................... 59 13.1.4 Fichier securty.ini ................................................................................................................. 59 13.2 CONFIGURATION DU I-SUPERVISER ............................................................................................. 60 13.3 CONFIGURATION DU WEBDOC ..................................................................................................... 60 14 GUIDE DE LUTILISATEUR DU SUPPORT STANDARD......................................................... 62
14.1 ASSISTANCE TELEPHONIQUE ............................................................................................ 62 14.1.1 Comment nous contacter..................................................................................................... 62 14.1.2 Avant dappeler le support ................................................................................................... 62 14.1.3 Informations fournir pour toute demande dassistance technique.................................... 62 14.1.4 Dans quels cas appeler le support ...................................................................................... 62 14.1.5 Conditions daccs au support............................................................................................. 63 14.2 MAINTENANCE DES SYSTEMES VISUAL TOM .................................................................. 63 14.2.1 Sauvegarde et restauration ................................................................................................. 63 14.2.2 Environnement de test......................................................................................................... 63 14.2.3 Gestion de vos espaces ...................................................................................................... 64 14.2.4 Installation de version .......................................................................................................... 64
4/65
vt-admin-guide.doc

13/09/02
1 Avant-Propos
Ce document dcrit principalement le fonctionnement, ladministration et lutilisation en mode administrateur des modules Visual TOM suivants : - Serveur Unix - Serveur Windows NT - Serveur de Backup - Client Unix - Client Windows NT - Interface graphique Unix - Interface graphique Windows 95/98/NT - I-server - Isuperviser - Webdoc
2 Prsentation de Visual TOM

Visual TOM, acronyme de Visual Time Operation Manager, est un automate qui libre les services dexploitation des contraintes lies aux systmes htrognes. Visual TOM a pour but de librer le service exploitation des tches rptitives et des contraintes de manipulations existant entre tous les travaux qui doivent tre effectus sur un site informatique. Visual TOM permet : La mise en uvre de la production par modlisation graphique (le GPI). Les schmas dexploitation sont ainsi dfinis dynamiquement (objets, couleurs, textes). La planification de travaux priodiques ou la demande, cest--dire non-planifiables lavance. La synchronisation de lensemble des contraintes (dpendances et vnements) entre toutes les entits de votre exploitation (rception de fichiers, vnements utilisateurs, vnements extrieurs). Visual TOM prend en charge les actions et le planning mettre en uvre en temps rel. La prparation automatique des travaux (Visual TOM calcule les dates et les variables denvironnement ncessaires la prparation des travaux). Ladministration centralise par lintermdiaire dun pilote qui donne une vue synthtique de ltat davancement de lexploitation (suivi des tests raliss et des dcisions prises par le moteur grce des comptes-rendus dactivit ou fichiers de logs) La gestion centralise des incidents (dtecter les incidents, effectuer les relances automatiques et les dplanifications des traitements en fonction de lexcution des jobs termins). Une simulation de contrle permettant de prvoir les volutions et valider les rgles qui ordonnancent la production. Ldition de tableaux de bord et dtats de contrle sur le droulement de lexploitation (analyser lactivit passe et produire des tableaux prvisionnels).
13/09/02 vt-admin-guide.doc 5/65
3 Architecture de Visual TOM

Larchitecture de base de Visual TOM est dcompose en trois familles de modules
3.1 Visual TOM Serveurs (Rfrentiel, Ordonnanceur).

Visual TOM Enterprise Server (VT-SES) Visual TOM Enterprise Server est llment de base de toute architecture. Il inclut le rfrentiel de production, le systme de planification et dordonnancement, les APIs. Il peut tre install indiffremment sur des machines UNIX ou Windows NT. Visual TOM Departmental Server (VT-SDS) Serveur secondaire pour grer l'autonomie des sites rpartis ou rpartir la charge dans une architecture distribue. Il ncessite la prsence dun module Enterprise Server. Il peut tre install indiffremment sur des machines UNIX ou NT. Visual TOM Back Up Server (VT-SBU) Serveur relayant automatiquement un serveur Visual TOM en cas dincident. Ce module est systmatiquement mis en place dans les productions ncessitant un niveau de scurit optimal. Il peut tre install indiffremment sur des machines UNIX ou NT.
3.2 Visual TOM XVision (VT-XVI = Conception, Pilotage)

Visual TOM IHM Interface graphique locale ou dporte sur un LAN ou un Wan connect tout type de serveur Visual TOM (y compris les NetClients). Elle permet la modlisation, la gestion et le pilotage de la production. Elle peut tre installe sur des plates-formes UNIX et Windows NT/95. Visual TOM I-Superviser Ensemble de fonctionnalits permettant de suivre le droulement d'une production gre par Visual TOM. Cette fonctionnalit a t tudie pour permettre le suivi de la production via un rseau bas dbit (RTC, Internet). Visual TOM WebDoc Interface internet permettant de visualiser les caractristiques des objets de vos domaines dexploitation Visual TOM : ressources, calendriers, environnements, applications, traitements .
6/65
vt-admin-guide.doc

13/09/02
3.3 Visual TOM Clients (Excution des tches sur une machine)
Visual TOM Client (VT-CS) Ce module dpend dun ou de plusieurs Visual TOM serveur; ils reoivent les ordres de soumission en provenance de ceux-ci et excutent les traitements batch. (ex. : Excution dune tche sur une machine). Il peut tre install indiffremment sur des machines UNIX ou NT, VAX/VMS, Open VMS, AS400, GCOS7 et GCOS8. Visual TOM Net Client (VT-CN) Client Visual TOM possdant en local son propre rfrentiel de production lui garantissant lautonomie de fonctionnement. Il peut tre install indiffremment sur UNIX ou NT.
3.4 Visual TOM Modules optionnels

Visual TOM Xframework (VT-XFR) : Modules dintgration avec une plate-forme de supervision systmes et rseaux et/ou applicative. Dans le cas dOpenMaster et de PATROL, les modules sont livrs sous forme d'agents packags et certifis offrant ainsi une intgration optimale. Visual TOM XApplication (VT-XAP) : module dintgration entre lapplication Visual TOM et les grands progiciels du march (comme SAP R/3, BAAN, JDE, ORACLE APPLICATIONS, ).

13/09/02
vt-admin-guide.doc
7/65
3.5 Exemples darchitecture

3.5.1 Architecture centralise
Un Serveur est responsable de un ou plusieurs clients dpourvus dintelligence locale. La base de donnes est centralise sur le serveur. Visual TOM XVision est install sur une des machines UNIX, Windows du rseau et accde un Visual TOM Enterprise Server. Cette architecture sera utilise pour le pilotage Client/Serveur des applications sur le rseau local (LAN).
Architecture Centralise Mono-site Multi-systmes

VT Enterprise server VT Backup server VT Client VT Net client
VT Xvision
VT Client Mainframe Synchronisation inter-systmes. Gestion des environnements de test et de production.
8/65
vt-admin-guide.doc

13/09/02
3.5.2 Architecture rpartie ou districbue

La base modle est sur le serveur de rfrence (Visual TOM Enterprise Server). Chaque Visual TOM Departmental Server dispose de sa base locale et est responsable dun ou plusieurs Visual TOM Clients. Cette architecture pourra tre utilise pour la gestion distance des serveurs travers le rseau distant (Wan).
Architecture Rpartie
Departmental Serveur
Multi-sites Multi-systmes
Client simple Net Client Enterprise Server Xvision Administration Locale
Client simple
WAN
Xvision Administration Centrale Synchronisation inter-sites, Gestion cooprative de la production, Mode commande.
Departmental Serveur Net client
Client Mainframe

13/09/02
vt-admin-guide.doc
9/65
4 Principes de fonctionnement des processus de Visual TOM

Les processus de Visual TOM fonctionnent en mode Client/Serveur bas sur le protocole de communication TCP/IP. Le principe de fonctionnement dun processus en mode Serveur bas sur le protocole TCP/IP est que lorsque ce type de processus dmarre, il tablit une liaison interne un socket (une ressource TCP), permanente, de la machine locale et se met lcoute des requtes arrivant sur un port TCP. Cette liaison permanente permet aux clients de ce processus de lui envoyer des requtes. Ce principe de fonctionnement est le mme que celui utilis par les applications telles que : serveur telnet, serveur ftp, serveur http, . La syntaxe de la commande daffichage des connexions et des ports dcoute est : netstat a. Une manire de valider le bon fonctionnement du mode Client/Serveur entre les machines utilisant des modules de Visual TOM est de tester une ouverture de session telnet, rlogin, ftp, . Le principe de fonctionnement dun processus en mode Client bas sur le protocole TCP/IP est que lorsque ce type de processus est activ, il tablit une liaison TCP/IP avec le processus Serveur en utilisant ladresse IP de la machine et le numro de port du processus Serveur.
4.1 Processus du module serveur

Deux types de processus sont prsents dans un module serveur : Les processus de gestion de objets de la production : la base de donnes, les connections avec les IHM et les mises jour des ces IHM. Ces processus communiquent en mode serveur avec les processus des modules Clients et IHM de Visual TOM Les processus dordonnancement de la production appels moteurs. Ces processus fonctionne en mode client avec les modules Clients de Visual TOM
4.1.1
Les processus de gestion de la production
Dans chaque module serveur, il y a trois processus : dserver, pserver et gserver. Sous Unix, les excutables associs ces processus sont installs dans le rpertoire rfrenc par la variable $TOM_BIN. Sous Windows, les excutables associs ces processus sont installs dans le rpertoire <rpertoire_installation>\vtom\services.
4.1.1.1 Le processus de gestion de la base de donnes :dserver

Le processus dserver gre la base de donnes de la production. Lorsquil est dmarr il est en coute sur le port tomDB. Pour vrifier que le processus est bien en tat dcoute sur le port tomDBD, il suffit de lancer la commande daffichage des connexions et ports dcoute : netstat a | grep tomDBd Le processus dserver reoit des requtes des modules : - IHM : demandes de connexion, de modification ou dajout dobjets dans la base de donnes, .. - Clients : indication de fin de traitement, demande de valorisation dune ressource, - Moteurs : demande des caractristiques des objets dun environnement,

13/09/02
4.1.1.2 Le processus des gestion des connections avec les IHM : pserver
Ce processus utilise le port ntfy, et il reoit de la part du dserver les notifications de modifications de la base de donnes et la liste des modules IHM connectes. Pour chaque fentre graphique (fentres de conception et du pilote) dune IHM, le processus pserver maintient en activit un socket sur le port ntfy. Pour connatre le nombre de fentres des IHM ouvertes, il suffit de lancer la commande : netstat a | grep ntfy A intervalles de temps rguliers, le processus pserver est interrog par les modules IHM connects au serveur pour prendre connaissance des modifications des contenus des fentres graphiques. Les contenus de ces modifications sont fournies par le processus gserver.
4.1.1.3 Le processus de gestion des mises jour des IHM : gserver

Ce processus utilise le port gwd ; il reoit des requtes de la part des IHM connectes au serveur pour quil leur fournisse les modifications des contenus des fentres graphiques ouvertes.
4.1.2 Les processus dordonnancement

A chaque environnement actif est associ un processus tengine appel moteur. Lexcutable associ aux moteurs est localis sur le rpertoire point par la variable denvironnement TOM_BIN. Pour chaque environnement actif, le moteur ou tengine effectue cycliquement des tches dordonnancement et de surveillance de lactivit des clients de Visual TOM. Pour chaque entit dun environnement (application et traitement) les tches dordonnancement sont les suivantes : - lvaluation de la planification - lvaluation des contraintes des horaires de dbut et de fin - lvaluation des dpendances ou liens - lvaluation des ressources Pour chaque traitement en attente ou en cours de soumission le moteur supervise lactivit du Client Visual TOM qui a la responsabilit de soumettre le traitement. Un moteur dialogue - dune part, avec le processus dserver pour lire les caractristiques de chaque application et chaque traitement dun environnement - et dautre part, avec les clients pour soumettre les traitements et surveiller le droulement de lexcution des traitements Le Moteur utilise le fichier de configuration du serveur pour dterminer la procdure suivre dans le cas de non rponse une demande envoye un module client Visual TOM. Un moteur peut envoyer une demande de soumission dun traitement ou une demande de test dactivit dun traitement en cours de soumission. Cette procdure est dtermine par les paramtres suivants : - le dlai dattente de la rponse du client ; paramtre delaiWait dont la valeur par dfaut est de 30 secondes - le dlai entre deux tentatives de renvoi de la mme demande au client ; paramtre delaiRetrydont la valeur par dfaut est de 60 secondes - le nombre de tentatives de renvoi de la mme demande au module client ; paramtre nbWaitRetry dont la valeur par dfaut est de 10 - le statut futur dun traitement qui na pas pu tre soumis ; paramtre StatusFailSubmit dont la valeur par dfaut est ENCOURS
le statut futur dun traitement que le client a accept de soumettre mais na pas rpondu la demande de test dactivit du traitement ; paramtre StatusFailExist dont la valeur par dfaut est ENCOURS
4.2 Processus du module client

La communication avec le module client Visual TOM seffectue laide du processus bdaemon qui fonctionne en mode Serveur sur le port bdaemon. Sous Unix, lexcutable associ au processus bdeamon se trouve dans le rpertoire rfrenc par la variable $ABM_BIN. Sous Windows, lexcutable associ au processus bdeamon se trouve dans le rpertoire <rpertoire_installation>\abmservices. Le processus bdaemon reoit des demandes : - de soumission dun traitement envoye par les moteurs - tests dactivit des traitements en cours de soumission - dditions de scripts envoyes par les modules IHM - de consultations et de suppressions des log envoyes par les IHM Les commandes telles que lindication de fin dun traitement (tsend), la valorisation dune ressource (tval), sont envoyes par dautres processus que le processus bdaemon. Ces processus sont localises sur la machine cliente et utilisent le port de communication tomDBd ; do la ncessit de dclarer le port tomDBd sur chaque machine cliente Visual TOM. Sous Unix, le processus bdaemon utilise les droits de root travers un setuid afin de pouvoir soumettre les traitement de tous les utilisateurs habilits. Sous Windows NT, le processus bdaemon est reprsent par le service AbsyssBatchManager. Ce service est dmarr par dfaut sous le compte systme local; il peut tre dmarr sous le compte dun utilisateur en paramtrant le fichier de configuration du client (voir paramtrage de vtom.ini pour un module client).
4.3 Processus du module Interface graphique

Le processus vtom permet de lancer linterface graphique. Ce processus fonctionne en mode client avec les processus dserver, pserver, gserver et bdaemon ; do la ncessit de dclarer les ports tomDBd, ntfy, gwd et bdaemon sur chaque machine qui possde un module IHM de Visual TOM. Sous Unix, lexcutable associ au processus vtom se trouve dans le rpertoire associ la variable $TOM_VISUAL Sous Windows, lexcutable associ au processus vtom se trouve dans le rpertoire <rpertoire_installation>\visual. Le processus vtom utilise : - le port tomDBd pour ouvrir une session avec le serveur Visual TOM - les ports gwd et ntfy pour la mise jour des fentres grahiques : modification ou ajout dun objet, mise jour de la couleur du statut, - et le port bdaemon pour diter les scripts, consulter et supprimer les logs
12/65
vt-admin-guide.doc

13/09/02
4.4 Architecture technique
Architecture technique
Gestion rfrentiel de production
Tcp/ip
Tengine
Rplication en temps rel Vtom serveur VT-SDS VT-SES Vtom backup serveur VT-SBU Vtom client VT-CS
tomDBd gwd ntfy
dserver gserver pserver dserver gserver pserver
Gestion graphique
Gestion des vnements

tomDBd gwd ntfy
tomDBd bdaemon
bdaemon Soumission des batchs
vtom
tomDBd
Queues batchs
Queue ksh Queue SAP Affichage Script batch et log
Vtom VT-XVISION
Mr TOM
gwd ntfy

13/09/02
vt-admin-guide.doc
13/65
5 Administration des processus de Visual TOM

5.1 Administration sous un systme Unix
Deux menus dadministration des processus de Visual TOM sont disponibles dans le rpertoire $TOM_ADMIN : admins et adminc. Ces menus sont accessibles ladministrateur de Visual TOM.
5.1.1 Appel du menu : admins
Administration de Visual TOM - serveur ${HOST} 1 2 3 4 5 6 7 q Etat Demarrage Arret Gestion Gestion Visual TOM Sauvegarde Quitter de la base de donnees de Visual TOM - Serveur des Serveurs Visual TOM des Serveurs Visual TOM des Moteurs Visual TOM du client Visual TOM
commande :
Option 1 - Etat de Visual TOM

Cette option permet de connatre ltat de tous les processus lis Visual TOM : - dmons prsents partie serveur (dserver, pserver et gserver) - dmons prsents partie cliente (bdaemon) - interfaces graphiques (vtom) Pour chacun des processus existants sont affiches les informations suivantes: nom du process : utilisateur pid date ou heure base Si le serveur Visual TOM est actif sur la machine, on trouve l'tat des moteurs sur les diffrents environnements : nom de lenvironnement : ON/OFF
Options 2 et 3 - Dmarrage et arrt des serveurs Visual TOM

Ces fonctions permettent de lancer ou d'arrter les trois dmons de la partie serveur : dserver, gserver et pserver. Les lancements et arrts des serveurs sont tracs dans le fichier $TOM_TRACES/serveur. Remarque : Il est possible que le dmarrage des processus serveurs de Visual TOM durent plusieurs minutes. Dans ce cas il faut purger le fichier des statistiques

13/09/02
stats.dbf par la commande tpurge (voir chapitre commandes du serveur) et supprimer les fichiers message.dbf et message.cdx.
Option 4 - Gestion des moteurs Visual TOM

Cette option appelle le sous menu de Gestion des moteurs. Ce sous-menu n'est accessible que si les serveurs Visual TOM ont t activs. La liste des environnements est affiche, avec pour chacun ltat du processus tengine associ (ON ou OFF). Il est possible de grer tous les moteurs simultanment (entrez start pour les dmarrer, stop pour les arrter) ou individuellement (entrez le nom de l'environnement). Dans ce dernier cas, si le moteur est actif sur l'environnement alors il est arrt, s'il est inactif alors il est dmarr. Remarques : L'arrt et le dmarrage des moteurs peuvent prendre quelques secondes. Lors du raffichage, il est possible que les statuts n'aient pas encore t actualiss. Pour rafrachir la liste des tats, appuyez sur la touche Entre. Le cycle du moteur est fix par dfaut 10 secondes, mais il est possible d'indiquer un autre cycle en suivant le nom de l'environnement d'une virgule et de la valeur du cycle (ex: start,30 ; production,60 ...).
Option 5 - Gestion du client

Il sagit dun appel au menu adminc (cf. paragraphe suivant).
Option 6 - Visual TOM

Lancement de linterface graphique. Pour tre oprationnelle cette option ncessite que les serveurs Visual TOM (dserver, gserver et pserver) soient lancs.
Option 7 - Sauvegarde de la base de donnes

Cette option permet de sauvegarder la base de donnes , mme si un ou plusieurs moteurs sont actifs sur la base. Le rpertoire base est copi dans le rpertoire $TOM_BACKUP, rfrence par le jour et l'heure.
5.1.2 Appel du menu : adminc
Administration de Visual TOM - client ${HOST} 1 Etat 2 Dmarrage 3 Arrt q Quitter commande : de Visual TOM - Client du Client Visual TOM du Client Visual TOM
Option 1 - Etat du client Visual TOM

Si le client est actif, l'tat de chacune des queues batch est affich.
Options 2 et 3 - Dmarrage et arrt du Client Visual TOM

Ces fonctions permettent de lancer ou d'arrter le client Visual TOM.
Les lancements et arrts du client sont tracs dans le fichier $TOM_TRACES/client.
5.1.2.1 Dmarrag es proceseboot

Deux scripts boot_start_client et boot_start_server sont disponibles dans le rpertoire $TOM_ADMIN . Ces deux scripts peuvent intgrs la procdure de boot systme pour dmarrerf1tomatiquement les processus du serveur et du client Visual TOM lors dun redmarrage de la machine.
5.2 Administration sous un systme Windows NT

5.2.1 Processus du Serveur
Les excutables associs aux processus dserver, pserver et gserver sont lancs 1tomatiquement lors du boot de la machine et ils apparaissent en tant que services sous Windows NT. On peut 1tiliser lo1til Windows Dmarrer\programmes\Parmatres\Panneau de conf guration\Services pour arrter et dmarrer ces processus. Sinon deux f chiers de commandes tom-start.bat et tom-stop.bat installs dans le rpertoire <rpertoire_installation>\vtom\tools permettent respectivement de dmarrer et darrter les processus du serveur Visual TOM.
5.2.2 Processus du Client

Lexcutable associ au processus bdeamon se trouve dans le rpertoire <rpertoire_installation>\abm\services. On peut utiliser lo1til Windows Dmarrer\programmes\Parmatres\Panneau de configuration\Services pour arrter et dmarrer ce processus.
5.2.3 Processus de lIHM

Lexcutable associ au processus vtom se trouve dans le rpertoire <rpertoire_installation>\visual. Pour accder linterface graphique de Visual TOM, il suffit de lancer lexc1table de lancement de linterface graphique vtom.exe situ dans le sous-rpertoire visual. Vous pouvez aussi dmarrer linterface graphique par le menu Dmarrer\programmes\Visual TOM\vtom.
16/65
vt-admin-guide.doc

13/09/02
6 Configuration du serveur Visual TOM

La configuration dun serveur Visual TOM se base sur les dfinitions de trois types de paramtres : - les numros de port des communication des processus dserver, pserver et gserver et bdaemon qui ont pour noms respectifs tomDBd, ntfy, gwd et bdaemon - les variables denvironnements de ladministrateur de Visual TOM pour un serveur Unix et les variables denvironnement systme pour un serveur Windows NT - les paramtres de configuration dfinis dans vtom.ini
6.1 Les ports de communication du serveur Visual TOM

Les numros de ports de communication doivent tre dfinies dans le fichier /etc/services pour un systme Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un systme Windows NT. Pour un systme Unix, les dfinitions des numros de ports doivent tre faites manuellement la fin de linstallation du serveur. Pour un systme Windows, les dfinitions des numros de port sont faites automatiquement au cours de la phase dinstallation du serveur. Ces numros de communication doivent avoir des valeurs identiques sur toutes les machines utilisant Visual TOM . Les valeurs par dfaut de ces ports de communication sont les suivantes : TomDBd 20001 Gwd 20002 Ntfy 20003 Bdaemon 20004
6.2 Les variables denvironnement de ladministrateur de Visual TOM pour un serveur Unix
Les variables denvironnement de ladministrateur du serveur de Visual TOM sont dfinies dans le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL indique le type de shell associ ladministrateur du serveur de Visual TOM : ksh pour korn shell, Les valeurs de ces variables denvironnement sont positionnes lors de louverture dune session par ladministrateur de Visual TOM et elles sont utilises par les diffrents processus de Visual TOM ; par exemple la variable $TOM_BASES qui contient le nom du rpertoire de la base de donnes de Visual TOM est utilise comme argument lors du lancement des processus dserver, pserver et gserver. Le fichier vtom_init.[$SHELL] est gnr automatiquement dans le sous-rpertoire $TOM_ADMIN lors de linstallation du module serveur de Visual TOM, et il est intgr au fichier .profile de ladministrateur de Visual TOM.

13/09/02
vt-admin-guide.doc
17/65
Ci dessous un tableau qui donne la liste des variables denvironnement utilises par le module serveur de Visual TOM Gnrales Nom de la machine Rpertoire dinstallation de Visual TOM Rpertoire des scripts dadministration Administrateur Visual TOM Serveur Rpertoire de la partie serveur Rpertoire de backup des bases Rpertoire de la base de donnes Visual TOM Rpertoire des excutables serveur Rpertoire des statiques Rpertoire des traces moteur et serveurs Le path comprend le rpertoire vtom/bin
HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN VTOM TOM_BACKUP TOM_BASES TOM_BIN TOM_STATS TOM_TRACES PATH
6.3 Les variables denvironnement systme pour un serveur Windows

Les variables d'environnement systme cres lors de linstallation dun serveur Visual TOM Windows NT sont les suivantes : TOM_BIN = rpertoire des excutables du serveur Visual TOM TOM_STATS = Rpertoire des statiques TOMSTATS = Rpertoire des statiques
Le rpertoire contenant la base de donnes du serveur Visual TOM est dfini dans le fichier vtom.ini (voir paragraphe suivant). La visualisation des valeurs des variables denvironnement systme de Windows se fait laide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement. Le paramtrage dune variable denvironnement systme sous Windows se fait en modifiant la registry ; pour cela il faut excuter la procdure suivante : 1. lancer l'utilitaire de modification de la registry : \winnt\system32\regedt32.exe 2. Ouvrir la fentre HKEY_LOCAL_MACHINE. Aller dans : System, CurrentControlSet, Control, Session Manager, Environment 3. Aller dans le Menu Edit et slectionner Add Value ou Ajouter une valeur. Value Name = TOM_BIN par exemple, faire OK String = <nom_rpertoiree>, faire OK Pour que le systme dexploitation prenne en compte la modification de la registry , il est ncessaire de redmarrer la machine. Aprs le redmarrage, la variable positionne doit apparatre dans la partie rserve aux variables systme (Demarrer\Panneau de configuration\Systeme\Environnement).

13/09/02
6.4 Le fichier de configuration vtom.ini

Sous Unix, ce fichier est gnr dans rpertoire $TOM_ADMIN lors de linstallation du serveur; cest un fichier cach .vtom.ini. Sous Windows, ce fichier est gnr au cours de la phase dinstallation du serveur dans le rpertoire %windir%V. Le fichier vtom.ini ne contient pas toutes les options, et toute modification de ce fichier ncessite un arrt et une relance des processus de Visual TOM pour tre prise en compte. La description des diffrentes options du fichier vtom.ini est aborde dans les chapitres qui dcrivent les mises en place des fonctionnalits associes ces options. La structure de ce fichier est organise en sections.
6.5 Paramtrage de la procdure de communication des moteurs avec les clients.

Les paramtres mettre en place doivent tre intgres dans la section [general] pour Unix et dans section [GLOBALES] pour Windows. [GLOBALES] delaiWait:30 Dlai d'attente "en secondes" d'une rponse dun client suite une demande de soumission dun traitement ou une demande sur ltat dexcution dun traitement delaiRetry:60 Dlai dattente "en secondes" avant une nouvelle tentative de contact avec un client qui na pas rpondu une demande nbWaitRetry:10 Nombre de tentatives de contact avec un client avant la modification du statut dun 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 [CS_VERSIONS] RemoteFunctions:0 Inhibition des fonctions d u Planning prvisionnel et Simulation
6.6 Production de tableaux de bords des journes dexploitation prcdentes

Au cours de son activit quotidienne, les moteurs de Visual TOM alimentent la table de la base de donnes stats.dbf, appele fichier des statistiques. Les fonctions danalyse de traitements permettent de produire les tableaux de bord de lexploitation ralise (cf Guide utilisateur Analyse des traitements). Ces tableaux de bord sont gnrs partir du fichier des statistiques stats.dbf. Attention : le fichier stats.dbf nest pas purg automatiquement par Visual TOM ; ce qui peut provoquer un ralentissement de lactivit des processus du serveur. La commande tpurge permet de purger le fichier des statistiques. Sous Unix, la fonction dalimentation du fichier des statistiques est active par dfaut, par contre sous Windows, il faut mettre la valeur du paramtre stats 1 pour que cette fonction soit active ou mettre la valeur 0 pour inhiber cette fonction. Le paramtre stats se trouve dans le fichier vtom.ini.
[GLOBALES]
bases=e:\vtom\bases stats=1
Rpertoire de la base de donnes de Visual TOM Activation de la fonction analyse des traitements
Il est bien sr possible dautomatiser la production de ces tableaux de bord dans un traitement soumis par Visual TOM en utilisant la commande tstat. Sous UNIX, un traitement danalyse des traitements est disponible ($TOM_ADMIN/anatrait) et peut devenir votre modle de traitement des statistiques, qui pourra tre excut dans une application de votre production.
6.7 Production de tableaux de bord de lexploitation des journes dexploitation futures : Planning prvisionnel
Cette fonction permet de produire les tableaux de bord relatifs lexploitation qui devrait se drouler dans les journes futures. Cette fonction nest pas disponible sous Windows. La fonction Planning prvisionnel utilise deux ports de communication qui doivent tre dclars dans le fichier /etc/services : PLANPREV_tomDBd 20006/tcp 01_tomDBd 20007/tcp De plus, il faut mettre jour le fichier vtom.ini : CS_VERSIONS] RemoteFunctions:0
la valeur 0 inhibe les fonctions Planning prvisionnel et Simulation
La fonction Planning prvisionnel est accessible travers linterface graphique (cf Guide Utilisateur). Il est possible dautomatiser la production de ces tableaux de bord, dans un traitement soumis par Visual TOM. Sous UNIX, un traitement gnrant le planning prvisionnel est disponible dans $TOM_ADMIN/planprev et peut devenir votre modle de gnration de planning prvisionnel. Celui-ci pourra tre excut dans une application de votre production.
20/65
vt-admin-guide.doc

13/09/02
6.8 La mise en place des traces des moteurs

6.8.1 Fonctionnement des Traces sous Visual TOM

13/09/02
vt-admin-guide.doc
21/65
6.8.2 Options des traces dans vtom.ini

Toutes les options de traces sont regroupes dans la section [TRACES]. mode = [none, local , remote, both] ( Mode de fonctionnement des traces) - none : pas de traces - local : traces sur fichier local - remote : traces vers machine distante ( venir) - both : local + remote ( venir) family=[N, S, L, O, A ] ( Dfinit les familles de traces prises en compte) - (N)etwork : DNS, ports, client/server... - (S)ystem : espace disque, droits... - (L)ogical : logique Visual TOM - (O)ther : Autres .... - (A)ll : toutes les traces. Plusieurs options peuvent tre slectionnes (exemple NS pour Network et System) level=[C, E , I , D] (Dfinit les niveau de traces pris en compte) - (C)ritic : Problmes critiques. - (E)rror : Problmes corrigibles. - (I)nfo : Informations - (D)ebug : Informations dtailles. Un niveau positionne tous les niveaux suprieurs. directory= path (Rpertoire des traces. La valeur par dfaut est le rpertoire courant) filename= nom (Nom du fichier de traces) La valeur par dfaut est vtom.trc. Pour les moteurs le nom de l'environnement est utilis avec l'extension trc. filesize= taille-du-fichier Taille du fichier de traces en Mo. La valeur par dfaut est 10. 0 dfinie un fichier continu. Note: Sous UNIX le sparateur = est remplac par le symbole :
6.8.3 Visualisation d'un fichier de traces

Cette fonction s'applique un fichier de traces donn. Elle permet de : - Visualiser le contenu d'un fichier de traces. - Slectionner les traces en fonction de leur niveau - Slectionner les traces en fonction de leur famille - Slectionner les traces pour un intervalle de temps donn. - Obtenir des statistiques (nombre de traces, nombre d'erreur...) Syntaxe de la commande : traceview nom-de-fichier [paramtres] Les paramtres suivants sont optionnels. -B date dbut des traces (JJ/MM/AA) -E date fin des traces (JJ/MM/AA) -b heure dbut des traces (HHMMSS) -e heure fin des traces (HHMMSS) -L niveau des traces (C)ritic (E)rror <I>nfo (D)ebug -F famille des traces (N)etwork (S)ystem (L)ogical (O)ther <A>ll

13/09/02
-s statistiques -S statistiques seules -H Affiche l'aide
6.8.4 Modification des options d'un fichier de traces.

Cette fonction sapplique un fichier de traces donn. Elle permet de : - Modifier la taille d'un fichier de traces. - Modifier les familles de traces devant tre crites. - Modifier les niveaux de traces devant tre crits. - Vider un fichier de traces. Syntaxe de la commande : traceset nom-de-fichier [paramtres] Les paramtres suivants sont optionnels : -L Fixe le niveau des traces enregistres : (C)ritic (E)rror <I>nfo (D)ebug -F Fixe les Familles des traces enregistres : (N)etwork (S)ystem (L)ogical (O)ther <A>ll -S Taille du fichier en Mo, 0 pour continu -E Efface le contenu du fichier -H Affiche l'aide Exemple : traceset vtom.trc -L D -F A -E Cette commande efface le fichier vtom.trc et lui dit d'enregistrer toutes les traces (mode debug).

13/09/02
vt-admin-guide.doc
23/65
7 Les commandes du serveur Visual TOM

Sous Unix : La gestion courante des serveurs Visual TOM sur UNIX par le menu d'administration Visual TOM. Les traces d'arrt et de relance des serveurs sont traces dans le fichier servers.log que vous trouverez dans le rpertoire de base d'installation $TOM_HOME, vous pouvez aussi appeler les scripts utiliss dans admins : start_servers et stop_servers . La gestion des moteurs se fait par l'option 4 - Gestion des moteurs du menu admins. Ce menu fait appel aux scripts start_moteurs et stop_moteurs. Sous Windows : La gestion courante des serveurs Visual TOM se fait par les fichiers .bat du sousrpertoire tools du rpertoire vtom.
7.1 Dmarrage et arrt des processus du serveur

7.1.1 Dmarrage du dmon serveur de donnes
Pour UNIX : Pour NT : dserver $TOM_BASES voir tom-go.bat
Dmarre le dmon Visual TOM dserver sur le port de communication TCP/IP tomDBd avec la base de donnes dfinie par la variable $TOM_BASES.
7.1.2 Dmarrage du dmon serveur de notifications

Pour UNIX : Pour NT : pserver $TOM_BASES voir tom-go.bat
Dmarre le dmon Visual TOM pserver sur le port de communication TCP/IP ntfy avec la base de donnes dfinie par la variable $TOM_BASES.
7.1.3 Dmarrage du dmon serveur de graphisme

Pour UNIX : Pour NT : gserver $TOM_BASES voir tom-go.bat
Dmarre le dmon Visual TOM gserver sur le port de communication TCP/IP gwd avec la base de donnes dfinie par la variable $TOM_BASES.
7.1.4 Arrt dun processus dmon Visual TOM

Pour UNIX : dcs tomDBd dcs ntfy dcs gwd voir stop.bat
Pour NT :
Arrte respectivement les dmons Visual TOM dserver, pserver, et gserver.
24/65
vt-admin-guide.doc

13/09/02
7.2 Sauvegarde et restauration dune base

On peut sauvegarder une base de production en utilisant : - la commande tbackup - ou la commande texport
7.2.1 Sauvegarde du rpertoire de la base de donnes

tbackup /target=<path_de_sauvegarde> Cet outil de sauvegarde de la base de donnes fonctionne en client/serveur, c'est--dire que l'on peut raliser 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 donnes Visual TOM. Sous le rpertoire dfini par le path_de_sauvegarde est cr un rpertoire qui correspond la JJMMAA-HHMMSS sous lequel l'ensemble des fichiers de la base de donnes est sauvegard. Pour restaurer une base, Il faut dans un premier temps arrter tous les process Vtom puis copier la base sauvegarde puis relancer les services Vtom et lIHM.
7.2.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 donnes 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 dfaut) ou de slectionner un environnement, une application ou un traitement. Le fichier gnr peut tre modifi (en tenant compte des rgles syntaxiques) avant d'tre import dans une autre base de donnes (ou dans la mme base de donnes).
7.2.3 Import des objets dfinis dans un fichier texte

timport nom_fichier La commande timport permet de rcuprer des objets exports d'une autre base de donnes par la commande texport (cf. Les tableaux comparatifs des options des commandes taddjob et taddapp et leurs formats au mode import/export). Les objets dfinis dans le fichier d'export sont crs dans la base de donnes courante, ou s'ils existent dj, sont mis jour. Si les applications ou les traitements exports utilisent des objets qui n'existent pas dans la base de donnes courante, ceux-ci sont crs tels que dfinis dans le fichier d'export. Attention, pour les valeurs par dfaut, on rcupre les valeurs par dfaut de la nouvelle base de donnes (environnement ou applications).

13/09/02
vt-admin-guide.doc
25/65
7.3 La gestion des moteurs

7.3.1 Dmarrage dun moteur sur un Environnement
tengine nom_environnement [cycle_du_moteur] Dmarre le moteur de Visual TOM pour lenvironnement nom_environnement avec un cycle de scrutation de la base dune valeur fixe par [cycle_du_moteur] en secondes. Le cycle est sur Unix de 10 secondes par dfaut, et sur NT de 120 secondes par dfaut. Le tengine peut gnrer des traces sur la sortie cran, il est possible de les rediriger soit vers un fichier ( > nom_du_fichier) soit de les supprimer ( > /dev/null) Message de retour : Affiche les traces dfinies par le fichier de configuration .vtom.ini
7.3.2 Arrt dun moteur sur un Environnement

estop nom_environnement Demande larrt du moteur Visual TOM pour lenvironnement [nom_environnement]. Larrt effectif du moteur naura lieu qu la fin du cycle courant. Messages de retour : environnement non trouve lenvironnement a t trouv, mais le moteur nest pas actif arret du moteur demande lenvironnement a t trouv, mais le moteur nest pas actif
7.3.3 Remise OFF du flag moteur de linterface graphique pour un environnement

eclear nom_environnement Force OFF le flag signalant un Moteur actif pour lenvironnement [nom_environnement] (dans le cas o le flag moteur est ON mais aucun process tengine ny est associ). Message de retour possibles : Aucun moteur ne tourne sur cet environnement lenvironnement a t trouv, mais le moteur nest pas actif Environnement trouve , absence dun ;moteur signale dans la base lenvironnement a t trouv, mais le moteur nest pas actif arrt du moteur demande lenvironnement a t trouv, mais le moteur nest pas actif
7.3.4 Test de prsence dun moteur actif pour un environnement

epresent nom_environnement Signale si un Moteur est actif pour lenvironnement [nom_environnement]
26/65
vt-admin-guide.doc

13/09/02
7.4 Gestion de la production

7.4.1 Production dun fichier danalyse des excution des traitements Pour Unix :
tstat -B date_debut -E date_fin -e environnement [options] date_debut ,date_fin : environnement : format JJ-MM-AAAA (sous Unix, rsultat de la commande `date +%d-%m-%Y`) any pour produire le tableau de statistiques pour tous les environnements
Cette commande permet d'obtenir les tat des traitements status entre date_dbut et date_fin Les fichiers gnrs (format .tab ou .lis) peuvent tre trs simplement repris sous Excel.
Pour NT :
Gnrer le fichier ana.cfg laide du menu Analyse Dans linvite de commande dos, taper tstat ana.cfg Liste des Options de la fonction tstat pour UNIX: -o Ordre Dfinit les champs afficher et leur ordre d'affichage. Voir plus bas la liste des mots-cls pour l'option -o Par dfaut, deux pages sont spares par deux lignes vides. Cette option permet de positionner la place un saut de page. La sortie par dfaut des rsultats de tstat se fait dans deux fichiers dans le rpertoire $TOM_STATS. Les noms des fichiers sont gnrs avec comme base le type de report (ex.: anatrait) plus une chane drive des dates de dbut et fin. Leur extension est .tab ou .lis selon le format de rapport produit. L'option '-f' permet de transmettre la base du nom des fichiers de sortie. Si l'option '-f' est utilise avec l'argument '-' , la sortie se fait sur la sortie standard Par dfaut, le rapport est produit sous forme de tableau sans mise en page, les colonnes tant spares par des ';' (fichier de sortie avec extension .tab) L'option -l permet une sortie avec une mise en page (fichier d'extension .lis) Par dfaut, le sparateur de champ en mode tableau est le ';'. Cette option permet de dfinir l'argument comme sparateur. Ajoute au tableau produit par dfaut trois tableaux: job volume (nombre de jobs excuts) incidents volume (nombre d'incidents) temps en minutes (d'excution) Les lignes reprsentent les dates (de la date de dbut la date de fin du tstat), les colonnes
vt-admin-guide.doc 27/65
-p
sparateur de pages fichier de sortie
-f <fichier>
-l
Format du rapport : listing/tableau
-x <sep>
sparateur de champ (mode tableau) Ventilation
-v <champs>

13/09/02
-Z -s<id>
NON PLANIFIES Simulation
-T
type de statistiques
reprsentent les diffrents champs des arguments dfinis pour la ventilation Les deux champs possibles sont machines et applications. inclut les jobs non planifis Cette option permet l'analyse des traitements de la simulation <id> (ndu filtre de simulation) Attention, cette option doit tre le premier argument de la commande tstat Cette option est utilise par les scripts appels depuis l'interface graphique (anatrait, planprev et anasimu). Les trois valeurs possibles sont : prvisionnel : planning prvisionnel analyse : analyse des traitements effectus analyse_simulation
Liste des filtres possibles -m -a -F Machines Application Famille -u -c -q user calendrier queue
Attention : Si une option a plusieurs arguments, ils doivent tre spars par des virgules. (ex. : -m Jupiter, Uranus)
Liste complte des mots-cls associs loption -o pour la fonction tstat: ix_id machine Duree Mode relances situation Env status CP Sysdate Queue Rattrapage appl daytype IO systime user message jobname date_debut jobtype nom_dp periodicite ressource Famille date_fin Cal valeur_dp Cycle
7.4.2 Purge des statistiques Pour UNIX : tpurge nom_environnement date_limite $TOM_BASES Pour NT : idem Ou (UNIX et NT) : tpurge * date limite $TOM_BASES (purge tous les environnements dune base)
Purge lhistorique Visual TOM situ dans les fichiers stats.dbf et stats.cdx du rpertoire $TOM_BASES pour lenvironnement [nom_environnement] des informations enregistres avant la date [date_limite] incluse. Utilis sans arguments, tpurge retourne son usage : Usage : tpurge [environnement] [date] <directory> 'environnement' is th environnement to clean 'date' is DD-MM-YY[YY] or DD-month-YY[YY]

13/09/02
Exemple
tpurge Exploitation 12-jan-00 $TOM_BASES
7.5 Gestion de la planification

7.5.1 Demande de planification dun travail la demande
Pour UNIX : Pour NT : tstart environnement application [job] [par=xxx,yyy,,zzz] idem
Demande l'excution immdiate (passage au statut EN COURS) d'une application ou d'un traitement (quivalent l'option Demander dans le pilote graphique) Tout job soumis par Visual TOM peut demander (planifier) un Traitement ou une Application la demande .
7.5.2 Forage A VENIR des traitements dun environnement

Pour UNIX : Pour NT : treset nom_environnement nom_date_exploitation idem
Force A VENIR tous les jobs de lEnvironnement [nom_environnement] qui sont rattachs la date [nom_date_exploitation] : Rsultat STATUS :OK Environnement inexistant Date inexistante Un moteur tourne dans cet environnement - Arretez le avant treset FAILED (une erreur sest produite) Remarque : treset ne fonctionne que si aucun moteur ne tourne sur cet environnement.
7.5.3 Evaluation de planification pour un Traitement ou une Application

Pour UNIX : Pour NT : tform nom_environnement nom_application [nom_Traitement / all] tform nom_environnement nom_application [nom_Traitement] / all
Evalue la planification du Traitement ou de lApplication pour la valeur courante de sa date dexploitation. Retourne la date rattache au job ou lapplication, suivi de VRAI si le planning est vrifi ce jour ou FAUX si lapplication ou le traitement nest pas planifi. Exemple 1 Vrification du planning de lapplication AP01 de lenvironnement exploitation : tform exploitation AP01 today is 08-01-97 Planning returns : >> VRAI <<(0x1) Lapplication AP01 de lenvironnement exploitation est planifie le 8 janvier 1997. Exemple 2 Vrification du planning de tous les traitements de lapplication AP01 de lenvironnement exploitation : tform exploitation AP01 all today is for job imp012 08-01-97 Planning returns : >> VRAI << (0x1)
today is for job copA02 08-01-97 Planning returns : >> VRAI << (0x1) today is for job supS20 08-01-97 Planning returns : > > FAUX << (0x0) Le job supS20 de lapplication AP01 nest pas planifi le 8 janvier 1997, les autres jobs de cette application le sont. Exemple 3 Vrification du planning du traitement J003 de lapplication AP01 de lenvironnement exploitation : tform exploitation AP01 J003 today is for job J003 08-01-97 Planning returns : >> FAUX << (0x0) Le job J003 de lapplication AP01 nest pas planifi le 8 janvier 1997.
7.5.4 Affichage de la planification d'une application ou d'un traitement pour une priode donne
tplan /nom=Env/App[/Job] [/debut=JJ-MM-AAAA] [/fin=JJ-MM-AAAA] [/table] ou tplan /nom=Env/App[/Job] /annee[=AAAA] [/table]
/nom : nom complet de l'objet vtom (App ou Job) /dbut : Date de dbut d'analyse /fin : Date de fin d'analyse /anne : Analyse annuelle /table : visualisation en mode tableau annuel
7.5.5 Vrification des blocages de date

Pour UNIX : Pour NT : tchkdate /nom=date [/env=env] idem
30/65
vt-admin-guide.doc

13/09/02
8 Configuration du client Visual TOM

Le client Visual TOM est charg de : - l'excution des scripts associs aux traitements - ldition des scripts - et la visualisation et la suppression des logs dexcution des scripts Lors de la rception dune demande de soumission dun traitement envoye par un serveur Visual TOM, le client stocke les rfrences du traitement (pid, nom du script, ) dans une file dattente appele queue batch. Et selon le paramtrage de cette queue batch (nombre de jobs simultans, ), le client dcide ou non de lancer lexcution du script associ au traitement. Le lancement de lexcution dun script dun 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 grer plusieurs queue batch. La configuration dun client Visual TOM se base sur les paramtrages de trois types dobjets : - le numros de port de communication - les variables denvironnements de ladministrateur de Visual TOM pour un client Unix et les variables denvironnement systme pour un client Windows - les paramtres de configuration dfinis dans vtom.ini - les queue batch - les fichiers de commandes ou shells associs aux queue batch (submiiters) - le fichier de commande ou script shell de gestion des fichiers logs
8.1 Les ports de communication utiliss par un client

En dehors du port bdaemon, un seul port de communication est utilis par un client Visual TOM. Cest le port tomDBd du processus dserver du module serveur. La valeur par dfaut de ce port est 20001 et elle est dfinie dans le fichier /etc/services pour un systme Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un systme Windows NT. Cette valeur est mise jour automatiquement lors de linstallation dun client Windows NT, par contre, sur un systme Unix, la mise jour de la valeur du port tomDBd doit tre faite manuellement. Pour tester ltat de la communication dun client vers un serveur, il suffit de positionner la valeur de la variable denvironnement TOM_REMOTE_SERVER avec le nom de la machine du serveur Visual et de lire la valeur dune ressource de Visual TOM avec la commande tval Tval name <nom_ressource>
8.2 Les variables denvironnement de ladministrateur du client Visual TOM sous Unix
Comme pour un serveur Visual TOM Unix, les variables denvironnement de ladministrateur du client de Visual TOM sont dfinies dans le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL donne le type de shell associ ladministrateur du client de Visual TOM : ksh pour korn shell, Les valeurs de ces variables denvironnement sont positionnes lors de louverture dune session par ladministrateur de Visual TOM et elles sont utilises par le processus bdaemon; par exemple la variable $ABM_LOGS qui contient le nom du rpertoire des logs est utilise la fin de lexcution des traitements.
Le fichier vtom_init.[$SHELL] est gnr automatiquement dans le rpertoire $TOM_ADMIN lors de linstallation du module client Visual TOM, et il est intgr au fichier .profile de ladministrateur de Visual TOM. Dans la cas dune installation dun module serveur et dun module client sur la mme machine un seul fichier vtom_ini est gnr et il contient les variables denvironnement pour les processus du serveur et du client. Ci dessous un tableau qui donne la liste des variables denvironnement utilises par le module client de Visual TOM Gnrales Nom de la machine Rpertoire dinstallation de Visual TOM Rpertoire des scripts dadministration Administrateur Visual TOM
HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN
Client
ABM ABM_BIN ABM_LOGS ABM_SPOOL Rpertoire dinstallation du client ABM Rpertoire des excutables Rpertoire des logs Rpertoire de la file dattente des traitements
8.3 Les variables denvironnement systme Windows dun client Visual TOM
Lors de linstallation dun client, les variables d'environnement systme suivantes sont cres : - ABM_BIN = rpertoire des excutables du client Visual TOM - ABM_LOG = Rpertoire des logs La visualisation des valeurs des variables denvironnement systme de Windows se fait laide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement. Pour modifier lemplacement des logs, il suffit de modifier une cl de la registry ; pour cela il faut excuter la procdure suivante : 4. lancer l'utilitaire de modification de la registry : \winnt\system32\regedt32.exe 5. Ouvrir la fentre HKEY_LOCAL_MACHINE. Aller dans : System, CurrentControlSet, Control, Session Manager, Environment 6. Aller dans le Menu Edit et slectionner Add Value ou Ajouter une valeur. Value Name = ABM_LOG String = <nom_rpertoire>, faire OK Pour que le systme dexploitation prenne en compte la modification de la registry , il est ncessaire de redmarrer la machine. Aprs le redmarrage, la variable positionne doit apparatre dans la partie rserve aux variables systme (Demarrer\Panneau de configuration\Systeme\Environnement).

13/09/02

Sous Unix, ce fichier est gnr dans rpertoire $TOM_ADMIN lors de linstallation du

13/09/02
vt-admin-guide.doc
33/65
Sous Windows NT - Menu : Dmarrer / Outils d'Administration / Gestion des Utilisateurs - Stratgies - Cocher "Afficher les droits avancs des utilisateurs" - Slectionner les droits souhaits - Choisir Ajouter Sous Windows 2000 - Menu : Dmarrer / Paramtres / Panneau de configuration - Outils dadministration / Stratgie de scurit locale - Stratgies Locales / Attribution des droits utilisateurs - Slectionner les droits souhaits en double cliquant dessus - Choisir Ajouter et ajouter ladministrateur local pour chacun deux
Modification du dmarrage du service AbsyssBatchManager

A partir de la liste des services sous Windows, slectionner le service AbsyssBatchManager , arrter le service et cliquer avec le bouton droit pour afficher ses proprits . Dans longlet connexion choisir Ouvrir une session en tant que ce compte et slectionner le compte utilisateur dfini prcdemment.
8.6.2 Gestion des utilisateurs par le client Visual TOM

Linstallation par dfaut du client Visual TOM ne gre pas les utilisateurs ; cest dire que la valeur du paramtre utilisateur dun traitement nest pas pris en compte par le client Visual TOM. Pour que le client Visual TOM puisse grer des utilisateurs, il faut dclarer ceux-ci dans le fichier vtom.ini. [bdaemon] users=1
la valeur 0 pour ne pas prendre en compte cette gestion des utilisateurs
[users] user1=<domaine>,<utilisateur>,<mot de passe> user2=<domaine>,<utilisateur>,<mot de passe> ... usern=<domaine>,<utilisateur>,<mot de passe> Remarques: <Domaine> : pour le champ domaine, il est possible d'indiquer le nom du domaine ou le nom d'une machine. Pour indiquer un utilisateur local, mettre un point la place du champ domaine . <Mot de passe> : Les mots de passe devant tre affichs en clair, il est prfrable de protger le fichier vtom.ini (le rendre accessible en lecture uniquement par l'administrateur).
Exemple : [bdaemon] users=1 0 pour ne pas prendre en compte cette gestion des utilisateurs [users] user1=AbsyssDomain,Lambda,TOM utilisateur du domaine AbsyssDomain user2=.,admin,TOM utilisateur local la machine cliente
34/65
vt-admin-guide.doc

13/09/02
8.7 les queue batch

Une queue batch est un objet de Visual TOM qui permet un client de grer des files dattente de traitements soumettre. A chaque queue batch est associ un script shell sous Unix ou un fichier de commandes sous Windows qui en capsule lexcution du script dun traitement. Ce script shell ou fichier de commandes est appel submitter; par exemple : - Sous un client Unix, un traitement dfini avec la queue batch queue_ksh sera soumis par le script shell tom_submit.ksh - Sous un client Windows NT, un traitement dfini avec la queue batch queue_wnt sera soumis par le fichier de commandes Submit_queue_wnt.bat
8.7.1 Configuration dune queue batch sous un client Unix

A chaque queue batch correspond un sous-rpertoire sous le chemin $ABM/config/queues. Ce sous-rpertoire contient les fichiers suivants : o fichier de configuration de la queue: queue.conf o dfinition des utilisateurs: users La description du fichier queue.conf est la suivante : N: Nombre maximum de jobs en excution simultane M: Nombre Maximum de jobs en attente Shell : Chemin et nom du shell P: priorit des jobs dans la queue (non utilise sous UNIX) Exemple : Fichier $ABM/config/queues/prod/queue_config de la queue prod 15 5 /user/bin/tcsh 4 Le queue prod a droit a 15 jobs en excution simultane 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).
8.7.1.1 Configuration des administrateurs

Un administrateur est un utilisateur du systme dexploitation qui peut grer toutes les queues et tous les jobs. Il est le seul habilit arrt et dmarrer le client. La liste des administrateurs est dfinie dans le fichier $ABM_CONFIG/managers
8.7.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 excuts en mme 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 dfinie dans le fichier users. NB : La dclaration du user "any" dans une queue rend accessible cette queue tout les users non dclars. Exemple : le fichier $ABM/config/queues/prod/users de la queue prod oracle:1:1 Lutilisateur oracle a droit a un seul job en excution et un seul job en attente dans la queue prod
8.7.2 Configuration dune queue batch sous un client Windows

La liste des queue batch est dclare dans le paramtre ABM_QUEUE de la section [bdaemon] du fichier vtom.ini. A linstallation, il n y a quune seule queue qui est dclare, cest la queue queue_wnt. Dans le fichier vtom.ini gnr linstallation 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 simultans autoriss (par exemple 10) sur la ligne ABM_QUEUE. ABM_QUEUE : /queue_wnt :1 /queue_test :10 Il faut aussi crer un submiiter associ toute nouvelle queue_batch et arrter et redmarrer le service AbsyssBatchManager.
8.8 Les Submitter

On rappelle quun Submiitter est un script shell ou un fichier de commandes associ une quueue batch. Le submiiter est excut avant la soumission de tout traitement. Sous Unix, les submiiter se trouvent dans le rpertoire point par la variable $TOM_ADMIN sous Ubix, et sous Windows ces submitter se trouvent dans le rpertoire point par la variable %ABM_BIN% Exemple dexcution dun traitement ayant pour script job_test et pour queue batch queue_test : - le Client Visual TOM Unix dclenchera alors le script tom_submit avec lextension test soit $TOM_ADMIN/tom_submit.test, en lui transmettant le nom du script excuter et une liste de valeurs de variables denvironnement - Le client Visual TOM Windows dclenchera alors le fichier de commandes %ABM_BIN%/Submit_queue_test.bat en lui transmettant le nom du script excuter et une liste de valeurs de variables denvironnementparamtres
36/65
vt-admin-guide.doc

13/09/02
Le tableau ci-aprs liste les variables d'environnement qui sont transmises par le client Visual TOM au Submiiter : TOM_REMOTE_SERVER TOM_JOB_ID TOM_JOB TOM_APPLICATION TOM_ENVIRONMENT TOM_DATE TOM_DATE_VALUE TOM_USER TOM_SCRIPT TOM_SCRIPT_ARGS TOM_QUEUE_PRIORITY TOM_JOB_RETRY TOM_JOB_POINT Nom de la machine serveur Visual TOM qui a lanc le traitement. Identifiant du traitement dans la base de donnes Nom du traitement Nom de lapplication Nom de lenvironnement Nom de la date dexploitation Valeur de la date dexploitation Utilisateur excution du traitement Nom du script a excuter Liste des paramtres du script ou job Priorit du job Nombre de reprises effectues Point de reprise. La valeur de la variable denvironnement TOM_JOB_POINT est gale 0 par dfaut. La modification de la valeur de cette variable denvironnement seffectue laide de la commande tstep (tstep l <valeur), ce qui permet la relance du script un step donn Mode excution Nom de la famille statistique Nom de la queue batch associe Action effectuer sur les fichiers log Nom de la machine dexcution
TOM_JOB_EXEC TOM_FAMILY TOM_QUEUE TOM_LOG_ACTION TOM_HOST
Ces variables denvironnement peuvent tre utilises pour personnaliser le submitter ; Par exemple lenvoi dun message sur une console lorsquun traitement se termine en erreur. Lexcution dun Submitter standard se droule de la manire suivante :: - Laffichage dans la log des valeurs des variables denvironnement - Lexcution du script - La gestion du code retour du traitement, acquittement ou remonte d'erreur Visual TOM par la commande tsend - La gestion des fichiers logs en fin de traitement
8.9 Gestion des logs

Tout traitement soumis par le client Visual TOM gnre deux fichiers de traces d'excution appele fichiers log. Ces fichiers sont gnrs sur le sous-rpertoire point par la variable denvironnement ABM_LOGS pour Unix et ABM_LOG pour Windows et portent lidentifiant suivant : nom_env_nom_appli_nom_ job_ AAMMJJ-HHMMSS.o standard nom_env_nom_appli_nom_ job_ AAMMJJ-HHMMSS.e sortie
sortie erreur
Par dfaut Visual TOM gnre deux fichiers log pour chaque excution dun traitement. Il est possible de modifier ce comportement par l'intermdiaire du menu fin de traitement (voir
dfinition dun 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 dfinition dun traitement sont transmises par lintermdiaire de la variable denvironnement TOM_LOG_ACTION, et sont traites par le script ou fichier de commandes gestlog situ dans le rpertoire $TOM_ADMIN pour Unix ou %ABM_BIN % pour Windows. Pour modifier le comportement par dfaut de la gestion des logs, il suffit de personnaliser le script ou fichier de commandes gestlog en tenant compte des variables denvironnement suivantes : TOM_SCRIPT : TOM_LOG : TOM_LOG_ACTION : nom du script nom de la log action accomplir sur la log
8.10 Gestion des priorits dexcution dans les queue batch

Cette fonctionnalit est oprationnelle partir de la version 4.0. Lors de la soumission dun traitement un client Visual TOM, la variable denvironnement TOM_QUEUE_PRIORITY du contexte du traitement contient la valeur de la priorit du traitement. Cette valeur est comprise entre 0 et 10, et la valeur par dfaut de la priorit dun traitement est de 5.
Paramtrage de la priorit dun traitement ou dfinition de la priorit les caractristiques dun traitement :
Les caractristiques dun traitement ne possdent pas de champ priorit. Pour paramtrer la priorit dun traitement, on utilise le nom de la queue batch du traitement et on procde de la manire suivante en prenant comme exemple un traitement qui a pour queue batch queue_wnt : 1. Crez la queue batch avec queue_wnt.x ; x est la valeur de la priorit du traitement dans la queue batch queue_wnt 2. Modifiez la dfinition du traitement en mettant dans le champ queue batch : queue_wnt.x
Paramtrage du fichier vtom.ini du client Visual TOM :

Sous Windows, ajouter le paramtre ABM_QUEUES_PRIORITY_INCREMENT=BY_ONE dans la section [BDAEMON] [BDAEMON] ABM_QUEUES=/queue_wnt:1 ABM_QUEUES_PRIORITY_INCREMENT=BY_ONE Sous Unix, ajouter le paramtre ABM_QUEUES_PRIORITY_INCREMENT=BY_ONE dans la section [BDAEMON] [BDAEMON] ABM_QUEUES_PRIORITY_INCREMENT:BY_ONE Dans $ABM/config/queues/queue_test/queue.conf mettre jour le nombre de priorit par queue_test 3
38/65
/* Nom de la queue */ /* Nombre maximum de job sexcutant en parallle */

vt-admin-guide.doc

13/09/02
-1 /bin/ksh 20 Paramtrage :
/* Nombre maximum de job en attente de soumission */ /* Shell utilis */ /* Priorit (non utilis) */
ABM_QUEUES_PRIORITY_INCREMENT peut prendre les valeurs : DISABLED La gestion des priorits est dsactive BY_ONE Aprs chaque fin de job, la queue est mise a jour en incrmentant la priorit courante de 1 BY_PRIORITY Aprs chaque fin de job, la queue est mise a jour en incrmentant la priorit courante par la priorit initiale Ce paramtre implique quun job se trouvant dans la queue depuis longtemps prend une priorit de plus en plus grande et fini par tre soumis. La priorit initiale varie de 0 10. Les jobs de priorit 10 passeront en priorit (mme devant des jobs ayant une priorit courante de plus de 10) et leur priorit courante nest pas incrmente. Les jobs de priorit 0 passent en dernier et leur priorit courante nest pas incrment. Une variable TOM_QUEUE_PRIORITY est exporte dans lenvironnement dexcution du job. Cette variable contient la valeur de la priorit initiale du job dans la queue. Par dfaut, si la queue ne comporte pas lextension.x, les jobs ont une priorit 5. Sous Unix : ABM_QUEUES_PRIORITY_TRACE:oui/non Ce paramtre sert de gnrateur de Traces dans le bdaemon.

13/09/02
vt-admin-guide.doc
39/65
9 Les commandes du client Visual TOM

Le client Unix Visual TOM se gre par le menu adminc. Les dmarrages et arrts du dmon client sont archivs dans le fichier client.log du rpertoire d'installation de Visual TOM. Vous pouvez aussi utiliser les scripts start_client et stop_client.
9.1 Dmarrage et arrt du dmon client

Il existe un fichier de configuration des administrateurs du client Unix Visual TOM : le fichier $ABM/config/managers. Seuls les administrateurs dfinis dans ce fichier peuvent arrter et lancer le client Unix Visual TOM.
9.1.1 Dmarrage du dmon client

Pour UNIX : Pour NT : Pour VMS : Pour AS400 : $ABM_BIN/bdaemon voir tom-go.bat call SYS$startup : vtomstartup.com ABM_STOP Call SYS_AUTO/VPRDO60C
Dmarre le dmon Visual TOM Absyss Batch Manager utilisant le port TCP/IP bdaemon dfini dans le fichier /etc/services. Retourne la valeur des variables $ABM_LOGS et $ABM
9.1.2
Arrt du dmon client

bdown [-a] voir tom-stop.bat ABM_START call SYS_AUTO/BDOWN
Pour UNIX : Pour NT : Pour VMS : Pour AS400 :
Stoppe le dmon Visual TOM Absyss Batch Manager. Lemploi de l'option -a provoque un arrt immdiat sans tenir compte des ventuels jobs actifs. Seuls les utilisateurs dfinis dans le fichier de configuration manager ont la possibilit d'utiliser cette commande.
9.2 statistiques dutilisation des files dattente du client

Pour UNIX : bstat Pour NT : commande inexistante Affiche pour chaque queue batch le nombre de jobs EN ATTENTE, en cours dexcution... Exemple Queue queue_tcsh Visual TOM prod
User
Run 0 3 1
MRun 10 -1 5
Wait 0 0 1
Mwait -1 -1 5
Lutilisateur Visual TOM a trois jobs en cours dexcution (pour un maximum infini), et aucun job EN ATTENTE. Lutilisateur prod a un jobs en excution (pour un maximum de trois en excution simultane), et un job EN ATTENTE (pour un maximum de cinq).
40/65
vt-admin-guide.doc

13/09/02
Seuls les utilisateurs dfinis dans le fichier de configuration manager ont la possibilit d'utiliser cette commande.
9.3 statistiques dutilisation des files dattente par un utilisateur

Pour UNIX : Pour NT : buser commande inexistante
Affiche pour lutilisateur courant le nombre de jobs EN ATTENTE, en cours dexcution pour l'utilisateur qui lance cette commande.
9.4 La gestion de lordonnancement

9.4.1 Valorisation ou consultation dune ressource
Tout traitement soumis par Visual TOM peut consulter ou valoriser une Ressource Globale (dfinie au niveau du Domaine dexploitation) ou une Ressource Locale. Pour UNIX et NT : tval -name nom_ressource info : Renvoie la valeur de la ressource globale nom_ressource tval -name nom_ressource -value valeur: Valorise la ressource globale nom_ressource la valeur valeur tval [-env nom_environnement ] -name nom_ressource -info Renvoie la valeur de la ressource nom_ressource locale nom_environnement tval [-env nom_environnement ] -name nom_ressource -value Valorise la ressource nom_ressource locale nom_environnement la valeur valeur Pour la gestion des ressources de type pile, vous devez utiliser les commandes tpush, tpop et tempty.
9.4.2 Ajout d'un lment dans une pile

La commande tpush permet d'ajouter un lment la fin d'une ressource de type pile. Syntaxe de la commande : Pour UNIX : tpush -name <nom de la pile> -value <valeur>] [-info] Pour NT : idem Valeurs de retour : Si l'argument -value n'est pas transmis, valeur du premier lment de la pile ; Valeur de llment insr si le tpush a russi (code retour 0) ; Message ressource inconnue si la ressource nexiste pas dans la base (code retour 1) ; Contenu de la pile avec l'option -info.
9.4.3 Suppression du 1er lment d'une pile

La commande tpop permet de supprimer le premier lment d'une ressource de type pile. Syntaxe de la commande : Pour UNIX : tpop -name <nom de la pile> Pour NT : idem Valeurs de retour : Message ressource inconnue si la ressource nexiste pas dans la base (code retour 1) ; Code de retour 0 si la mise jour a russi.

13/09/02
vt-admin-guide.doc
41/65
9.4.4 Suppression de tous les lments d'une pile

La commande tempty permet de vider le contenu d'une ressource de type pile. Syntaxe de la commande : Pour UNIX : tempty -name <nom de la pile> Pour NT : idem Valeurs de retour : Message ressource inconnue si la ressource nexiste pas dans la base (code retour 1) ; Code de retour 0 si la mise jour a russi.
9.5 La gestion du code retour et des reprises des traitements

9.5.1 Envoi du statut de fin dun traitement au serveur
Tout traitement soumis par Visual TOM doit signaler sa bonne fin. Cette fonction est assure par la commande tsend. Tout traitement termin sans effectuer cette commande sera considr comme EN ERREUR. Cette commande doit donc terminer tous les Traitements soumis par Visual TOM. Cest le script den capsulage qui prend en charge cette fonction. Pour UNIX : Pour NT : tsend [-sY] [-m"Message"] idem
Utilis sans options, tsend renvoie pour le job courant le statut de fin normale TERMINE (il n'est pas possible d'utiliser tsend pour un traitement autre que le traitement courant). Option -s (nouveau statut du traitement) : Il est possible d'altrer le comportement par dfaut de la commande tsend en utilisant L'option sY, o Y est le nouveau statut du job. Les valeurs possibles de Y sont : A A VENIR (Le job est nouveau ligible pour soumission par Visual TOM) T TERMINE E EN ERREUR N NON PLANIFIE Attention, dans ce cas il ne faut pas que le tsend du submitter soit excut car il forcerait nouveau le statut du job Option -m (message remonter dans la colonne info du suivi d'exploitation). -
9.5.2 Notification du label de reprise

Lors de son excution, un Traitement a la possibilit de signaler l'tat interne de son avancement Visual TOM, et ainsi de signaler quel label il doit tre redmarr en cas derreur. tstep -l valeur_label [-e nom_environnement -a nom_application - j nom_job Positionne la variable denvironnement du traitement de label de reprise du traitement TOM_JOB_POINT courant (ou du traitement nom_environnement nom_application nom_traitement) la valeur numrique valeur_label. Pour avoir la possibilit de grer des labels de reprise alphanumrique (maximum 16 caractres), il faut ajouter dans le fichier vtom.ini du serveur, Pour NT :

13/09/02
[globales] AcceptAlphaStep=1 Pour UNIX [general] AcceptAlphaStep:1

13/09/02
vt-admin-guide.doc
43/65
10 Configuration dune IHM Visual TOM

Linterface graphique de Visual TOM permet : - de dfinir et de modifier les objets de la base de donnes du serveur - piloter lexploitation - dditer les scripts associs aux traitements - et de visualiser les logs dexcution des scripts Linterface graphique communique - avec le serveur en utilisant les ports de communications tomDBd, gwd et ntfy - avec les clients (pour ldition des scripts et la consultation des logs) en utilisant le port de communication bdaemon Lexcutable qui permet de lancer linterface graphique est vtom ; il est situ dans le rpertoire dinstallation de linterface graphique visual La configuration dune IHM Visual TOM se base sur les paramtrages de trois types dobjets : - les numro de port des communication du tomDBd, gwd, ntfy et bdaemon les variables denvironnements de ladministrateur de Visual TOM pour une IHM Unix et les variables denvironnement systme pour une IHM Windows les paramtres de configuration dfinis dans vtom.ini
10.1 Les ports de communication utiliss par une IHM

Les ports de communication utiliss par linterface graphique sont - tomDB pour communiquer le processus dserver du module serveur ; la valeur par dfaut de ce port est 20001 - gwd pour communiquer le processus gwd du module serveur ; la valeur par dfaut de ce port est 20002 - ntfy pour communiquer le processus pserver du module serveur ; la valeur par dfaut de ce port est 20003 - bdaemon pour communiquer les processus des clients Visual TOM ; la valeur par dfaut de ce port est 20004 Ces ports de communication sont dclars dans le fichier /etc/services pour un systme Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un systme Windows. La dclaration des ports de communication est faite automatiquement lors de linstallation de liHM Windows, par contre, sur un systme Unix, cette dclaration doit tre faite manuellement.
10.2 Les variables denvironnement de ladministrateur de lIHM sous Unix

Ladministrateur dune IHM Visual TOM est le mme que ladministrateur du serveur Visual car linstallation dune IHM sous Unix nest possible quavec une installation dun module serveur.

13/09/02
Les variables denvironnement de ladministrateur de lIHM de Visual TOM sont dfinies dans le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL donne le type de shell associ ladministrateur de lIHMVisual TOM : ksh pour korn shell, Les valeurs de ces variables denvironnement sont positionnes lors de louverture dune session par ladministrateur de Visual TOM Le fichier vtom_init.[$SHELL] est gnr automatiquement dans le sous-rpertoire $TOM_ADMIN lors de linstallation du module client Visual TOM, et il est intgr au fichier .profile de ladministrateur de Visual TOM. Ci dessous un tableau synthtise les variables denvironnement utilises par le module IHM de Visual TOM Gnrales Nom de la machine Rpertoire dinstallation de Visual TOM Rpertoire des scripts dadministration Administrateur Visual TOM
HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN
IHM (Interface graphique)

TOM_VISUAL TOM_LP ND_PATH Rpertoire dinstallation de linterface graphique Script associ l'impression dans l'interface graphique Chemin pour les fichiers de configuration Neuron Data ($TOM_VISUAL)
10.3 Les variables denvironnement systme Windows dune IHM

Une seule variable d'environnement systme est cre lors de linstallation dune IHM Visual TOM Windows, ND_PATH qui contient le nom du rpertoire des fichiers de configuration Neuron Data.

Sous Unix, ce fichier est gnr dans rpertoire $TOM_ADMIN lors de linstallation du serveur et de lIHM; cest un fichier cach .vtom.ini. Sous Windows, Ce fichier est gnr lors de linstallation dans le rpertoire %windir%. Dans le cas dune installation dun serveur (avec IHM) et dun client sur la mme machine, un seul fichier vtom.ini est gnr avec les paramtres du serveur, de lIHM et du client. Nota : Toute modification de ce fichier ncessite un arrt et une relance de lIHM Visual TOM pour tre prise en compte.
Fichier vtom.ini pour Unix

[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 Lutilisation des paramtres documentation et browser sera aborde dans le chapitre mise en place de la fonctionnalit documentation et consignes.
10.5 Mise en place des fonctionnalits documentation et consignes

Cette fonctionnalit permet l'accs depuis l'IHM Visual TOM des pages au format HTML Vous pouvez crez pour chaque entit (application et traitement) un dossier dexploitation qui contient tout le descriptif de l'entit laquelle il est associ un dossier qui contient les consignes d'exploitation destines aux exploitants dans lesquelles on trouve les informations relatives au contexte de production telles que la valeur des paramtres, les consignes de reprise.
L'accs ces document dossiers se fait par l'intermdiaire ditems dans les menus contextuels des applications et des traitements : En mode dfinition on accde aux deux types de documents lis l'entit slectionne En suivi ou pilotage on accde aux consignes lies l'entit slectionne.
Les documents identifis par le nom de l'entit associe doivent tre gnrs dans des rpertoire rfrenc dans le fichier vtom.ini par le paramtre documentation de la section [vtom]: Nommage dun document de type documentation pour une application : env_app_doc.htm; env = nom de lenvironnement ; app = nom de lapplication Nommage dun document de type consignes pour une application : env_app_recovery.htm ; env = nom de lenvironnement ; app = nom de lapplication Nommage dun document de type documentation pour un traitement : env_app_job_doc.htm; env = nom de lenvironnement ; app = nom de lapplication ; job = nom du traitement Nommage dun document de type consignes pour un traitement : env_app_job_recovery.htm; env = nom de lenvironnement ; app = nom de lapplication ; job = nom du traitement Laccs ces dossiers dexploitation et de consignes se fait laide dun browser que vous aurez rfrenc dans le paramtre browser de la section [aide] du fichier vtom.ini.
46/65
vt-admin-guide.doc

13/09/02
10.6 Mise en place de la fonction impression des logs et des scripts

Sous Unix, il suffit de positionner la variable denvironnement $TOM_LP dans vtom_init.[$Shell] par le chemin absolu dun script qui permet dimprimer un fichier avec comme argument le nom du fichier. Sous Windows, il faut procder de la manire suivante : 1. Crez un fichier de commandes TOM_LP.bat Contenant la commande dimpression : print[/d:priphrique] [lecteur:][chemin] "%1" - pour une imprimante locale print /d:\\nom_serveur\imprimante_partag "%1" - pour une imprimante rseau 2. Crez une variable d'environnement [Panneau de configuration/systme/onglet environnement] Variable : TOM_LP Valeur : [chemin du rpertoire]\TOM_LP.bat

13/09/02
vt-admin-guide.doc
47/65
11 Conception et Pilotage de la production en mode commande

Ces commandes ne sont disponibles que sur machine serveur Visual TOM.
11.1 Ajout ou modification dobjets dans le domaine dexploitation

11.1.1 liste des objets dfinis dans le domaine d'exploitation
tlist - liste les objets du domaine d'exploitation La commande tlist permet de rcuprer 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 status (etats autres que A VENIR ou EN COURS). Utilise sans arguments, tlist renvoie son usage. Usage : tlist [-v | -h | -d] <nom de l'objet> ou tlist <nom de l'objet> [-v | -h | -d] avec -v : mode 'verbose' -d : mode 'debug' -h : aide et avec <nom de l'objet> : - jobs : liste des jobs - dates : liste des dates - calendriers : liste des calendriers - utilisateurs : liste des utilisateurs - resources : liste des ressources - machines : liste des machines - tokens : liste des tokens - bloquage : liste des blocages - nodes : liste des nodes - notify 1 : liste des notifications - retenus : liste des jobs retenus - ENERREUR : liste des jobs en erreur - ENCOURS : liste des jobs en cours - AVENIR : liste des jobs a venir - DEPLANIFIE : liste des jobs deplanifies - NONPLANIFIE : liste des jobs non planifies - TERMINE : liste des jobs termines Exemples : >tlist -v dates >tlist -v jobs >tlist -v app >tlist -v AVENIR >tlist ENCOURS v
48/65
vt-admin-guide.doc

13/09/02
11.1.2 Ajout ou modification d'une date d'exploitation

Pour UNIX : taddate /nom=nom_date_exploitation [ /val=<valeur_date> ] [ /typ=<type_date> ] Pour NT : idem La commande tadddate permet la modification de la valeur dune date dexploitation globale lenvironnement.
Options /valeur= /type= valeur par dfaut date systme automatique arguments date au format JJ-Mmm-AA[AA] ou JJ-MM-AA[AA] (ex. : 12-Fev-1997 ou 12-02-97 ou 12-Fev-97 ou 12-02-1997) automatique, constante ou systme
11.1.3 Suppression d'une date d'exploitation

Pour UNIX : tdatedel <id date> KO sur UNIX et NT)
La commande tdatedel permet de supprimer une date d'exploitation par la ligne de commande. L'id de la date supprimer peut tre rcupr par la commande tlist -v dates. Attention, la date et toutes ses rfrences seront supprimes. (Vrifiez les dpendances de la date l'aide des rfrences croises). Il est donc prfrable de supprimer les dates par l'interface graphique et de n'utiliser tdatedel qu'en cas de ncessit.
11.1.4 Ajout ou modification d'une ressource

Pour UNIX : taddres /nom=<nom_ressource> /type=<type_ressource> [ /valeur=<valeur ressource> ] Pour NT : idem La commande taddres permet la cration dune ressource globale de lenvironnement. Le nom et le type de la ressource sont obligatoires. Si le nom de la ressource est existant, alors la ressource est modifie ; sinon elle est cre. Remarques La ressource de type Date est non oprationnelle pour UNIX et NT. Loption /valeur nest pas supporte sur UNIX et NT.
11.1.5 Ajout ou modification d'un utilisateur

La commande tadduser permet lajout ou la modification dun utilisateur du domaine dexploitation Pour UNIX : tadduser /nom=<utilisateur> /password=<mot de passe> [options] Pour NT : idem Liste des options: /droits=<XXXXXXXXXXXXXXXX> X=0: Lecture X=1: Lecture et ecriture (defaut) X=4: Aucun byte 01 - Date d'exploitation byte 02 - Calendriers byte 03 - Periodes byte 04 - Ressources byte 05 - Utilisateurs
byte 06 - Machines byte 07 - Queue batch byte 08 - Environnement byte 09 - Jeton byte 10 - Pilote (Visualiser) byte 11 - Pilote (Agir) byte 12 - Moteur (Demarrer) byte 13 - Moteur (Arreter) byte 14 - Statistique (Lancer) byte 15 - Statistiques Graphiques (Lancer) byte 16 - Simulation (Lancer) Exemple: /droits=1110044111111111 /droits_env=<<nom_env>[XY],...> X= L ou - : Lecture ou inactif Y= E ou - : Ecriture ou inactif /nom_usuel=<Nom usuel> /comment=<Commentaire> /print=<Commande d'impression>
11.1.6 Suppression d'un utilisateur

Pour UNIX : tdeluser /nom=<nom utilisateur> Pour Windows : non support
11.1.7 Modification du nom d'une machine

Pour UNIX : tmodmach /nom=<ancien nom> /nouveau=<nouveau nom>
11.1.8 Ajout dune queue

Pour Unix : taddqueue <nom_queue>
50/65
vt-admin-guide.doc

13/09/02
11.2 Ajout et modification dune application

Pour UNIX : Pour NT : taddapp /nom=env/app [options] idem
La commande taddapp permet la cration dune application dans un environnement et une application avec toutes ses caractristiques dfinies en options (voir le tableau des options de la commande taddapp ci-aprs). Si l'application existe dj, elle est mise jour avec les nouvelles valeurs transmises en argument la commande taddapp. Si des options ne sont pas prcises, l'application conserve ses anciennes valeurs pour ces champs. En mode cration, seul le nom de l'application est obligatoire. Pour les champs qui ne sont pas prciss, lapplication hrite alors des caractristiques par dfaut de lenvironnement. Les options de la commande taddapp pour UNIX et NT
Caractristique Nom Commentaire Famille Date dexploitation Type de priodicit Cyclique priode du cycle Periodicit Heure de dpart minimum Heure de dpart maximum Mode d'excution Machine Queue batch Utilisateur ne pas dplanifier les successeurs Heure de dplanification Liste des paramtres Lien de ... Mode commande /Nom /Comm /Family /date /TypePer /Cyclique /Cycle /Per /Hdeb /Hfin /Mode /Machine /Queue /User /NonDepl /Hdepl /Par /LienDe Mode export [job:<env>/<app >] commentaire famille Date Type_periodicite cyclique Cycle periodicite heure_debut heure_fin mode machine queue User ne_pas_deplanifier heure_deplanification parametres Liens_de valeurs / format <nom de lapplication> <"commentaire"> < famille > <nom date dexploitation> periodique | demande oui | non <heure> journaliere | hebdomadaire | mensuel | annuel <heure> <heure> job | stop | exec | test | simu <"machine"> <"queue"> <"utilisateur"> oui | non <heure> < par1 >[,< par2 >,...,< parn >] < env >/< appli >/< job >[< type de lien >] type de lien : obli | facu | excl | cond | erre
vt-admin-guide.doc
dfaut obligatoire aucun aucune obligatoire periodique non 00:00:00 journalire 00:00:00 illimite job defaut de l'application defaut de l'application defaut de l'application non 23:59:59 aucun aucun

13/09/02
51/65
Lien vers ... Calendrier Jours de la semaine Jours du mois Semaines du mois Mois de l'anne Formule Ressources Statut Gomtrie couleur bordure couleur fond couleur titre Copie de ... Mise en exploitation
/LienVers /Cal /Jsem /Jmois /Smois /Mannee /Formule /Res /status /Geom /Cbord /Cfond /Ctitre /De /exploit
Liens_vers calendrier jour_semaine jour_mois semaine_mois mois_annee ressource status geometrie sfrmclr sbgclr sfrblclr NON DISPONIBLE
< env >/< appli >/< job >[< type de lien >] type de lien : obli | facu | excl | cond | erre <calendrier> O,C,R,F c * 7 O,C,R,F c * 31 O,C,R,F O,C,R,F c * 12
aucun defaut de lapplication OOOOOOO (O * 7) C * 31 OOOOO OOOOOOOOOOOO aucune aucune

AV (a venir)
NO (non planfi) | AV (a venir) | EN (en cours) | ER (en erreur) | TE (termin) | DE (deplanifi)
hxl+y+x h:hauteur, l: largeur, y: ordonne, x:abscisse
90*16+0+0 defaut IHM defaut IHM defaut IHM aucun
< env >/< appli > 1 pour la mise en exploitation
52/65
vt-admin-guide.doc

13/09/02
11.3 Ajout ou modification d'un traitement

Pour UNIX : Pour NT : taddjob /nom=env/app/job /script=<nom_script> [ options ] idem
La commande taddjob permet la cration ou la modification dun job dans un environnement et une application avec toutes ses caractristiques dfinies en options (voir le tableau des options de la commande taddjob ci-aprs). En mode cration, seuls le nom et le script du traitement sont obligatoires. Le traitement hrite alors de toutes les caractristiques par dfaut de lapplication. Si le nom du traitement n'existe pas dans l'application et l'environnement rfrences, le traitement est cr, sinon il est mis jour. Les options de la commande taddjob pour UNIX et NT
Caractristique Nom Script Commentaire Famille Type de priodicit Cyclique priode du cycle Periodicit Heure de dpart minimum Heure de dpart maximum Mode d'excution Machine Queue batch Utilisateur ne pas dplanifier les successeurs Heure de dplanification Blocage de la date d'exploitation mettre l'application en erreur Liste des paramtres
13/09/02
Mode commande /Nom /Script /Comm /Family /TypePer /Cyclique /Cycle /Per /Hdeb /Hfin /Mode /Machine /Queue /User /NonDepl /Hdepl /Bloquant /ApplErr /Par
Mode export [job:<env>/<app>/<job>] Script commentaire Famille type_periodicite cyclique cycle periodicite heure_debut heure_fin mode machine queue user ne_pas_deplanifier heure_deplanification bloquer_la_date mettre_application_en_err eur parametres
valeurs / format <nom du job> <script> <"commentaire"> < famille > periodique | demande oui | non <heure> journaliere | hebdomadaire | mensuel | annuel <heure> <heure> stop | exec | test | simu <"machine"> <"queue"> <"utilisateur"> oui | non <heure> oui | non oui | non < par1 >[,< par2 >,...,< parn >]
vt-admin-guide.doc
dfaut obligatoire obligatoire aucun aucune periodique non 00:00:00 journalire 00:00:00 illimite exec defaut de l'application defaut de l'application defaut de l'application non 23:59:59 oui oui aucun
53/65
11.4 Suppression d'un traitement

Pour UNIX : Pour NT : tdeljob -a app e env -j job idem
La commande tdeljob permet de supprimer un job donn d'une application donne d'un environnement donn.
11.5 Suppression dun lien

Pour UNIX : Pour NT : tdellink env/app/job (de)env/app/job(vers) 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 prcautions, sauvegarde de base et arrt du moteur. Remarque X-Lien ET et Lien OU non supports

13/09/02
vt-admin-guide.doc
55/65
12 Serveur de backup
Visual TOM permet davoir un niveau de scurit supplmentaire grce au module Back-up Serveur. La mise en place dun serveur de back up Visual TOM permet davoir une sauvegarde en temps rel du rfrentiel (base) grce la synchronisation des base entre le serveur primaire et le serveur de back up. Deux variables denvironnement doivent tre positionnes lors de la mise en place de la solution du serveur de back up : La variable denvironnement TOM_BACKUP_SERVER (nom du serveur de back up) sur le serveur primaire La variable denvironnement TOM_PRIMARY_SERVER (nom du serveur primaire) sur le serveur de back up En cas d'absence de ces deux variables, le fonctionnement de Visual TOM est celui d'un serveur standard.
12.1 Synchronisation des bases

Aprs le dmarrage du serveur primaire, une synchronisation des bases de donnes doit tre effectue avant le dmarrage des moteurs et le dmarrage du serveur de back up. Cette synchronisation des bases de donnes est automatique sous Unix la condition que les commandes rcp et rlogin soient actives. La fin de la synchronisation des bases est signale sous Unix. Sous NT, la synchronisation des bases se fait manuellement en copiant le contenu du rpertoire base du serveur primaire dans le rpertoire base du serveur de back up . En cours de production, le serveur primaire ddouble ses requtes de mise a jour de la base : chaque mise a jour de la base de donnes du serveur primaire, une requte de mise a jour est envoye sur le serveur de back up. Ce mcanisme permet d'obtenir en temps rel la rplication de la base du serveur primaire sur le serveur de back up.
12.2 Mcanisme de basculement automatique

Le mcanisme de basculement est pilot par le serveur de back up. Deux cas de basculement : Premier cas : le serveur primaire ne rpond pas la requte de test dactivit envoye par le serveur de back up Deuxime cas : un client narrive pas envoyer une commande au serveur primaire
Le serveur primaire ne rpond pas la requte de test dactivit envoye par le serveur de back up
Rgulirement le serveur de back up envoi une requte de test dactivit vers le serveur primaire. Dans le cas o le serveur primaire ne rpond pas une requte du serveur de

13/09/02
back up, le serveur de back up envoi chaque client une requte leur demandant de tester la prsence du serveur primaire. Si, au moins un client, russit dans ce test de prsence du serveur primaire, le basculement ne seffectue pas. Sinon, la procdure de basculement est dclenche.
Un client narrive pas envoyer une commande au serveur primaire

Dans ce cas, le client renvoi sa commande vers le serveur de back up. Ds la rception de cette commande, le serveur de back up envoi une requte de test dactivit vers le serveur primaire. Si le serveur primaire rpond au serveur de back up, alors celui-ci renvoi une requte demandant au serveur primaire de vrifier sa connexion avec chacun des clients. Si aucun des clients ne rpond au serveur primaire, la procdure de basculement est dclenche. Sinon le basculement ne seffectue pas. Si le serveur primaire ne rpond pas au serveur de back up, on se retrouve dans le deuxime cas : voir ci-dessus.
12.3 Procdure de basculement

Le serveur de back up devient actif et les moteurs qui taient actifs sur le serveur primaire dmarrent sur le serveur de back up (attention, selon la configuration de votre machine, le dmarrage des moteurs sur le serveur de back up peut prendre quelques minutes). Si le serveur de back up reoit une demande de mise a jour de la part du serveur primaire aprs son basculement, il refuse alors la mise a jour et envoie une requte au serveur principal lui demandant de s'arrter.
12.4 Retour au mode normal

Arrt des processus sur le serveur de back up (moteurs, interfaces graphiques et clients). Arrt des processus sur le serveur primaire (moteurs, interfaces graphiques et clients). Copie manuelle de la base du serveur de back up sur le serveur primaire. Relance du serveur primaire. Destruction des fichiers traces sur les clients avec la commande tdelbackup. Dmarrage des processus des serveurs

13/09/02
vt-admin-guide.doc
57/65
13 Configuration des modules I-Superviser et Webdoc

Les modules I-Superviser et webdoc utilisent une passerelle applicative appele I-Server afin de communiquer avec les domaines dexploitation de Visual TOM.
13.1 Configuration de la passerelle I-Server

Le fonctionnement de la passerelle i-server est assur par un excutable isever et deux fichiers de configuration iserver.ini et security.ini. La localisation du processus iserver est dfinie lors de la phase dinstallation (cf guide dinstallation vt-ins-guide). La localisation du fichier de configuration iserver.ini est indique par la variable denvironnement ISERVER_INI (elle est de type systme sous Windows). La localisation du fichier security.inii est indique par le paramtre file de la section [security] du fichier iserver.ini.
13.1.1 Fonctionnement de la passerelle I-server

Le processus i-server fonctionne en mode : Serveur avec les modules i-superviser et weddoc; cest dire que lorsque ce processus est dmarr, il se met en tat dcoute sur le port de communication TCP listenPort. La valeur du port listenPort est renseigne dans le fichier de configuration iserver.ini Client avec le module serveur de Visual TOM ;cest dire que lorsque ce processus est actif, il utilise ladresse IP de la machine du serveur Visual TOM et les numros de port des processus du module serveur pour adresser une requte vers le serveur Visual TOM. Les valeurs des paramtres qui permettent de communiquer avec un serveur Visual TOM sont renseignes dans la section [domain] du fichier de configuration iserver.ini
La passerelle dispose d'un systme d'authentification par un change de clefs indpendant de celui de Visual TOM. Ce systme dauthentification utilise le fichier security.ini
13.1.2 Dmarrage et arrt de la passerelle I-Server Sous Unix :

L activation de la passerelle I-server seffectue en tapant la commande suivante : nohup iserver & Larrt de la passerelle I-server seffectue en arrtant le processus i-server par la commande kill.
Sous Windows :
Le processus iserver fonctionne sous le service Windows Absyss iServer. La commande dinstallation du processus iserver en tant que service Windows est la suivante : IServer install La commande de dsinstallation du processus iserver en tans que service Windows est la suivante : IServer remove

13/09/02
Le dmarrage et larrtET1 p.637erelle I-server sefect en ut fonction Windows : Dmarrer ->p.6r6mtres -> panneau.61 configur6tion ->7ervices
13.1.3 Fichier 61 configuration iserver.ini

Le nom complet du.chemin.(chemin absolu) est pointp.6r1 pvariable denvironnement Ie cont 61 c1 fichier estsuivant: [i7erver] name = nom 61 la machine dinstallation du I-server loc6tion = nom de la socit contact = adresse E-mail du responsable technique listentPort = numro 61 port dcoute 6u service Iserver [domain] host = nom ou adresse IP 6u domaine dexploitation 61 Visual TOM dserverPort = numro 61 port du dserver gserverPort = numro 61 port du gserver pserverPort = numro 61 port du pserver [7ecurity] file
= nom complet du fichier security.ini.(\curity.ini)
[extras] ping BaseUrl
nom complet 6u script permettant 61 tester la prsence dun1 machine (unix seulement) Url 61 base 61 la documentation et 6es consignes.La 6ocumentation et les consignes 6oivent s1 trouver 6ans l1 rpertoire aseUrl/NomDomaine/
[options] FamilylnLists 1 LastExeclnLists 0
1 pour qu1 la famill1 soit passe 6ans les listes, 0 sinon 0 pour qu1 la date 61 la dernire excution soit passe 6ans les listes, 0 sinon
13.1.4 Fichier securty.ini

Ce fichier peut tre install 6ans un rpertoire scuris. Ce fichier contient la liste 61s utilisateurs pouvant avoir accs aux fonctionnalits 61 la passerell1 I-server : [USER1] name password alias enabl1 [USER2] ..
= nom 61 lutilisateur = mot 61 passe = alias Visual TOM = 1 actif, 0 inactif (cet utilisateur est actif par dfaut)

13/09/02
vt-admin-guide.doc
59/65
13.2 Configuration du I-Superviser

Le module I-Superviser est crit en langage Java et sexcute sous lenvironnement JRE 1.3 (voir java.sun.com). Le fonctionnement de ce module est assur par les lments suivants : isuperviser.jar, isuperviser..ini et isuperviser.exe. La localisation de ces fichiers est lors de la phase dinstallation (cf Guide dinstallation vt-ins-guide). Le module I-superviser dialogue en mode client avec la passerelle iserver. Pour cela, Il utilise les paramtres host, port et user dfinis dans le fichier de configuration isuperviser.ini. Sous Unix, le lancement du module isuperviser seffectue de la manire suivante : java jar isuperviser.jar isuperviser.ini Sous Windows, il suffit de lancer en mode commandes le fichier isuperviser.exe. Le fichier isuperviser.ini contient les paramtres suivants : [iserver] host = nom de la machine o est install le module I-Server port = numro de port dcoute du I-server (listenPort dans le fichier iserver.ini) user = utilisateur par dfaut [interface] fullscreen = 1 si plein cran ou 0 taille normale (la valeur par dfaut est 0) [options] sortByLastExec
1 pour le tri par dernire excution, 0 sinon. La valeur par dfaut est 0
13.3 Configuration du webdoc

Le module WebDoc est un cgi, il faut donc, au pralable installer un serveur http et configurer ce serveur http pour quil fonctionne avec le cgi webdoc. Le module webdoc possde une fichier de configuration webdoc.ini point par la variable denvironnement WEBDOC_INI. Le fichier webdoc.ini possde la structure suivante : [Iserver] host = nom de la machine o est install le module I-Server port = numro de port dcoute du I-server (listenPort dans le fichier iserver.ini) [Parameters] templatePath= Rpertoire des fichiers template ; par dfaut .\\Template\\ language =langue utilise : Fr_FR ou En_US wwwBase=base de ladresse web du webdoc, exemple : http://localhost/webdoc cgiBase=base de ladresse web du cgi, exemple : http://localhost/cgi-bin/webdoc pageSize=nombre dlments affichs dans les requtes de type liste
Exemple de configuration du serveur http Apache :

Il faut tout dabord indiquer ladresse dans le domaine ou juste le nom du serveur Apache dans le fichier index.html situ dans le sous-rpertoire www du rpertoire dinstallation du

13/09/02
module webdoc. Pour cela, il faut mettre jour des lignes suivantes : <base href= http:///> <a href=http:///cgi-bin/webdoc...
Puis il faut dclarer le cgi webdoc dans le fichier de configuration du serveur Apache # Section Apache VTOM Alias /WebDoc/ "C:/vtom/WebDoc/www/" Alias /img/ "C:/vtom/WebDoc/www/img/" Alias /css/ "C:/vtom/WebDoc/www/css/" # Droits du rpertoire www de WebDoc <Directory "C:/vtom/WebDoc/www"> Options Indexes FollowSymLinks MultiViews AllowOverride None Order allow,deny Allow from all </Directory> # Droits du rpertoire images du WebDoc <Directory "C:/vtom/WebDoc/www/img"> Options Indexes FollowSymLinks MultiViews AllowOverride None Order allow,deny Allow from all </Directory> # Droits du rpertoire feuilles de styles du WebDoc <Directory "C:/vtom/WebDoc/www/css"> Options Indexes FollowSymLinks MultiViews AllowOverride None Order allow,deny Allow from all </Directory>
et ajouter ScriptAlias /cgi-bin/ "C:/vtom/WebDoc/cgi-bin/" Pour lancer le module webdoc, il faut ouvrir un navigateur Web puis ouvrir l'URL du serveur ou est install le WebDoc (ex: http://localhost/), et cliquer sur "Lancer l'outil de documentation".

13/09/02
vt-admin-guide.doc
61/65
14 Guide de lutilisateur du support standard

14.1 ASSISTANCE TELEPHONIQUE
14.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
14.1.2 Avant dappeler le support

Sources dinformations consulter. Une abondante documentation technique est mise votre disposition : - Guides dutilisation et dinstallation en format word et HTML . - Releases notes en word. - FAQS en word et HTML. Cette documentation est disponible sur : - chaque CD dinstallation du produit Visual Tom . - le site internet pour les FAQS sur www.absyss.com en cliquant sur support, lutilisateur = nom de votre socit et le password = abs ! suivi des 3 premires lettres de votre socit .
14.1.3 Informations fournir pour toute demande dassistance technique

-Votre nom. -Votre adresse -Votre numro de tlphone -Votre numro de fax, le cas chant -Votre mail -Votre N dappel hotline si celui-ci est dj ouvert -La machine et le systme dexploitation (OS) -La version actuelle de Visual Tom -Une description prcise de lincident Peut tre demand par le support : - Envoi de fichiers (fichiers traces, dumps, test cases : un test case est un ensemble programmes-jeu de donnes, permettant de reproduire lincident de faon systmatique ). - Connexion sur le site client via le modem pour une tl-maintenance.
14.1.4 Dans quels cas appeler le support

Une assistance technique peut tre sollicite dans les cas suivants : - Questions sur linstallation - Identification, rsolution ou contournement derreurs logicielles (bogues) - Demande damlioration de produit .

13/09/02
Toute question ou tout problme soumis au support donne lieu la cration dune Demande dAssistance Technique ( DAT ). Chaque DAT permet ainsi didentifier un problme unique et de le suivre jusqu sa rsolution : un N dappel (de rfrence) est communiqu la cration de la demande dassistance Ce numro est rappeler lors de toute communication avec le support. Fermeture dune DAT : Un appel est considr comme clos lorsquune rponse, une solution ou un contournement mutuellement acceptable a t fourni . Un appel ferm peut tre rouvert si ncessaire condition que le problme soit le mme. Il peut tre convenu de fermer un appel aprs un certain dlai, si aucune nouvelle na t donne.
Suivi du DAT : Une synthse mensuelle de tous vos appels ouverts est envoye par courrier lectronique.
14.1.5 Conditions daccs au support

Tout client ayant un contrat de maintenance peut demander une assistance technique auprs du support . Il est souhaitable que les personnes qui appellent le support connaissent le produit et leur environnement oprationnel.
14.2 MAINTENANCE DES SYSTEMES VISUAL TOM

14.2.1 Sauvegarde et restauration
Tout client doit imprativement mettre en place des procdures de sauvegarde et de restauration afin dviter la perte de donnes. Nous vous conseillons de faire rgulirement vos sauvegardes et de pratiquer des simulations de restauration afin de vous assurer des rsultats. En supplment 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 llaboration dune stratgie de sauvegarde adquate . Ces services font lobjet dune tarification. 14.2.2 Environnement de test
Lenvironnement de test constitue un lment essentiel de votre systme, il permet :
de tester toute modification locale propose. daider isoler des anomalies par rapport lenvironnement rel. de fournir un cadre pour llaboration de scnarii des tests reproductibles.
de tester de nouvelles versions. de tester vos stratgies de sauvegardes et de restauration.

Bien quil ne soit videmment pas toujours possible de reproduire ,dans votre environnement de test, les volumes de donnes ou les transactions de votre environnement rel, il nen demeure pas moins quun environnement de test permet de minimiser limpact des changements sur votre environnement rel.
14.2.3 Gestion de vos espaces

Vous devez vous assurer en permanence que les machines client et serveur disposent dun espace suffisant pour le systme de fichiers, notamment pour les rpertoires de trace.
14.2.4 Installation de version

Avant de raliser votre installation, nous vous conseillons : - dobtenir la dernire version - de lire toute la documentation ,nous rappelons quelle est disponible sur le CD et internet. - de vrifier tous les pr-requis logiciels et matriels. - de la valider sur votre environnement de test avant linstallation relle de production.
64/65
vt-admin-guide.doc

13/09/02
HOTLINE 01 40 84 89 01 Hotline@absyss.fr
ABSYSS 15/17, boulevard du Gnral 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

13/09/02
vt-admin-guide.doc
65/65

VT Admin Guide

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

VT Admin Guide

Transféré par

Droits d'auteur :

Formats disponibles

Net job scheduler

Visual TOM Guide dadministration

The job scheduling company

Visual TOM-Guide d administration

Copyright ABSYSS. All rights reserved

Copyright ABSYSS. All rights reserved

Visual TOM-Guide d administration

Copyright ABSYSS. All rights reserved

Visual TOM Guide dadministration

2 Prsentation de Visual TOM

Visual TOM-Guide d administration

3 Architecture de Visual TOM

3.1 Visual TOM Serveurs (Rfrentiel, Ordonnanceur).

3.2 Visual TOM XVision (VT-XVI = Conception, Pilotage)

Copyright ABSYSS. All rights reserved

Visual TOM Guide dadministration

3.4 Visual TOM Modules optionnels

Copyright ABSYSS. All rights reserved

Visual TOM-Guide d administration

3.5 Exemples darchitecture

Architecture Centralise Mono-site Multi-systmes

VT Client Mainframe Synchronisation inter-systmes. Gestion des environnements de test et de production.

Copyright ABSYSS. All rights reserved

Visual TOM Guide dadministration

3.5.2 Architecture rpartie ou districbue

Departmental Serveur Net client

Copyright ABSYSS. All rights reserved

Visual TOM-Guide d administration

4 Principes de fonctionnement des processus de Visual TOM

4.1 Processus du module serveur

Les processus de gestion de la production

4.1.1.1 Le processus de gestion de la base de donnes :dserver

Copyright ABSYSS. All rights reserved

Visual TOM Guide dadministration

4.1.1.3 Le processus de gestion des mises jour des IHM : gserver

4.1.2 Les processus dordonnancement

Visual TOM-Guide d administration

4.2 Processus du module client

4.3 Processus du module Interface graphique

Copyright ABSYSS. All rights reserved

Visual TOM Guide dadministration

4.4 Architecture technique

dserver gserver pserver dserver gserver pserver

Gestion des vnements

bdaemon Soumission des batchs

Copyright ABSYSS. All rights reserved

Visual TOM-Guide d administration

5 Administration des processus de Visual TOM

5.1.1 Appel du menu : admins

Option 1 - Etat de Visual TOM

Options 2 et 3 - Dmarrage et arrt des serveurs Visual TOM

Copyright ABSYSS. All rights reserved

Visual TOM Guide dadministration

Option 4 - Gestion des moteurs Visual TOM

Option 5 - Gestion du client

Option 6 - Visual TOM

Option 7 - Sauvegarde de la base de donnes

5.1.2 Appel du menu : adminc

Option 1 - Etat du client Visual TOM

Options 2 et 3 - Dmarrage et arrt du Client Visual TOM

Visual TOM-Guide d administration

Les lancements et arrts du client sont tracs dans le fichier $TOM_TRACES/client.

5.1.2.1 Dmarrag es proceseboot