Net job scheduler
Visual TOM Formation Administrateurs
The job scheduling company
Visual TOM-Support de formation administrateurs
SOMMAIRE
1 PRÉS PRÉSENTA ENTATION TION........................... ..................................................... ..................................................... ...................................................... .................................. ............. ............ ..........4 1.1 VISUAL TOM SERVEURS (RÉFÉRENTIEL , ORDONNANCEUR). )............................................................................... ..............................................................................4 1.2 VISUAL TOM XVISION VT-XVI (CONCEPTION, PILOTAGE)........ ............... .............. .............. .............. .............. .............. .............. .............. .............. .............. .........4 1.3 VISUAL TOM CLIENTS (EXÉCUTION DES TÂCHES SUR UNE MACHINE)....... ............. ........... ........... ............ ............ ........... ........... ........... ........... ........... ......... .... 5 1.4 VISUAL TOM MODULES OPTIONNELS................................................................................. ............................................................................................................ ...........................5 2 ARCHI ARCHITECT TECTURE URE TECHNIQU TECHNIQUE E......................... .................................................... ...................................................... ................................. ............. ............. ............ ..........6 3 INSTA INSTALLAT LLATION ION DES MODULES DE BASE......................... .................................................... ...................................................... ................................. ..........8 3.1 INSTALLATION SOUS UNIX.......................................... ............................................................................................. .................................................................................. ...............................8 3.1.1 Préparatifs Préparatifs....................... .................................................. ...................................................... ...................................................... .................................... ................ ............. .......... .... 8 3.1.2 Transfert du package logiciel........................ logiciel ................................................... ................................................... .............................. ............. ............. ............ ........ ..8 3.1.3 Le fichier de configuration de l'installation : install_vtom.ini.......................... install_vtom.ini .................................... ................. ............. ............ ........ ..9 3.1.4 Déroulement de la procédure d’installation..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... 9 3.1.5 Validation Validation de l’installation.......................... ..................................................... ...................................................... ............................................ ....................... ......... ... 10 3.2 INSTALLATION SOUS WINDOWS NT.............................................................................................................13 13 3.2.1 Désin Désinstalla stallation tion......................... .................................................... ...................................................... ............................................. ........................ ............ ............ ............ .......13 . 3.2.2 Conventio Conventions ns........................... ...................................................... ...................................................... ...................................................... ........................................ .................. .....13 3.2.3 Paramètres Paramètres de l’insta l’installation llation........................ ................................................... ..................................................... .................................... ................. ............. ......... ... 13 3.2.4 Déroulement de la procédure d’installation..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ........ ....... 15 3.2.5 Validation Validation de l’installation.......................... ..................................................... ...................................................... ............................................ ....................... ......... ... 15 4 CONFIGURATION DU SERVEUR VISUAL TOM..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... .....17 4.1 LES PORTS DE COMMUNICATION DU SERVEUR VISUAL TOM........ ............... .............. ............... ............... .............. .............. ............. .............. ............... ............. ...... 17 ADMINISTRATEUR DE VISUAL TOM POUR UN SERVEUR UNIX.............. 4.2 LES VARIABLES D’ENVIRONNEMENT DE L’ ADMINISTRATEUR .................... ........... ..... 17 4.3 LES VARIABLES D’ENVIRONNEMENT POUR UN SERVEUR WINDOWS......................................................................18 18 4.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................18 4.5 P ARAMÉTRAGE DE LA PROCÉDURE DE COMMUNICATION DES MOTEURS ...................................... ............... ..19 MOTEURS AVEC AVEC LES CLIENTS.......................... 4.6 L A MISE EN PLACE DES TRACES DES MOTEURS...............................................................................................20 20 4.7 PRODUCTION DE TABLEAUX DE BORDS DES JOURNÉES D’EXPLOITATION PRÉCÉDENTES............................................. .............................................21 21 4.8 L’HISTORIQUE......................................................................................................................................... 21 5 LES COMMANDES D’UN MODULE SERVEUR..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... ...... ...... .....22 5.1 S AUVEGARDE ET RESTAURATION D’UNE BASE.................................................................................................22 5.1.1 Sauvegarde Sauvegarde du du répertoire répertoire de la base base de données..... .......... .......... .......... .......... .......... .......... .......... .......... .......... ........ ....... ....... ...... ...... ...... ... 22 5.1.2 Liste le contenu contenu de la base dans dans un fichier texte........................ ................................................. ............................... ............ ............ .......... ....22 22 5.1.3 Import Import des des objets définis dans un fichier texte..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... ...... ...... ....... 22 5.2 L A GESTION DES MOTEURS........................................................................................................................23 5.2.1 Démarrage d’un moteur sur un Environnement......................... Environnement.................................................... ..................................... ................ ........... ..... 23 5.2.2 Arrêt d’un moteur sur un Environnement Environnement........................ .................................................. ............................................... ........................... ............ ...... 23 5.2.3 Remise à OFF du flag moteur de l’interface l ’interface graphique pour un environnement.................. environnement ........................ ........23 5.2.4 Test de présence d’un moteur actif pour un environnement........ environnement ................ ................ ...................................... ..............................23 23 5.2.5 Vérification Vérification des blocages de date......................... .................................................... ...................................................... ........................................ ............... ..23 23 6 CONF CONFIGURAT IGURATION ION DU CLIEN CLIENT T VISUAL TOM........................ ................................................... ............................................... .......................... ........... ..... 24 6.1 LES PORTS DE COMMUNICATION UTILISÉS PAR UN CLIENT..................................................................................24 24 ADMINISTRATEUR DU CLIENT VISUAL TOM SOUS UNIX................................. 6.2 LES VARIABLES D’ENVIRONNEMENT DE L’ ADMINISTRATEUR .................................24 24 6.3 LES VARIABLES D’ENVIRONNEMENT WINDOWS D’UN CLIENT VISUAL TOM...... ........... ........... ........... .......... .......... ........... ........... .......... .......... .......... .........25 6.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................25 6.5 LES QUEUE BATCH...................................................................................................................................26 2/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM-Support de formation administrateurs
SOMMAIRE
1 PRÉS PRÉSENTA ENTATION TION........................... ..................................................... ..................................................... ...................................................... .................................. ............. ............ ..........4 1.1 VISUAL TOM SERVEURS (RÉFÉRENTIEL , ORDONNANCEUR). )............................................................................... ..............................................................................4 1.2 VISUAL TOM XVISION VT-XVI (CONCEPTION, PILOTAGE)........ ............... .............. .............. .............. .............. .............. .............. .............. .............. .............. .........4 1.3 VISUAL TOM CLIENTS (EXÉCUTION DES TÂCHES SUR UNE MACHINE)....... ............. ........... ........... ............ ............ ........... ........... ........... ........... ........... ......... .... 5 1.4 VISUAL TOM MODULES OPTIONNELS................................................................................. ............................................................................................................ ...........................5 2 ARCHI ARCHITECT TECTURE URE TECHNIQU TECHNIQUE E......................... .................................................... ...................................................... ................................. ............. ............. ............ ..........6 3 INSTA INSTALLAT LLATION ION DES MODULES DE BASE......................... .................................................... ...................................................... ................................. ..........8 3.1 INSTALLATION SOUS UNIX.......................................... ............................................................................................. .................................................................................. ...............................8 3.1.1 Préparatifs Préparatifs....................... .................................................. ...................................................... ...................................................... .................................... ................ ............. .......... .... 8 3.1.2 Transfert du package logiciel........................ logiciel ................................................... ................................................... .............................. ............. ............. ............ ........ ..8 3.1.3 Le fichier de configuration de l'installation : install_vtom.ini.......................... install_vtom.ini .................................... ................. ............. ............ ........ ..9 3.1.4 Déroulement de la procédure d’installation..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... 9 3.1.5 Validation Validation de l’installation.......................... ..................................................... ...................................................... ............................................ ....................... ......... ... 10 3.2 INSTALLATION SOUS WINDOWS NT.............................................................................................................13 13 3.2.1 Désin Désinstalla stallation tion......................... .................................................... ...................................................... ............................................. ........................ ............ ............ ............ .......13 . 3.2.2 Conventio Conventions ns........................... ...................................................... ...................................................... ...................................................... ........................................ .................. .....13 3.2.3 Paramètres Paramètres de l’insta l’installation llation........................ ................................................... ..................................................... .................................... ................. ............. ......... ... 13 3.2.4 Déroulement de la procédure d’installation..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ........ ....... 15 3.2.5 Validation Validation de l’installation.......................... ..................................................... ...................................................... ............................................ ....................... ......... ... 15 4 CONFIGURATION DU SERVEUR VISUAL TOM..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... .....17 4.1 LES PORTS DE COMMUNICATION DU SERVEUR VISUAL TOM........ ............... .............. ............... ............... .............. .............. ............. .............. ............... ............. ...... 17 ADMINISTRATEUR DE VISUAL TOM POUR UN SERVEUR UNIX.............. 4.2 LES VARIABLES D’ENVIRONNEMENT DE L’ ADMINISTRATEUR .................... ........... ..... 17 4.3 LES VARIABLES D’ENVIRONNEMENT POUR UN SERVEUR WINDOWS......................................................................18 18 4.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................18 4.5 P ARAMÉTRAGE DE LA PROCÉDURE DE COMMUNICATION DES MOTEURS ...................................... ............... ..19 MOTEURS AVEC AVEC LES CLIENTS.......................... 4.6 L A MISE EN PLACE DES TRACES DES MOTEURS...............................................................................................20 20 4.7 PRODUCTION DE TABLEAUX DE BORDS DES JOURNÉES D’EXPLOITATION PRÉCÉDENTES............................................. .............................................21 21 4.8 L’HISTORIQUE......................................................................................................................................... 21 5 LES COMMANDES D’UN MODULE SERVEUR..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... ...... ...... .....22 5.1 S AUVEGARDE ET RESTAURATION D’UNE BASE.................................................................................................22 5.1.1 Sauvegarde Sauvegarde du du répertoire répertoire de la base base de données..... .......... .......... .......... .......... .......... .......... .......... .......... .......... ........ ....... ....... ...... ...... ...... ... 22 5.1.2 Liste le contenu contenu de la base dans dans un fichier texte........................ ................................................. ............................... ............ ............ .......... ....22 22 5.1.3 Import Import des des objets définis dans un fichier texte..... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... ...... ...... ....... 22 5.2 L A GESTION DES MOTEURS........................................................................................................................23 5.2.1 Démarrage d’un moteur sur un Environnement......................... Environnement.................................................... ..................................... ................ ........... ..... 23 5.2.2 Arrêt d’un moteur sur un Environnement Environnement........................ .................................................. ............................................... ........................... ............ ...... 23 5.2.3 Remise à OFF du flag moteur de l’interface l ’interface graphique pour un environnement.................. environnement ........................ ........23 5.2.4 Test de présence d’un moteur actif pour un environnement........ environnement ................ ................ ...................................... ..............................23 23 5.2.5 Vérification Vérification des blocages de date......................... .................................................... ...................................................... ........................................ ............... ..23 23 6 CONF CONFIGURAT IGURATION ION DU CLIEN CLIENT T VISUAL TOM........................ ................................................... ............................................... .......................... ........... ..... 24 6.1 LES PORTS DE COMMUNICATION UTILISÉS PAR UN CLIENT..................................................................................24 24 ADMINISTRATEUR DU CLIENT VISUAL TOM SOUS UNIX................................. 6.2 LES VARIABLES D’ENVIRONNEMENT DE L’ ADMINISTRATEUR .................................24 24 6.3 LES VARIABLES D’ENVIRONNEMENT WINDOWS D’UN CLIENT VISUAL TOM...... ........... ........... ........... .......... .......... ........... ........... .......... .......... .......... .........25 6.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................25 6.5 LES QUEUE BATCH...................................................................................................................................26 2/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs 6.5.1 Configuratio Configuration n d’une queue batch sous sous un client Unix.......................... ............................................ ........................ ............ ............ ........ ..26 26 6.5.2 Configuration d’une queue queue batch batch sous un un client Windows Windows..... .......... .......... .......... .......... .......... .......... .......... ........ ....... ....... ...... ...... .....27 6.6 LES SUBMITTER ..................................... .................................................................................... ............................................................................................ .................................................. .....27 6.7 GESTION DES LOGS............................................................................................ ................................................................................................................................. ..................................... 28 7 CONF CONFIGURAT IGURATION ION D’UNE D’UNE IHM VISUAL VISUAL TOM TOM......................... .................................................... ...................................... ................. ............ ............ ........30 30 7.1 LES PORTS DE COMMUNICATION UTILISÉS PAR UNE IHM................................................... ................................................................................... ................................30 30 7.2 LES VARIABLES D’ENVIRONNEMENT DE L’ ADMINISTRATEUR 31 ADMINISTRATEUR DE L’IHM SOUS UNIX............................................... .... 31 7.3 LES VARIABLES D’ENVIRONNEMENT SYSTÈME WINDOWS D’UNE IHM....... .............. .............. .............. ............... ................ .............. .............. ............... .......... ... 31 7.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................31 7.5 MISE EN PLACE DES FONCTIONNALITÉS DOCUMENTATION ET CONSIGNES.............................................................. ..............................................................32 32 8 CONCEPTION ET PILOTAGE PILOTAGE DE LA PRODUCTION EN MODE COMMANDE COMMANDE..... .......... .......... .......... ......... ....... ...... .....34 8.1.1 Ajout ou modification modification d’objets dans le domaine d’exploitation..... .......... .......... .......... .......... .......... .......... .......... .......... ......... ....... ...34 34 8.2 AJOUT ET MODIFICATION D’UNE .................................................................................................. ..........................................35 UNE APPLICATION APPLICATION........................................................ 8.3 AJOUT OU MODIFICATION D'UN TRAITEMENT....................................................................................................37 8.4 SUPPRESSION D'UN TRAITEMENT.................................................................................................................39 8.5 SUPPRESSION D’UN LIEN...........................................................................................................................39 9 INSTA INSTALLAT LLATION ION DES MODULES MODULES ISUPERVIS ISUPERVISER ER .............................................. ................... ............................................... .......................... .......... .... 40 9.1 INSTALLATION DE LA PASSERELLE I-SERVER...................................................................................................40 9.2 INSTALLATION DU MODULE I-SUPERVISER......................................................................................................41 10 GUIDE DE L’UTILISATEUR DU SUPPORT STANDARD..... .......... .......... .......... .......... .......... .......... .......... .......... ........ ....... ....... ...... ...... ....... 43 10.1 ASSI ASSISTAN STANCE CE TELE TELEPHON PHONIQUE IQUE..................................................................................................... .....................................................................................................43 10.1.1 Commen Commentt nous contacter contacter......................... .................................................... ..................................................... ..................................... ................. ............ ......... ...43 10.1.2 Avant d’appeler le support....................................................................................................... support .......................................................................................................43 43 10.1.3 Informations à fournir pour toute demande demande d’assistance technique..... .......... .......... .......... .......... .......... .......... .......... ......... 43 10.1.4 Dans quels cas appeler le support....................... support .................................................. ............................................ ....................... ............. ............. .......... .... 43 10.1.5 Conditions d’accès au support......................... support .................................................... ............................................... .......................... ............. ............. ........... ..... 44 10.2 MAINTENANCE MAINTENANCE DES SYSTEMES VISUAL TOM TOM...... ............ ............ ............ ............ ............ ............ ............ ........... ........... ........... ............ ........... .... 44 10.2.1 Sauvega Sauvegarde rde et restauration restauration .......................................... ............... ...................................................... ........................................... ....................... ............. ........ ..44 10.2.2 Environnement de test ........................................................................................................... 44 10.2.3 Gestion Gestion de vos espaces espaces ................................. ........................... ...................................................... ..................................... ................ ........ ..45 10.2.4 Installa Installation tion de version version ....................................... ........................... ............................................ ....................... ............. ............. ............ ...... 45
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
3/46
Visual TOM-Support de formation administrateurs
1 Présentat tation ion Les modules Visual TOM sont classées en quatre familles de modules
1.1 Visual Visual TOM TOM Serveu Serveurs rs (Référe (Référentie ntiel, l, Ordonna Ordonnanceu nceur). r). •
Visual TOM Enterprise Server (VT-SES) Visual TOM Enterprise Server est l’élément de base de toute architecture. Il inclut le référentiel référentiel de production, production, les outils de conception du référentiel, le pilotage de l’exploitation, l’exploitation, le système expert de planification et d’ordonnancement, d’ordonnancement, les APIs et la documentation documentation on-line. Il peut être installé indifféremment indifféremment sur des machines UNIX ou Windows NT.
•
Visual TOM Departmental Server (VT-SDS) Le serveur serveur departemental departemental gère l'autonomie l'autonomie des sites sites distants. distants. Il répartit la charge dans une architecture distribuée. Il nécessite la présence d’un module Enterprise Server. Il peut être installé indifféremment indifféremment sur des machines machines UNIX ou NT.
•
Visual TOM Back Up Server (VT-SBU) Le serveur BACKUP relaye automatiquement automatiquement un serveur Visual TOM en cas d’incident. d’incident. Ce module est systématiquement systématiquement mis en place dans les productions nécessitant nécessitant un niveau de sécurité optimal. Il peut être installé indifféremment indifféremment sur des machines UNIX ou NT.
1.2 Visual Visual TOM TOM XVision XVision VT-XVI VT-XVI (Con (Concept ception, ion, Pilot Pilotage) age) •
Visual TOM IHM C’est une interface graphique groupware déportée sur un LAN ou un Wan, connecté à tout type de serveur Visual TOM (y compris les NetClients) Elle permet la modélisation, la gestion et le pilotage de la production production multi platesformes UNIX et Windows NT/95.
•
Visual TOM I-Superviser C’est un ensemble de fonctionnalités permettant de suivre le déroulement déroulement d'une production gérée gérée par Visual TOM. Cette fonctionnalité a été étudiée pour permettre le suivi de la production via un réseau bas débit (RTC, Internet).
•
Visual TOM WebDoc C’est une Interface internet permettant de visualiser les caractéristiques caractéristiques des objets de vos domaines d’exploitation Visual TOM : (ressources, (ressources, calendriers, calendriers, environnements, applications, applications, traitements ..)
4/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
1.3 Visual TOM Clients (Exécution des tâches sur une machine) •
Visual TOM Client (VT-CS) C’est un client Visual TOM permettant la production informatique en architecture Client/Serveur. Ces modules dépendent d’un Visual TOM serveur; ils reçoivent les ordres de soumission en provenance de ceux-ci et exécutent les traitements batch. (exemple. : Exécution d’une tâche sur une machine). Il peut être installé indifféremment sur des machines UNIX ou NT, VAX/VMS, Open VMS, AS400, GCOS7 et GCOS8.
•
Visual TOM Net Client (VT-CN) C’est un client Visual TOM qui posséde en local son propre référentiel de production, lui garantissant l’autonomie de fonctionnement. Il peut être installé indifféremment sur UNIX ou NT.
1.4 Visual TOM Modules optionnels •
Visual TOM Xframework (VT-XFR) : C’est un module d’intégration possedant une plate-forme de supervision de systèmes et de réseaux et/ ou d’application. Dans le cas d’OpenMaster et de PATROL, les modules sont livrés sous forme d'agents packagés et certifiés offrant ainsi une intégration optimale.
•
Visual TOM Xapplication (VT-XAP) : C’est un module d’intégration entre l’application Visual TOM et les grands progiciels du marché (comme SAP R/3, BAAN, JDE, PEOPLE SOFT, ORACLE APPLICATIONS, …).
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
5/46
Visual TOM-Support de formation administrateurs
2 Architecture technique
A rchitecture technique Ges tion référentiel de prod u
Tcp/ip
Tengine
l e é r s p m e t n e n o i t a c i l p é R
Vtom serveur VT-SDS VT-SES Vtom backup serveur VT-SBU Vtom client VT-CS
vtom
tomDBd gw d ntfy
dserver gserver pserver
Gestion graphique
Gestion des événements tomDBd gw d ntfy
dserver gserver pserver
tomDBd bdaemon
bda e mon Soumission des batchs
tomDBd
Vtom VT-XVISION
Qu e u e sbatchs
gw d
Queueksh
ntfy
Queue SAP
MrTOM
A ffichage S crip batch et log
Visual TOM possède une architecture de type Client/Serveur basée sur le protocole de communication TCP/IP. La communication avec le module serveur Visual TOM s’effectue à l’aide de trois processus.
6/46
Le processus dserver gère la base de données de la production . Ce processus utilise le port de communication TCP tomDBd.
Le processus gserver gère les mises à jour graphiques sur toutes les IHM connectées via le port TCP gwd. 91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
Le processus pserver reçoit, via le port TCP ntfy, les notifications de modifications de la base de données.
Le processus vtlserver gère la procédure de gestion des licences
La communication avec le module client s’effectue à l’aide du processus bdaemon ; ce processus utilise le port TCP bdaemon. Le processus vtom permet de lancer l’interface graphique Le tableau suivant fournit la liste valeurs par défaut des ports TCP utilisés par Visual TOM.
tomdbd gwd ntfy bdaemon vtlicense
20001/tcp 20002/tcp 20003/tcp 20004/tcp 20006/tcp
NB : ces numéros de ports ne sont que des propositions. Il est possible de prendre n’importe quel numéro de port non utilisé, mais pour la communication entre les différentes machines, il est impératif que ces ports soient définis de la même manière sur chacune des machines .
Si les services de votre système Unix sont administrés par un serveur NIS, il sera nécessaire de les mettre à jour sur la machine serveur NIS s'ils ne sont pas présents.
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
7/46
Visual TOM-Support de formation administrateurs
3 Installation des modules de base Les modules de base de Visual TOM sont : le module Serveur le module Client le module IHM
3.1 Installation sous Unix 3.1.1 Préparatifs Pour installer Visual TOM, il est nécessaire d’avoir un compte utilisateur qui sera administrateur de Visual TOM. Par défaut on utilise le compte vtom, mais il est possible de prendre n’importe quel autre utilisateur du système d’exploitation. Visual TOM est fourni avec des procédures d’administration en c-shell, tc-shell, bourne shell ou korn shell, ainsi l’utilisateur qui administrera Visual TOM pourra fonctionner indifféremment avec l'un de ces quatre shells. Attention, pour l’installation de Visual TOM sur plusieurs machines (ex : 1 machine serveur et deux clients distants), si l’utilisateur d’administration est le même , il doit avoir le même uid et gid sur toutes les machines. Le mot de passe de root sera également nécessaire pour installer Visual TOM.
3.1.2 Transfert du package logiciel A partir du CDROM, sélectionnez le répertoire correspondant à votre système d’exploitation : AIX ou HPUX ou SOLARIS, … Puis, sélectionnez le package que vous allez installer. Le tableau suivant vous donne la correspondance entre la solution Visual TOM à mettre en œuvre et le package à installer.
Solution Visual TOM Enterprise server Departemental Server Back-up server Client Client Light Net Client Net Client Light Xvision
Package
Pack Serveur
Pack IHM Pack Client
VT-SES VT-SDS VT-SBU VT-CS VT-CSL VT-CN VT-CNL VT-XVI
Copiez du CD-ROM vers le répertoire temporaire d’installation les fichiers nécessaires pour l’installation. Ces fichiers sont : install_vtom script d'installation install_vtom.ini fichier de configuration de l’installation
module pour l'installation Pour la copie des fichiers nécessaires à l’installation, il est recommandé d’utiliser un système Windows, disposant d’un lecteur CD-ROM, et de transférer les fichiers par FTP. Les modes de transfert des fichiers sont les suivants : 8/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
bin pour le fichier ascii pour les fichiers install_vtom et install_vtom.ini A partir de la version 4 de Visual TOM, il faut mettre en place le fichier de licences license.lic, dans le cas d’une installation d’un module serveur. Ce fichier vous est fourni par le service support d’Absyss et doit être copié dans le sous-répertoire bin du répertoire d’installation du module Serveur de Visual TOM (cf paragraphe répertoires d’installation /vtom/bin).
3.1.3 Le fichier de configuration de l'installation : install_vtom.ini Pour définir les paramètres de votre installation de Visual TOM, vous pouvez lancer directement le script d'installation. Il est cependant possible de paramétrer le fichier de configuration install_vtom.ini, qui contient les paramètres par défaut (ex: installation de plusieurs clients Visual TOM avec les mêmes paramètres).
3.1.4 Déroulement de la procédure d’installation 3.1.4.1 Lancement du script d’installation
Dans le répertoire d’installation temporaire où vous avez extrait les fichiers, sous l'utilisateur root, vérifiez que le fichier install_vtom est en mode exécutable, puis tapez la commande suivante : > ./install_vtom [ liste des modules à installer ] Exemples : installation de Visual TOM Enterprise Server et Visual TOM Client, version 4.2 HP-UX : ./install_vtom VT-SES-HPUX.42.Z VT-CS-HPUX.42.Z
Une fois l’installation terminée il faut copier le fichier license.lic dans le sous répertoire bin du répertoire d’installation du pack serveur (../vtom/bin).
3.1.4.2 Confirmation des paramètres d’installation
Après initialisation (lecture du fichier install_vtom.ini), les paramètres de l'installation vous sont proposés. -
-
Type d'installation : client, serveur, IHM (seuls les packs à installer sont affichés) Solution serveur de backup : si vous disposez de cette solution, ses paramètres sont affichés Administrateur Visual TOM Répertoire de base de l'installation : sous lequel seront installées les répertoires admin, abm (pack client), vtom (pack serveur) et visual (pack IHM). Autres répertoires utilisés par Visual TOM (il est possible de les définir indépendamment du répertoire d'installation). Navigateur HTML si défini.
Si les paramètres de l'installation vous satisfont, validez, sinon tapez n puis Entrée. 3.1.4.3 Redéfinition des paramètres d’installation
Pour chacun des choix qui vous seront proposés, validez pour accepter le choix. Entrez la nouvelle valeur suivie d'Entrée pour le redéfinir. -
Pack d'installation Solution serveur de backup : nom du serveur primaire ou de backup Répertoire de base de l'installation Administrateur de Visual TOM
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
9/46
Visual TOM-Support de formation administrateurs
-
Navigateur HTML Répertoire de la base de données Répertoire de backup de la base de données Répertoire des fichiers statistiques Répertoire des traces du moteur Répertoire des fichiers logs
3.1.4.4 Sauvegarde d'une installation précédente
Dans le cas où vous installez Visual TOM sur une installation existante, la base de données est toujours conservée, les anciens répertoires admin et abm/config sont renommés en admin.old et abm/config.old , ce qui vous permet de conserver le paramétrage de la précédente installation. De plus, si vous avez choisi de sauvegarder l'installation précédente, tous les autres répertoires seront conservés (renommés en .old). 3.1.4.5 Génération des fichiers de configuration :
vtom_init.[shell] Il existe quatre fichiers d’initialisation vtom_init pour les shells sh, ksh, csh et tcsh. Ces fichiers sont générés lors de l’installation et contiennent les définitions des différentes variables d’environnement utiles à Visual TOM. .vtom.ini Le fichier .vtom.ini contient des paramètres de Visual TOM. Il est installé dans le répertoire d’administration. Un lien est fait sur le home directory de l’administrateur Visual TOM. .cshrc (ou .login) et .profile de l'administrateur de Visual TOM On ajoute un appel au script vtom_init.[$SHELL]. fichiers boot_start_client et boot_start_server Ces fichiers, intégrés à la procédure de boot système, permettent de lancer Visual TOM client ou serveur lors du démarrage de la machine. fichier services.new Ce fichier contient les noms et numéros de services TCP utilisés par Visual TOM. Le contenu de ce fichier doit être inséré dans le fichier /etc/services. 3.1.4.6 Répertoires temporaires et script de désinstallation
Lors de l'installation, tous les fichiers et répertoires sont supprimés (cas d'une réinstallation) et sont temporairement transférés dans le répertoire install_vtom.tmp. De plus, un script de désinstallation est généré : uninstall_vtom. Ce script permet de revenir à la situation de départ (avant l'installation) en cas de problème lors du déroulement de l'installation. Ce répertoire temporaire et le script de désinstallation sont normalement supprimés à la fin de l'installation. Vous pouvez cependant les conserver en interrompant le script d'installation lorsqu’ un message est affiché (10 secondes vous sont alloués pour cette opération). 3.1.4.7 Journal d'installation
Vous trouverez la trace de cette installation de Visual TOM dans le fichier install_vtom.log.
3.1.5 Validation de l’installation Attention : Si on utilise exceed pour lancer xvision x11, dans la configuration exceed, au niveau de la définition de l'écran, le paramètre "use native WM for embedded client" doit être décoché.si ce paramètre est coché "à tort", cela peut provoquer des plantages sur xvision. 10/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
3.1.5.1 Accès à Visual TOM
Connexion sous l’utilisateur d’administration Visual TOM Connectez vous sous l’utilisateur d’administration Visual TOM défini lors de l’installation afin de disposer des variables d’environnement Visual TOM.
Appel du menu admins Lancez le menu d’administration Visual TOM par la commande admins : > admins ↵
Démarrage des serveurs Dans le menu admins, choisissez l’option 2 - Démarrage des serveurs.
Lancement de l’interface graphique Dans le menu admins, choisissez l’option Visual TOM. La fenêtre de login à Visual TOM apparaît.
Connexion à Visual TOM Un utilisateur Visual TOM est défini par défaut : Utilisateur TOM Mot de passe TOM Domaine = 3.1.5.2 Mise à jour de la base de données de test
Une base de données par défaut est générée lors de l’installation. Il est nécessaire de la modifier pour tenir compte des paramètres tels que le nom de la machine ou celui de l’utilisateur d’administration vtom.
Utilisateur Avec le menu Domaine Exploitation / Utilisateurs , appelez la fenêtre de définition des utilisateurs. Cliquez sur Nouveau et saisissez le nom de votre administrateur Visual TOM.
Machine Avec le menu Domaine Exploitation / Machines , appelez la fenêtre de définition des machines. Sélectionnez default_machine , cliquez sur Modifier , et remplacez ce nom par celui de votre serveur Visual TOM.
Date Avec le menu Domaine Exploitation / Dates , appelez la fenêtre de définition des Dates d'exploitation. Sélectionnez date_exp et cliquez sur Modifier . La fenêtre de définition de la date apparaît. Cliquez sur système puis sur automatique pour la mettre à jour.
Répertoires des scripts et des traces moteur Avec le menu Domaine Exploitation / Environnements, appelez la fenêtre de définition des environnements. Sélectionnez l’environnement exploitation et Cliquez sur Modifier . La fenêtre de définition de l’environnement apparaît. Modifiez les champs Répertoire des Scripts et Répertoire des traces moteur en remplaçant {Rep_local}/Visual_TOM par le répertoire d’installation.
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
11/46
Visual TOM-Support de formation administrateurs
3.1.5.3 Validation du bon fonctionnement de la partie serveur de Visual TOM
Ce paragraphe explique comment faire fonctionner la base de données de test en mode simulation. L’exécution des scripts en mode simulation permet de valider le bon fonctionnement de la partie serveur (planification et ordonnancement) de Visual TOM.
Appel du pilote graphique Sélectionnez la fonction Pilote Graphique du menu Pilote. La fenêtre du pilote graphique de l’environnement exploitation apparaît. Vous êtes dans le graphe des applications. Pour visualiser les traitements, cliquez deux fois sur l’application. Les jobs sont tous A VENIR (couleur jaune).
Lancement du moteur (tengine) Démarrez le tengine en cliquant sur l’icône OFF, confirmez en validant. Les trois jobs doivent exécuter successivement, c’est à dire passer de l’état A VENIR (jaune) à l’état EN COURS (bleu) puis à l’état TERMINE (vert). 3.1.5.4 Validation du bon fonctionnement du client
Ce paragraphe nous explique comment exécuter les traitements et consulter leur fichier log.
Modification du mode d’exécution des traitements Sélectionnez la fenêtre du graphe des applications (si vous êtes dans le graphe des traitements cliquez sur la flèche en haut à droite). Cliquez sur l’application test avec le bouton gauche de la souris et sélectionnez Définition, la fenêtre de définition de l’application s’affiche. Dans le champ Mode d’Exécution, sélectionnez exécution et validez.
Lancement du démon client : bdaemon. Retournez à la fenêtre UNIX où vous avez lancé le menu admins. Choisissez l’option Gestion du client, puis démarrage.
Lancement de l’exécution des traitements Sélectionnez la fenêtre du pilote graphique au niveau du graphe des applications. Cliquez sur l’application test avec le bouton droit de la souris, choisissez le menu Actions, puis forcer A VENIR. Basculez sur la fenêtre du pilote graphique au niveau du graphe des traitements (si vous avez fermé cette fenêtre, cliquez deux fois sur l’application).
Les traitements sont tous passés A VENIR et vont s’exécuter les uns après les autres.
Visualisation du fichier log Cliquez deux fois sur un des traitements. La Liste des logs pour ce traitement s’affiche. Cliquez deux fois sur le traitement, puis choisissez sortie standard. 3.1.5.5 Repartir d’une base de données vierge
Une fois validée votre installation, vous pouvez repartir d'une base de données vierge. Pour cela, arrêtez Visual TOM (moteur, IHM et serveurs) et effacez le contenu du répertoire de la base de données : Sous Unix : cd $TOM_BASES rm -r * Au redémarrage des serveurs, la base de données sera recréée vierge.
12/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
3.2 Installation sous Windows NT L’installation d’un module Serveur ou d’un mode Client doit se faire dans une session d’un compte administrateur local. Remarque : L’installation d’une application à l’aide d’un outil comme TSE nécessite l’utilisation de la fonction Windows « Ajout /Suppression d’un programme »
3.2.1 Désinstallation Dans le cas d’une réinstallation, il est nécessaire d’effectuer une désinstallation de Visual TOM. Pour désinstaller Visual TOM, il faut arrêter tous les process de Visual TOM : - Les moteurs (processus tengine ) -
L’interface graphique (processus vtom) Les services (processus dserver, gserver, pserver, vtlserver et bdaemon )
Lorsque Visual TOM est inactif (services et moteurs arrêtés), vous pouvez lancer le programme de désinstallation automatique. Pour cela utilisez la fonction Windows « Démarrer\Panneau de configuration/Ajout/suppression de programmes » Certains répertoires ne sont pas supprimés après la désinstallation : - Le fichier vtom.ini dans le répertoire %windir% qui contient des paramètres de configuration. Ce fichier sera copié sous vtom.old lors d'une nouvelle installation et pourra donc être réutilisé. - Les services TCP de Visual TOM dans le fichier %windir%\system32\drivers\etc\services ; ils seront les ports par défaut lors de la prochaine installation (mais pourront être modifiés). - Les répertoires modifiés après l'installation (ex: la base de données) qui pourront être conservés, ou être éliminés par le gestionnaire de fichiers. Dans le cas d’une réinstallation sur de nouveaux répertoires, il faudra alors supprimer les variables d’environnement système telles que : ABM\BIN, ABM_LOG, TOM_BIN, TOM_STATS, TOMSTATS, ND_PATH.
3.2.2 Conventions Lors de l'installation des fenêtres apparaissent pour confirmer les paramètres de l'installation. Ces fenêtres contiennent les boutons suivants: - Back / précèdent : revient à l'écran précédent - Next / suivant : valide les paramètres à l'écran - Browse / Parcourir : sélection d'un fichier ou d'un répertoire - Cancel / Annuler : quitte la procédure d'installation
3.2.3 Paramètres de l’installation Il est possible d'installer un des quatre packages suivants:
1. Client / Serveur /IHM 2. Client 3. X-VISION
Copyright © ABSYSS. All rights reserved 04/04/12
= VT-SES-WNT ou VT-SDS-WNT = VT-CS-WNT = VT-XVI-WNT
91157135.doc
13/46
Visual TOM-Support de formation administrateurs
ATTENTION : Un paramètre d’installation commun aux quatre packages est le répertoire de destination (base d'installation de Visual TOM). Il ne faut pas choisir un nom de répertoire de destination composé de plusieurs mots séparés par des espaces comme « Program Files ».
3.2.3.1 Pack Serveur : Client /Serveur /IHM
Ce pack permet l'utilisation complète de Visual TOM. Paramètres d’installation à définir : - répertoire de destination (base d'installation de Visual TOM) - répertoire de la base de données - répertoire des logs (où seront archivés les traces d'exécution des jobs) - répertoire des statistiques (où seront stockés les fichiers d'analyse) 3.2.3.2 Pack X-Vision
Ce pack permet l’installation de l’IHM, du Isuperviser et du Webdoc. Les modes opératoires d’installation des modules ISuperviser Webdoc sont décrits dans le chapitre « Installation des modules Isuperviser et Webdoc ». Paramètres d’installation de l’IHM à définir: - répertoire de destination (base d'installation de Visual TOM) - nom de la machine serveur (nom ou adresse IP du serveur Visual TOM) 3.2.3.3 Pack Client
Ce pack permet l'exécution de traitements déclenchés par un serveur Visual TOM distant. Les paramètres d’installation à définir sont : répertoire de destination (base d'installation de Visual TOM) et répertoire des logs (où seront archivées les traces d'exécution des jobs).
14/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
3.2.4 Déroulement de la procédure d’installation 3.2.4.1 Lancement de l’installation
Pour lancer l’installation double-clicquez sur le fichier \/NT\VT-XXX-WNT\setup où XXX = SES XXX = SDS XXX = SBU XXX = CS XXX= XVI XXX= CN
Entreprise Server Departmental Server Backup Server Client Interface graphique Net Client
exemple d’installation d’un pack serveur :
A la fin de l’installation, on vous propose d’éditer le compte-rendu d’installation contenu dans le fichier Readme.txt situé dans le répertoire d’installation. Pour terminer l’installation de Visual TOM, il est nécessaire -
de copier le fichier license.lic dans le sous répertoire bin du répertoire d’installation du pack serveur (..\vtom\bin).
-
et de redémarrer la machine.
3.2.4.2 Création de Groupes de programmes Visual TOM
Lors de l'installation, un groupe de programmes Visual TOM a été créé. Ce groupe de programme est accessible par le menu Démarrer (Start) Il contient les icônes suivantes: - IHM Visual TOM TOM - ReadMe - Arrêt des serveurs - Démarrage serveurs - Fichier Vtom.ini
Lancement de l'interface graphique de Visual Lecture du rapport d’installation Arrêt des services Visual TOM Démarrage des services Visual TOM Fichier de configuration de Visual TOM
3.2.5 Validation de l’installation 3.2.5.1 Démarrage/ Arrêt des services Visual TOM
Lors de l’installation d’un pack serveur ou un pack client des services Windows sont créés. Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
15/46
Visual TOM-Support de formation administrateurs
Pour un pack serveur les services suivants sont créés : gère tous les évènements graphiques - AbsyssGestionGraphique gère tous les accès à la base de données - AbsyssOrdonnanceur - AbsyssNotificateur gère les notification d'évènements graphiques aux autres IHM connectés gère le fichier de licences - AbsyssLicense Pour un pack client, un seul service est créé : - AbsyssBatchManager
gère le lancement des jobs
Les services peuvent être gérés par l'intermédiaire du panneau services du panneau de configuration: Démarrer / Panneau de Configuration / Services
Les services de Visual TOM sont configurés pour démarrer automatiquement lors du démarrage de la machine. Il est possible de désactiver cette option via le bouton Démarrage dans la fenêtre des Services. 3.2.5.2 Accès à Visual TOM
Pour accéder à Visual TOM, il suffit de lancer l’exécutable de lancement de l’interface graphique vtom.exe dans le répertoire visual. Vous pouvez aussi démarrer l’interface graphique par le menu Démarrer\programmes\Visual TOM\IHM Visual TOM. Créez un environnement de test et validez l’installation.
16/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
4 Configuration du serveur Visual TOM La configuration d’un serveur Visual TOM se base sur les définitions de trois types de paramètres : - les numéros de port des communication des processus dserver, pserver , gserver, vtlderver et bdaemon qui ont pour noms respectifs tomDBd, ntfy, gwd , vtlicense et bdaemon - les variables d’environnements de l’administrateur de Visual TOM pour un serveur Unix et les variables d’environnement système pour un serveur Windows NT - les paramètres de configuration définis dans vtom.ini
4.1 Les ports de communication du serveur Visual TOM Les numéros de ports de communication doivent être définies dans le fichier /etc/services pour un système Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un système Windows NT. Pour un système Unix, les définitions des numéros de ports doivent être faites manuellement à la fin de l’installation du serveur. Pour un système Windows, les définitions des numéros de port sont faites automatiquement au cours de la phase d’installation. Ces numéros de communication doivent avoir des valeurs identiques sur toutes les machines utilisant Visual TOM . Les valeurs par défaut de ces ports de communication sont les suivantes : tomDBd 20001 gwd 20002 ntfy 20003 bdaemon 20004 vtlicense 20005
4.2 Les variables d’environnement de l’administrateur de Visual TOM pour un serveur Unix Les variables d’environnement de l’administrateur du serveur de Visual TOM sont définies dans le fichier vtom_init.[$SHELL]. La valeur de la variable $SHELL indique le type de shell associé à l’administrateur du serveur de Visual TOM : ksh pour korn shell, … Les valeurs de ces variables d’environnement sont positionnées lors de l’ouverture d’une session par l’administrateur de Visual TOM et elles sont utilisées par les différents processus de Visual TOM ; par exemple la variable $TOM_BASES qui contient le nom du répertoire de la base de données de Visual TOM est utilisée comme argument lors du lancement des processus dserver, pserver et gserver. Le fichier vtom_init.[$SHELL] est généré automatiquement dans le sous-répertoire $TOM_ADMIN lors de l’installation du module serveur de Visual TOM, et il est intégré au fichier .profile de l’administrateur de Visual TOM.
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
17/46
Visual TOM-Support de formation administrateurs
Ci dessous un tableau qui donne la liste des variables d’environnement utilisées par le module serveur de Visual TOM HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN VTOM TOM_BACKUP TOM_BASES TOM_BIN TOM_STATS TOM_TRACES PATH
Générales Nom de la machine Répertoire d’installation de Visual TOM Répertoire des scripts d’administration Administrateur Visual TOM Serveur Répertoire de la partie serveur Répertoire de backup des bases Répertoire de la base de données Visual TOM Répertoire des exécutables serveur Répertoire des statiques Répertoire des traces moteur et serveurs Le path comprend le répertoire vtom/bin
4.3 Les variables d’environnement pour un serveur Windows Les variables d'environnement créées lors de l’installation d’un serveur Visual TOM Windows NT sont les suivantes : -
TOM_BIN = répertoire des exécutables du serveur Visual TOM TOM_STATS = Répertoire des statiques TOMSTATS = Répertoire des statiques
Le répertoire contenant la base de données du serveur Visual TOM est défini dans le fichier vtom.ini : [GLOBALES] bases=e:\vtom\bases
Répertoire de la base de données
La visualisation des valeurs des variables d’environnement système de Windows se fait à l’aide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement .
4.4 Le fichier de configuration vtom.ini Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du serveur; c’est un fichier caché .vtom.ini. Sous Windows, ce fichier est généré au cours de la phase d’installation du serveur dans le répertoire %windir%V. La structure de ce fichier est organisée en sections.
18/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
4.5 Paramétrage de la procédure de communication des moteurs avec les clients. Les paramètres à mettre en place doivent être intégrées dans la section [general] pour Unix et dans section [GLOBALES] pour Windows. Sous Unix, [general] delaiWait:30 Délai d'attente "en secondes" d'une réponse d’un client suite à une demande de soumission d’un traitement ou une demande sur l’état d’exécution d’un traitement delaiRetry:60 Délai d’attente "en secondes" avant une nouvelle tentative de contact avec un client qui n’a pas répondu à une demande nbWaitRetry:10 Nombre de tentatives de contact avec un client avant la modification du statut d’un traitement StatusFailSubmit:ENCOURSNouveau statut d'un traitement qui n'a pas pu être soumis à un client StatusFailExist:ENCOURS Nouveau statut d'un traitement dont on a perdu le contact
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
19/46
Visual TOM-Support de formation administrateurs
4.6 La mise en place des traces des moteurs La mise en place des traces moteurs de Visual-Tom s’effectue en renseignant la section [_engine_trace] dans le fichier vtom.ini du serveur VTOM (%windir%\vtom.ini sous windows et $TOM_ADMIN/.vtom.ini sous UNIX) , de la manière suivante : Sous UNIX, [_engine_trace] nom_environnement1:1 nom_environnement2:1 nom_environnement3:1 Directory:/home/vtom/traces FileSize:10 FileCount:3 Sous WINDOWS, [engine_trace] nom_environnement1=1 nom_environnement2=1 nom_environnement3=1 Directory=c:\vtom\traces FileSize=10 FileCount=3 Ces paramètres ont la signification suivante : nom_environnement1=1 nom_environnementX=1 Directory= Filesize= X Filecount= N
(permet de préciser les noms des environnements pour lesquel la trace moteur sera active, ainsi que leur niveau de trace respectifs, 1 étant conseillé par défaut) (Indique le répertoire destination où seront générées les traces) (Indique la taille en Mo de chacun des fichiers traces) (Permet une rotation d’écriture des traces sur N fichiers + 1 fichier par défaut)
ATTENTION, il faut s’assurer que le répertoire définit par Directory, possède l’espace disque suffisant pour héberger l’ensemble des fichiers traces, à savoir : (Filecount +1) x Filesize x Nombre d’environnements déclarés dans la section [engine_trace] A NOTER, le paramétrage des traces moteurs est pris en compte dynamiquement et ne nécessite aucun arrêt/relance de processus.
20/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
4.7
Production de tableaux de bords des journées d’exploitation précédentes
Au cours de son activité quotidienne, les moteurs de Visual TOM alimentent la table de la base de données stats.dbf, appelée fichier des statistiques. Les fonctions d’analyse de traitements ou des statistiques permettent de produire les tableaux de bord de l’exploitation réalisée (cf les menus de l’interface graphique Analyse\Analyse des traitements ou Statistiques). Ces tableaux de bord sont générés à partir du fichier des statistiques stats.dbf. Attention : le fichier stats.dbf n’est pas purgé automatiquement par Visual TOM ; ce qui peut provoquer un ralentissement de l’activité des processus du serveur. La commande vtstools gère l’export ou la purge d’une partie ou de la totalité du fichier stasts.dbf. Sous Unix, la fonction d’alimentation du fichier des statistiques est active par défaut, par contre sous Windows, il faut mettre la valeur du paramètre stats à 1 pour que cette fonction soit active ou mettre la valeur 0 pour inhiber cette fonction. Le paramètre stats se trouve dans le fichier vtom.ini. [ GLOBALES ]
stats=1
Activation de la fonction analyse des traitements
4.8 L’historique Cette fonction permet de consulter l’historique des actions effectuées sur les objets du domaine d’exploitation. Cette fonction est active que lorsque le paramètre histo est positionné à 1 dans le fichier de configuration de Visual TOM. Sous Unix, il faut déclarer ce paramètre dans la general . [general] histo :1 pour activer la fonction historique [GLOBALES] histo=1 pour activer la fonction historique De la même manière que pour les statistiques, les moteurs de Visual TOM alimentent la table de la base de données histo.dbf . La fonction « historique » permet de générer un tableau récapitulant toutes les actions effectuées sur les objets du domaine d’exploitation. (cf le menu de l’interface graphique \historique). Ce tableau est généré à partir du fichier de l’historique histo.dbf . Attention : le fichier histo.dbf n’est pas purgé automatiquement par Visual TOM ; ce qui peut provoquer un ralentissement de l’activité des processus du serveur. La commande vthtools gère l’export ou la purge d’une partie ou de la totalité du fichier histo.dbf.
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
21/46
Visual TOM-Support de formation administrateurs
5 Les commandes d’un module serveur 5.1 Sauvegarde et restauration d’une base On peut sauvegarder une base de production en utilisant : - la commande tbackup - ou la commande texport
5.1.1 Sauvegarde du répertoire de la base de données tbackup /target= Cet outil de sauvegarde de la base de données fonctionne en client/serveur, c'est-à-dire que l'on peut réaliser une sauvegarde de la base depuis une autre machine en positionnant la variable TOM_REMOTE_SERVER avec le nom de la machine sur laquelle on veut faire la sauvegarde de la base de données Visual TOM. Sous le répertoire défini par le path_de_sauvegarde est créé un répertoire qui correspond à la JJMMAA-HHMMSS sous lequel l'ensemble des fichiers de la base de données est sauvegardé. Pour restaurer une base, Il faut dans un premier temps arrêter tous les process Vtom puis copier la base sauvegardée puis relancer les services Vtom et l’IHM.
5.1.2 Liste le contenu de la base dans un fichier texte texport > nom_fichier (base) Options :
texport env/app/job > nom_fichier
Liste le contenu de la base de données dans un fichier ASCII (cf. Les tableaux comparatifs des options des commandes taddjob et taddapp et leurs formats au mode import/export).
Il est possible d'exporter tout le contenu de la base (comportement par défaut) ou de sélectionner un environnement, une application ou un traitement. Le fichier généré peut être modifié (en tenant compte des règles syntaxiques) avant d'être importé dans une autre base de données (ou dans la même base de données).
5.1.3 Import des objets définis dans un fichier texte timport nom_fichier La commande timport permet de récupérer des objets exportés d'une autre base de données par la commande texport (cf. Les tableaux comparatifs des options des commandes taddjob et taddapp et leurs formats au mode import/export).
Les objets définis dans le fichier d'export sont créés dans la base de données courante, ou s'ils existent déjà, sont mis à jour. Si les applications ou les traitements exportés utilisent des objets qui n'existent pas dans la base de données courante, ceux-ci sont créés tels que définis dans le fichier d'export.
22/46
Attention, pour les valeurs par défaut, on récupère les valeurs par défaut de la nouvelle base de données (environnement ou applications).
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
5.2 La gestion des moteurs 5.2.1 Démarrage d’un moteur sur un Environnement estart nom_environnement] Démarre le moteur de Visual TOM pour l’environnement nom_environnement
5.2.2 Arrêt d’un moteur sur un Environnement estop nom_environnement Demande l’arrêt du moteur Visual TOM pour l’environnement [nom_environnement]. Messages de retour possibles: environnement non trouve l’environnement a été trouvé, mais le moteur n’est pas actif arret du moteur demande l’environnement a été trouvé, mais le moteur n’est pas actif
5.2.3 Remise à OFF du flag moteur de l’interface graphique pour un environnement eclear nom_environnement Force à OFF le flag signalant un Moteur actif pour l’environnement [nom_environnement] (dans le cas où le flag moteur est à ON mais aucun process tengine n’y est associé).
Message de retour possibles : Aucun moteur ne tourne sur cet environnement l’environnement a été trouvé, mais le moteur n’est pas actif Environnement trouve , absence d’un ;moteur signalée dans la base l’environnement a été trouvé, mais le moteur n’est pas actif arrêt du moteur demande l’environnement a été trouvé, mais le moteur n’est pas actif
5.2.4 Test de présence d’un moteur actif pour un environnement epresent nom_environnement Signale si un Moteur est actif pour l’environnement [nom_environnement]
5.2.5 Vérification des blocages de date Pour UNIX : tchkdate /nom=date [/env=env] Pour NT : idem
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
23/46
Visual TOM-Support de formation administrateurs
6 Configuration du client Visual TOM Le client Visual TOM est chargé de : - l'exécution des scripts associés aux traitements - l’édition des scripts - et la visualisation et la suppression des logs d’exécution des scripts Lors de la réception d’une demande de soumission d’un traitement envoyée par un serveur Visual TOM, le client stocke les références du traitement (pid, nom du script, …) dans une file d’attente appelée queue batch. Et selon le paramétrage de cette queue batch (nombre de jobs simultanés, …), le client décide ou non de lancer l’exécution du script associé au traitement. Le lancement de l’exécution d’un script d’un traitement est effectué par un script shell sous Unix ou un fichier de commandes sous Windows appelé Submitter ; à chaque queue batch est associé un Submitter. Un client peut gérer plusieurs queue batch. La configuration d’un client Visual TOM se base sur les paramétrages de trois types d’objets : - le numéros de port de communication - les variables d’environnements de l’administrateur de Visual TOM pour un client Unix et les variables d’environnement système pour un client Windows - les paramètres de configuration définis dans vtom.ini - les queue batch - les fichiers de commandes ou shells associés aux queue batch (submitters) - le fichier de commande ou script shell de gestion des fichiers logs
6.1 Les ports de communication utilisés par un client En dehors du port bdaemon, un seul port de communication est utilisé par un client Visual TOM. C’est le port tomDBd du processus dserver du module serveur. La valeur par défaut de ce port est 20001 et elle est définie dans le fichier /etc/services pour un système Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un système Windows NT. Cette valeur est mise à jour automatiquement lors de l’installation d’un client Windows NT, par contre, sur un système Unix, la mise à jour de la valeur du port tomDBd doit être faite manuellement. Pour tester l’état de la communication d’un client vers un serveur, il suffit de positionner la valeur de la variable d’environnement TOM_REMOTE_SERVER avec le nom de la machine du serveur Visual et de lire la valeur d’une ressource de Visual TOM avec la commande tval Tval –name
6.2 Les variables d’environnement de l’administrateur du client Visual TOM sous Unix Comme pour un serveur Visual TOM Unix, les variables d’environnement de l’administrateur du client de Visual TOM sont définies dans le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL donne le type de shell associé à l’administrateur du client de Visual TOM : ksh pour korn shell, … Les valeurs de ces variables d’environnement sont positionnées lors de l’ouverture d’une session par l’administrateur de Visual TOM et elles sont utilisées par le processus bdaemon; par exemple la variable $ABM_LOGS qui contient le nom du répertoire des logs est utilisée à la fin de l’exécution des traitements. 24/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
Le fichier vtom_init.[$SHELL] est généré automatiquement dans le répertoire $TOM_ADMIN lors de l’installation du module client Visual TOM, et il est intégré au fichier .profile de l’administrateur de Visual TOM. Dans la cas d’une installation d’un module serveur et d’un module client sur la même machine un seul fichier vtom_ini est généré et il contient les variables d’environnement pour les processus du serveur et du client. Ci dessous un tableau qui donne la liste des variables d’environnement utilisées par le module client de Visual TOM HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN
Générales Nom de la machine Répertoire d’installation de Visual TOM Répertoire des scripts d’administration Administrateur Visual TOM
ABM ABM_BIN ABM_LOGS ABM_SPOOL
Client Répertoire d’installation du client ABM Répertoire des exécutables Répertoire des logs Répertoire de la file d’attente des traitements
6.3 Les variables d’environnement Windows d’un client Visual TOM Lors de l’installation d’un client, les variables d'environnement système suivantes sont créées : - ABM_BIN = répertoire des exécutables du client Visual TOM - ABM_LOG = Répertoire des logs La visualisation des valeurs des variables d’environnement système de Windows se fait à l’aide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement .
6.4 Le fichier de configuration vtom.ini Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du client ; c’est un fichier caché .vtom.ini. Sous Windows, ce fichier est généré lors de l’installation dans le répertoire %windir%. Dans le cas d’une installation d’un serveur et d’un client sur la même machine, un seul fichier vtom.ini est généré avec les paramètres du serveur et du client. Nota : Toute modification de ce fichier nécessite un arrêt et une relance des processus de Visual TOM pour qu’elle soit prise en compte .
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
25/46
Visual TOM-Support de formation administrateurs
6.5 les queue batch Une queue batch est un objet de Visual TOM qui permet à un client de gérer des files d’attente de traitements à soumettre. A chaque queue batch est associé un script shell sous Unix ou un fichier de commandes sous Windows qui « en capsule » l’exécution du script d’un traitement. Ce script shell ou fichier de commandes est appelé submitter; par exemple : - Sous un client Unix, un traitement défini avec la queue batch queue_ksh sera soumis par le script shell tom_submit.ksh - Sous un client Windows NT, un traitement défini avec la queue batch queue_wnt sera soumis par le fichier de commandes Submit_queue_wnt.bat
6.5.1 Configuration d’une queue batch sous un client Unix A chaque queue batch correspond un sous-répertoire sous le chemin $ABM/config/queues. Ce sous-répertoire contient les fichiers suivants : queue.conf o fichier de configuration de la queue: users o définition des utilisateurs: La description du fichier queue.conf est la suivante : N: Nombre maximum de jobs en exécution simultanée M: Nombre Maximum de jobs en attente Shell : Chemin et nom du shell ; le nom du shell doit être le même que l’extension du nom de la queue. Par exemple, pour la queue batch queue_test, le shell soit le nom test P: priorité des jobs dans la queue (non utilise sous UNIX) Exemple : Fichier $ABM/config/queues/prod/queue_config de la queue prod 15 5 /user/bin/tcsh 4 Le queue prod a droit a 15 jobs en exécution simultanée et a 5 jobs en attente. Elle utilisera le shell /user/bin/tcsh La priorité des jobs dans la queue est de 4 (non utilise sous UNIX).
6.5.1.1 Configuration des administrateurs
Un administrateur est un utilisateur du système d’exploitation qui peut gérer toutes les queues et tous les jobs. Il est le seul habilité à arrêt et à démarrer le client. La liste des administrateurs est définie dans le fichier $ABM_CONFIG/managers 6.5.1.2 Configuration des utilisateurs
Un utilisateur peut être associé a une ou plusieurs queues batch qu'il peut utiliser. Pour chaque user, on indique : o le nombre de jobs batch qui peuvent être exécutés en même temps. o le nombre de jobs batch en attente. La syntaxe de saisie est la suivante : "Nom_Login:Max_Exe:Max_Wait". Cette liste des utilisateurs est définie dans le fichier users. NB : La déclaration du user "any" dans une queue rend accessible cette queue à tout les users non déclarés. Exemple : 26/46
le fichier $ABM/config/queues/prod/users de la queue prod 91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs oracle:1:1
L’utilisateur oracle a droit a un seul job en exécution et un seul job en attente dans la queue prod
6.5.2 Configuration d’une queue batch sous un client Windows La liste des queue batch est déclarée dans le paramètre ABM_QUEUE de la section [bdaemon] du fichier vtom.ini. A l’installation, il n y a qu’une seule queue qui est déclarée, c’est la queue queue_wnt. Dans le fichier vtom.ini généré à l’installation on trouve : [bdaemon] ABM_QUEUES :/queue_wnt:1 Si voulez rajouter la queue queue_test, il suffit de rajouter le nom de la queue et le nombre de jobs simultanés autorisés (par exemple 10) sur la ligne ABM_QUEUE. ABM_QUEUE : /queue_wnt :1 /queue_test :10 Il faut aussi créer un submiter associé à toute nouvelle queue_batch et arrêter et redémarrer le service AbsyssBatchManager.
6.6 Les Submitter On rappelle qu’un Submitter est un script shell ou un fichier de commandes associé à une quueue batch. Le submiter est exécuté avant la soumission de tout traitement. Sous Unix, les submiier se trouvent dans le répertoire pointé par la variable $TOM_ADMIN sous Ubix, et sous Windows ces submitter se trouvent dans le répertoire pointé par la variable %ABM_BIN% Exemple d’exécution d’un traitement ayant pour script job_test et pour queue batch queue_test : -
-
le Client Visual TOM Unix déclenchera alors le script tom_submit avec l’extension test soit $TOM_ADMIN/tom_submit.test, en lui transmettant le nom du script à exécuter et une liste de valeurs de variables d’environnement Le client Visual TOM Windows déclenchera alors le fichier de commandes %ABM_BIN%/Submit_queue_test.bat en lui transmettant le nom du script à exécuter et une liste de valeurs de variables d’environnementparamètres
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
27/46
Visual TOM-Support de formation administrateurs
Le tableau ci-après liste les variables d'environnement qui sont transmises par le client Visual TOM au Submiter : TOM_REMOTE_SERVER 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
TOM_JOB_EXEC TOM_FAMILY TOM_QUEUE TOM_LOG_ACTION TOM_HOST
Nom de la machine serveur Visual TOM qui a lancé le traitement. Identifiant du traitement dans la base de données Nom du traitement Nom de l’application Nom de l’environnement Nom de la date d’exploitation Valeur de la date d’exploitation Utilisateur exécution du traitement Nom du script a exécuter Liste des paramètres du script ou job Priorité du job Nombre de reprises effectuées Point de reprise. La valeur de la variable d’environnement TOM_JOB_POINT est égale à 0 par défaut. La modification de la valeur de cette variable d’environnement s’effectue à l’aide de la commande tstep (tstep –l
Ces variables d’environnement peuvent être utilisées pour personnaliser le submitter ; Par exemple l’envoi d’un message sur une console lorsqu’un traitement se termine en erreur. L’exécution d’un Submitter standard se déroule de la manière suivante :: - L’affichage dans la log des valeurs des variables d’environnement - L’exécution du script - La gestion du code retour du traitement, acquittement ou remontée d'erreur à Visual TOM par la commande tsend - La gestion des fichiers logs en fin de traitement
6.7 Gestion des logs Tout traitement soumis par le client Visual TOM génère deux fichiers de traces d'exécution appelée fichiers log. Ces fichiers sont générés sur le sous-répertoire pointé par la variable d’environnement ABM_LOGS pour Unix et ABM_LOG pour Windows et portent l’identifiant suivant : -
nom_env_nom_appli_nom_ job _ AAMMJJ-HHMMSS .o
-
nom_env_nom_appli_nom_ job _ AAMMJJ-HHMMSS .e
sortie
standard sortie erreur
Par défaut Visual TOM génère deux fichiers log pour chaque exécution d’un traitement. Il est possible de modifier ce comportement par l'intermédiaire du menu fin de traitement (voir 28/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
définition d’un u traitement). Les options de ce menu sont : impression de la log, suppression de la log et copie de la log. Les valeurs des actions choisies dans la définition d’un traitement sont transmises par l’intermédiaire de la variable d’environnement TOM_LOG_ACTION, et sont traitées par le script ou fichier de commandes gestlog situé dans le répertoire $TOM_ADMIN pour Unix ou %ABM_BIN % pour Windows. Pour modifier le comportement par défaut de la gestion des logs, il suffit de personnaliser le script ou fichier de commandes gestlog en tenant compte des variables d’environnement suivantes : TOM_SCRIPT : TOM_LOG : TOM_LOG_ACTION :
Copyright © ABSYSS. All rights reserved 04/04/12
nom du script nom de la log action à accomplir sur la log
91157135.doc
29/46
Visual TOM-Support de formation administrateurs
7 Configuration d’une IHM Visual TOM L’interface graphique de Visual TOM permet : - de définir et de modifier les objets de la base de données du serveur - piloter l’exploitation - d’éditer les scripts associés aux traitements - et de visualiser les logs d’exécution des scripts L’interface graphique communique - avec le serveur en utilisant les ports de communications tomDBd, gwd et ntfy - avec les clients (pour l’édition des scripts et la consultation des logs) en utilisant le port de communication bdaemon L’exécutable qui permet de lancer l’interface graphique est vtom ; il est situé dans le répertoire d’installation de l’interface graphique « visual » La configuration d’une IHM Visual TOM se base sur les paramétrages de trois types d’objets : - les numéro de port des communication du tomDBd, gwd, ntfy et bdaemon -
-
les variables d’environnements de l’administrateur de Visual TOM pour une IHM Unix et les variables d’environnement système pour une IHM Windows les paramètres de configuration définis dans vtom.ini
Attention : Si on utilise exceed pour lancer xvision x11, dans la configuration exceed, au niveau de la définition de l'écran,le paramètre "use native WM for embedded client" doit être décoché.si ce paramètre est coché "à tort", cela peut provoquer des plantages sur xvision.
7.1 Les ports de communication utilisés par une IHM Les ports de communication utilisés par l’interface graphique sont - tomDB pour communiquer le processus dserver du module serveur ; la valeur par défaut de ce port est 20001 - gwd pour communiquer le processus gwd du module serveur ; la valeur par défaut de ce port est 20002 - ntfy pour communiquer le processus pserver du module serveur ; la valeur par défaut de ce port est 20003 - bdaemon pour communiquer les processus des clients Visual TOM ; la valeur par défaut de ce port est 20004 Ces ports de communication sont déclarés dans le fichier /etc/services pour un système Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un système Windows. La déclaration des ports de communication est faite automatiquement lors de l’installation de l’iHM Windows, par contre, sur un système Unix, cette déclaration doit être faite manuellement.
30/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
7.2 Les variables d’environnement de l’administrateur de l’IHM sous Unix L’administrateur d’une IHM Visual TOM est le même que l’administrateur du serveur Visual car l’installation d’une IHM sous Unix n’est possible qu’avec une installation d’un module serveur. Les variables d’environnement de l’administrateur de l’IHM de Visual TOM sont définies dans le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL donne le type de shell associé à l’administrateur de l’IHMVisual TOM : ksh pour korn shell, … Les valeurs de ces variables d’environnement sont positionnées lors de l’ouverture d’une session par l’administrateur de Visual TOM Le fichier vtom_init.[$SHELL] est généré automatiquement dans le sous-répertoire $TOM_ADMIN lors de l’installation du module client Visual TOM, et il est intégré au fichier .profile de l’administrateur de Visual TOM. Ci dessous un tableau synthétise les variables d’environnement utilisées par le module IHM de Visual TOM HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN
Générales Nom de la machine Répertoire d’installation de Visual TOM Répertoire des scripts d’administration Administrateur Visual TOM
IHM (Interface graphique) TOM_VISUAL TOM_LP ND_PATH
Répertoire d’installation de l’interface graphique Script associé à l'impression dans l'interface graphique Chemin pour les fichiers de configuration Neuron Data ($TOM_VISUAL)
7.3 Les variables d’environnement système Windows d’une IHM Une seule variable d'environnement système est créée lors de l’installation d’une IHM Visual TOM Windows, ND_PATH qui contient le nom du répertoire des fichiers de configuration Neuron Data.
7.4 Le fichier de configuration vtom.ini Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du serveur et de l’IHM; c’est un fichier caché .vtom.ini. Sous Windows, Ce fichier est généré lors de l’installation dans le répertoire %windir%. Dans le cas d’une installation d’un serveur (avec IHM) et d’un client sur la même machine, un seul fichier vtom.ini est généré avec les paramètres du serveur, de l’IHM et du client. Nota : Toute modification de ce fichier nécessite un arrêt et une relance de l’IHM Visual TOM pour être prise en compte.
Fichier vtom.ini pour Unix Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
31/46
Visual TOM-Support de formation administrateurs
[vtom] documentation:/…/documentation/nom_serveur ou http://webdoc/documentation [aide] (Aide en ligne au format html) browser:/appli/netscape/netscape
Fichier vtom.ini pour Winows [GLOBALES] pourcent=0
faire apparaitre % dans pilote graphique pour Supra Manager
[VTOM] ND_PATH=e:\vtom\visual\ documentation=e:\vtom\visual\ [aide] browser=c:\Program Files\Microsoft Internet\IEXPLORER.exe L’utilisation des paramètres documentation et browser sera abordée dans le chapitre « mise en place de la fonctionnalité documentation et consignes.
7.5 Mise en place des fonctionnalités documentation et consignes Cette fonctionnalité permet l'accès depuis l'IHM Visual TOM à des pages au format HTML Vous pouvez créez pour chaque entité (application et traitement) -
un dossier d’exploitation qui contient tout le descriptif de l'entité à laquelle il est associé un dossier qui contient les consignes d'exploitation destinées aux exploitants dans lesquelles on trouve les informations relatives au contexte de production telles que la valeur des paramètres, les consignes de reprise.
L'accès à ces document dossiers se fait par l'intermédiaire d’items dans les menus contextuels des applications et des traitements : -
En mode définition on accède aux deux types de documents liés à l'entité sélectionnée
-
En suivi ou pilotage on accède aux consignes liées à l'entité sélectionnée.
Les documents identifiés par le nom de l'entité associée doivent être générés dans des répertoire référencé dans le fichier vtom.ini par le paramètre « documentation » de la section [vtom]: Nommage d’un document de type documentation pour une application : env_app_ doc.htm; env = nom de l’environnement ; app = nom de l’application Nommage d’un document de type consignes pour une application : env_app_ recovery.htm ; env = nom de l’environnement ; app = nom de l’application Nommage d’un document de type documentation pour un traitement : env_app_job_ doc.htm; env = nom de l’environnement ; app = nom de l’application ; job = nom du traitement 32/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM – Support de formation administrateurs
Nommage d’un document de type consignes pour un traitement : env_app_job_ recovery.htm; env = nom de l’environnement ; app = nom de l’application ; job = nom du traitement L’accès à ces dossiers d’exploitation et de consignes se fait à l’aide d’un browser que vous aurez référencé dans le paramètre « browser » de la section [aide] du fichier vtom.ini.
Copyright © ABSYSS. All rights reserved 04/04/12
91157135.doc
33/46
Visual TOM-Support de formation administrateurs
8 Conception et Pilotage de la production en mode commande Ces commandes ne sont disponibles que sur machine serveur Visual TOM.
8.1.1 Ajout ou modification d’objets dans le domaine d’exploitation tlist - liste les objets du domaine d'exploitation La commande tlist permet de récupérer en ligne de commande les noms des objets du domaine d'exploitation. Pour les applications, tlist renvoie aussi le nombre de traitements qu'elle contient, et le nombre de traitements qui sont statués (etats autres que A VENIR ou EN COURS). Utilise sans arguments, tlist renvoie son usage.
34/46
91157135.doc
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM-Support de formation administrateurs
8.2 Ajout et modification d’une application Pour UNIX : taddapp /nom=env/app [options] Pour NT : idem La commande taddapp permet la création d’une application dans un environnement et une application avec toutes ses caractéristiques définies en options (voir le tableau des options de la commande taddapp ci-après). Si l'application existe déjà, elle est mise à jour avec les nouvelles valeurs transmises en argument à la commande taddapp. Si des options ne sont pas précisées, l'application conserve ses anciennes valeurs pour ces champs. En mode création, seul le nom de l'application est obligatoire. Pour les champs qui ne sont pas précisés, l’application hérite alors des caractéristiques par défaut de l’environnement. Les options de la commande taddapp pour UNIX et NT Caractéristique Nom Commentaire Famille Date d’exploitation Type de périodicité Cyclique période du cycle Periodicité Heure de départ minimum Heure de départ maximum Mode d'exécution Machine Queue batch Utilisateur ne pas déplanifier les successeurs Heure de déplanification Liste des paramètres 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:/] 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 <"commentaire"> <« famille »> periodique | demande oui | non journaliere | hebdomadaire | mensuel | annuel job | stop | exec | test | simu <"machine"> <"queue"> <"utilisateur"> oui | non < par1 >[,< par2 >,...,< parn >] < env >/< appli >/< job >[< type de lien >]
défaut obligatoire aucun aucune obligatoire periodique non 00:00:00 journalière 00:00:00 illimite job defaut de l'application defaut de l'application defaut de l'application non 23:59:59 aucun aucun
type de lien : obli | facu | excl | cond | erre
Copyright © ABSYSS. All rights reserved
35/46
91157135.doc
04/04/12
Visual TOM-Support de formation administrateurs Lien vers ...
/LienVers
Liens_vers
< env >/< appli >/< job >[< type de lien >]
aucun
type de lien : obli | facu | excl | cond | erre
Calendrier Jours de la semaine Jours du mois Semaines du mois Mois de l'année Formule Ressources Statut
/Cal /Jsem /Jmois /Smois /Mannee /Formule /Res /status
ressource status
Géométrie
/Geom
geometrie
couleur bordure couleur fond couleur titre Copie de ... Mise en exploitation
/Cbord /Cfond /Ctitre /De /exploit
sfrmclr sbgclr sfrblclr
36/46
calendrier jour_semaine jour_mois semaine_mois Mois_annee
NON DISPONIBLE
91157135.doc
O,C,R,F c * 7 O,C,R,F c * 31 O,C,R,F O,C,R,F c * 12
defaut de l’application OOOOOOO (O * 7) C * 31 OOOOO OOOOOOOOOOOO aucune aucune
NO (non planfié) | AV (a venir) | EN (en cours) | ER (en erreur) AV (a venir) | TE (terminé) | DE (deplanifié)
hxl+y+x h:hauteur, l: largeur, y: ordonnée, x:abscisse
< env >/< appli > 1 pour la mise en exploitation
90x16+0+0 defaut IHM defaut IHM defaut IHM aucun
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM-Support de formation administrateurs Lien vers ...
/LienVers
Liens_vers
< env >/< appli >/< job >[< type de lien >]
aucun
type de lien : obli | facu | excl | cond | erre
Calendrier Jours de la semaine Jours du mois Semaines du mois Mois de l'année Formule Ressources Statut
/Cal /Jsem /Jmois /Smois /Mannee /Formule /Res /status
ressource status
Géométrie
/Geom
geometrie
couleur bordure couleur fond couleur titre Copie de ... Mise en exploitation
/Cbord /Cfond /Ctitre /De /exploit
sfrmclr sbgclr sfrblclr
36/46
calendrier jour_semaine jour_mois semaine_mois Mois_annee
NON DISPONIBLE
91157135.doc
O,C,R,F c * 7 O,C,R,F c * 31 O,C,R,F O,C,R,F c * 12
defaut de l’application OOOOOOO (O * 7) C * 31 OOOOO OOOOOOOOOOOO aucune aucune
NO (non planfié) | AV (a venir) | EN (en cours) | ER (en erreur) AV (a venir) | TE (terminé) | DE (deplanifié)
hxl+y+x h:hauteur, l: largeur, y: ordonnée, x:abscisse
< env >/< appli > 1 pour la mise en exploitation
90x16+0+0 defaut IHM defaut IHM defaut IHM aucun
Copyright © ABSYSS. All rights reserved
04/04/12
Visual TOM-Support de formation administrateurs
8.3 Ajout ou modification d'un traitement Pour UNIX : taddjob /nom=env/app/job /script= [ options ] Pour NT : idem La commande taddjob permet la création ou la modification d’un job dans un environnement et une application avec toutes ses caractéristiques définies en options (voir le tableau des options de la commande taddjob ci-après). En mode création, seuls le nom et le script du traitement sont obligatoires. Le traitement hérite alors de toutes les caractéristiques par défaut de l’application. Si le nom du traitement n'existe pas dans l'application et l'environnement références, le traitement est créé, sinon il est mis à jour. Les options de la commande taddjob pour UNIX et NT Caractéristique Nom Script Commentaire Famille Type de périodicité Cyclique période du cycle Periodicité Heure de départ minimum Heure de départ maximum Mode d'exécution Machine Queue batch Utilisateur ne pas déplanifier les successeurs Heure de déplanification Blocage de la date d'exploitation mettre l'application en erreur
Mode commande /Nom /Script /Comm /Family /TypePer /Cyclique /Cycle /Per /Hdeb /Hfin /Mode /Machine /Queue /User /NonDepl /Hdepl /Bloquant /ApplErr
Liste des paramètres
/Par
Copyright © ABSYSS. All rights reserved 04/04/12
Mode export [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_erre ur parametres
valeurs / format <script> <"commentaire"> <« famille »> periodique | demande oui | non journaliere | hebdomadaire | mensuel | annuel stop | exec | test | simu <"machine"> <"queue"> <"utilisateur"> oui | non oui | non oui | non
défaut obligatoire obligatoire aucun aucune periodique non 00:00:00 journalière 00:00:00 illimite exec defaut de l'application defaut de l'application defaut de l'application non 23:59:59 oui oui
< par1 >[,< par2 >,...,< parn >]
aucun 91157135.doc
37/46
Visual TOM-Support de formation administrateurs
8.3 Ajout ou modification d'un traitement Pour UNIX : taddjob /nom=env/app/job /script= [ options ] Pour NT : idem La commande taddjob permet la création ou la modification d’un job dans un environnement et une application avec toutes ses caractéristiques définies en options (voir le tableau des options de la commande taddjob ci-après). En mode création, seuls le nom et le script du traitement sont obligatoires. Le traitement hérite alors de toutes les caractéristiques par défaut de l’application. Si le nom du traitement n'existe pas dans l'application et l'environnement références, le traitement est créé, sinon il est mis à jour. Les options de la commande taddjob pour UNIX et NT Caractéristique Nom Script Commentaire Famille Type de périodicité Cyclique période du cycle Periodicité Heure de départ minimum Heure de départ maximum Mode d'exécution Machine Queue batch Utilisateur ne pas déplanifier les successeurs Heure de déplanification Blocage de la date d'exploitation mettre l'application en erreur
Mode commande /Nom /Script /Comm /Family /TypePer /Cyclique /Cycle /Per /Hdeb /Hfin /Mode /Machine /Queue /User /NonDepl /Hdepl /Bloquant /ApplErr
Liste des paramètres
/Par
Mode export [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_erre ur parametres
valeurs / format <script> <"commentaire"> <« famille »> periodique | demande oui | non journaliere | hebdomadaire | mensuel | annuel stop | exec | test | simu <"machine"> <"queue"> <"utilisateur"> oui | non oui | non oui | non
défaut obligatoire obligatoire aucun aucune periodique non 00:00:00 journalière 00:00:00 illimite exec defaut de l'application defaut de l'application defaut de l'application non 23:59:59 oui oui
< par1 >[,< par2 >,...,< parn >]
aucun
Copyright © ABSYSS. All rights reserved
37/46
91157135.doc
04/04/12
Visual TOM-Support de formation administrateurs Lien de ...
/LienDe
liens_de
< env >/< appli >/< job >[< type de lien >]
aucun
type de lien : obli | facu | excl | cond | erre
Lien vers ... Calendrier Jours de la semaine Jours du mois Semaines du mois Mois de l'année Formule Ressources Statut
/LienVers /Cal /Jsem /Jmois /Smois /Mannee /Formule /Res /status
liens_vers calendrier jour_semaine jour_mois semaine_mois mois_annee ressource Status
Géométrie
/Geom
geometrie
< env >/< appli >/< job >[< type de lien >] O,C,R,F c * 7 (ouvert, ferme, calculé, rien) O,C,R,F c * 31 O,C,R,F O,C,R,F c * 12 NON_PLANIFIE | EN_ERREUR | A_VENIR | EN_COURS | EN_ERREUR | TERMINE hxl+y+x h:hauteur, l: largeur, y: ordonnée,
aucun defaut de l’application OOOOOOO (O * 7) C * 31 OOOOO OOOOOOOOOOOO aucune aucune A_VENIR 90x16+0+0
x:abscisse
couleur bordure couleur fond couleur titre Copie de ... utilisation ou non du mode "Formule" dans un planning utilisation ou non du mode "Planning" dans un planning Mise en exploitation
38/46
/Cbord /Cfond /Ctitre /De /useformule
sfrmclr Sbgclr sfrblclr NON DISPONIBLE
< env >/< appli >/< job > [o,n]
/useplanning
[o,n]
/exploit
1 pour la mise en exploitation
91157135.doc
defaut IHM defaut IHM defaut IHM aucun
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM-Support de formation administrateurs Lien de ...
/LienDe
liens_de
< env >/< appli >/< job >[< type de lien >]
aucun
type de lien : obli | facu | excl | cond | erre
Lien vers ... Calendrier Jours de la semaine Jours du mois Semaines du mois Mois de l'année Formule Ressources Statut
/LienVers /Cal /Jsem /Jmois /Smois /Mannee /Formule /Res /status
liens_vers calendrier jour_semaine jour_mois semaine_mois mois_annee ressource Status
Géométrie
/Geom
geometrie
< env >/< appli >/< job >[< type de lien >] O,C,R,F c * 7 (ouvert, ferme, calculé, rien) O,C,R,F c * 31 O,C,R,F O,C,R,F c * 12 NON_PLANIFIE | EN_ERREUR | A_VENIR | EN_COURS | EN_ERREUR | TERMINE hxl+y+x h:hauteur, l: largeur, y: ordonnée,
aucun defaut de l’application OOOOOOO (O * 7) C * 31 OOOOO OOOOOOOOOOOO aucune aucune A_VENIR 90x16+0+0
x:abscisse
couleur bordure couleur fond couleur titre Copie de ... utilisation ou non du mode "Formule" dans un planning utilisation ou non du mode "Planning" dans un planning Mise en exploitation
38/46
/Cbord /Cfond /Ctitre /De /useformule
sfrmclr Sbgclr sfrblclr NON DISPONIBLE
< env >/< appli >/< job > [o,n]
/useplanning
[o,n]
/exploit
1 pour la mise en exploitation
91157135.doc
defaut IHM defaut IHM defaut IHM aucun
Copyright © ABSYSS. All rights reserved 04/04/12
Visual TOM-Support de formation administrateurs
8.4 Suppression d'un traitement Pour UNIX : tdeljob -a app –e env -j job Pour NT : idem La commande tdeljob permet de supprimer un job donné d'une application donnée d'un environnement donné.
8.5 Suppression d’un lien Pour UNIX : tdellink env/app/job (de)env/app/job(vers) Pour NT : idem La commande tdellink permet de supprimer un lien entre traitements ou applications. L'option "-f" permet de supprimer des liens n'ayant pas d'existence graphique. Attention !!! Ce mode est à utiliser avec précautions, sauvegarde de base et arrêt du moteur. Remarque X-Lien ET et Lien OU non supportés
Visual TOM-Support de formation administrateurs
8.4 Suppression d'un traitement Pour UNIX : tdeljob -a app –e env -j job Pour NT : idem La commande tdeljob permet de supprimer un job donné d'une application donnée d'un environnement donné.
8.5 Suppression d’un lien Pour UNIX : tdellink env/app/job (de)env/app/job(vers) Pour NT : idem La commande tdellink permet de supprimer un lien entre traitements ou applications. L'option "-f" permet de supprimer des liens n'ayant pas d'existence graphique. Attention !!! Ce mode est à utiliser avec précautions, sauvegarde de base et arrêt du moteur. Remarque X-Lien ET et Lien OU non supportés
Copyright © ABSYSS . All rights reserved Réf. : 91157135.docdoc
39/46 04/04/12
Visual TOM-Support de formation administrateurs
9 Installation des modules Isuperviser Le module I-Superviser utilisent une passerelle applicative appelée I-Server qui permet de communiquer avec les domaines d’exploitation de Visual TOM.
9.1 Installation de la passerelle I-server L’installation du module I-Server doit se faire dans une session d’un compte administrateur local. Les fichiers nécessaires à l’installation du module I-Server sont : iserver.exe, iserver.ini et security.ini. L’exécutable iserver.exe est situé dans le répertoire bin du répertoire d’installation du module serveur ../vtom/bin pour Unix et ..\vtom\services\bin pour Windows. Sous Unix, créez la variable d’environnement $ISERVER_INI et positionner la valeur de cette variable avec le chemin complet du fichier iserver.ini : export $ISERVER_INI=. Sous Windows, créez et positionnez la variable d’environnement système ISERVER_INI avec le nom du fichier iserver.ini, ou, il suffit de copier mettre le fichier iserver.ini dans le répertoire pointé par la variable %windir%. Paramétrez les fichiers iserver.ini et security.ini. L’exécutable iserver.exe doit avoir un accès en mode lecture et écriture sur ces deux fichiers.
Contenu du Ficher iserver.ini : [server] name = nom de la machine d’installation du I-server location = nom de la société contact = adresse E-mail du responsable technique listenPort = numéro de port d’écoute du service Iserver [domain] host = nom ou adresse IP du domaine d’exploitation de Visual TOM dserverPort = numéro de port du dserver gserverPort = numéro de port du gserver pserverPort = numéro de port du pserver bdaemonPort= numéro de port du bdaemon [security] file [extras] ping BaseUrl
40/46
= nom complet du fichier security.ini (..\security.ini) nom complet du script permettant de tester la présence d’une machine (unix seulement ) Url de base de la documentation et des consignes La documentation et les consignes doivent se trouver dans le répertoire BaseUrl/NomDomaine/ 91157135.doc
Visual TOM-Support de formation administrateurs
[options] FamilylnLists = 1 1 pour que la famille soit passée dans les listes, 0 sinon LastExeclnLists = 0 0 pour que la date de la dernière exécution soit passée dans les listes, 1 sinon Contenu du Ficher security.ini : Ce fichier peut être installé dans un répertoire sécurisé. Ce fichier contient la liste des utilisateurs pouvant avoir accès aux fonctionnalités de la passerelle I-server : [USER1] name password alias enable
= nom de l’utilisateur = mot de passe = alias Visual TOM = 1 actif, 0 inactif (cet utilisateur est actif par défaut)
[USER2] ……..
Sous Unix : L’ activation de la passerelle I-server s’effectue en tapant la commande suivante : nohup iserver &
Sous Windows : Le processus iserver fonctionne sous le service Windows Absyss iServer. La commande d’installation du processus iserver en tant que service Windows est la suivante : IServer –install La commande de désinstallation du processus iserver en tans que service Windows est la suivante : IServer –remove Le démarrage et l’arrêt de la passerelle I-server s’effectue en utilisant la fonction Windows : Démarrer -> paramètres -> panneau de configuration ->services
9.2 Installation du module I-Superviser Le module I-Superviser est écrit en langage Java, il faut donc, au préalable installer l’environnement JRE 1.3 (voir java.sun.com). Copiez le contenu du répertoire d’archivage du logiciel I-Superviser sur le répertoire d’installation de la machine cible . Le répertoire d’installation contiendra les fichiers suivants : isuperviser.jar (pour Unix) ou isuperviser.exe pour Windows et isuperviser.ini. Paramétrez le fichier de configuration isuperviser.ini. Ce fichier possède la structure suivante : [iserver] host = nom de la machine où est installé le module I-Server port = numéro de port d’écoute du I-server (listenPort dans le fichier iserver.ini) Copyright © ABSYSS . All rights reserved Réf. : 91157135.docdoc
41/46 04/04/12
Visual TOM-Support de formation administrateurs
user = utilisateur par défaut [interface] fullscreen = 1 si plein écran ou 0 taille normale (la valeur par défaut est 0) [options] sortByLastExec =1
1 pour le tri par dernière exécution, 0 sinon la valeur par défaut est 0
Sous Unix, le lancement du module isuperviser s’effectue de la manière suivante : java –jar isuperviser.jar isuperviser.ini Sous Windows, il suffit de lancer en mode commandes le fichier isuperviser.exe.
42/46
91157135.doc
Visual TOM-Support de formation administrateurs
10 Guide de l’utilisateur du support standard 10.1ASSISTANCE TELEPHONIQUE 10.1.1 Comment nous contacter Appeler au 01.40.84.89.01 ou [email protected] De 8 heures à 19 heures Du lundi au Vendredi
10.1.2 Avant d’appeler le support Sources d’informations à consulter. Une abondante documentation technique est mise à votre disposition : - Guides d’utilisation et d’installation en format word et HTML . - Releases notes en word. - FAQS en word et en HTML. Cette documentation est disponible sur :
- chaque CD d’installation du produit Visual Tom . - le site internet pour les FAQS sur ‘’ www.absyss.com ‘’ en cliquant sur support, l’utilisateur = nom de votre société et le password = abs ! suivi des 3 premières lettres de votre société .
10.1.3 Informations à fournir pour toute demande d’assistance technique -Votre nom. -Votre adresse -Votre numéro de téléphone -Votre numéro de fax, le cas échéant -Votre mail -Votre N° d’appel hotline si celui-ci est déjà ouvert -La machine et le système d’exploitation (OS) -La version actuelle de Visual Tom -Une description précise de l’incident Il Peut être demandé par le support : - L’envoi de fichiers (fichiers traces, dumps, test cases : un ’ test case’ est un ensemble programmes-jeu de données, permettant de reproduire l’incident de façon systématique ). - La connexion sur le site client avec un modem pour une télé-maintenance.
10.1.4 Dans quels cas appeler le support Une assistance technique peut être sollicitée dans les cas suivants : - Questions sur l’installation - Identification, résolution ou contournement d’erreurs logicielles (bogues) - Demande d’amélioration du produit . Copyright © ABSYSS . All rights reserved Réf. : 91157135.docdoc
43/46 04/04/12
Visual TOM-Support de formation administrateurs
Toute question ou tout problème soumis au support donne lieu à la création d’une ‘Demande d’Assistance Technique ‘ ( DAT ). Chaque Demande d’Assistance Technique (DAT) permet ainsi d’identifier un problème unique et de le suivre jusqu’à sa résolution : un N° d’appel (de référence) est communiqué lors de création de la demande d’assistance. Ce numéro est à rappeler lors de toute communication avec le support tehnique. Fermeture d’une DAT : Un appel est considéré comme clos lorsqu’une réponse, une solution ou un contournement mutuellement acceptable a été fourni . Un appel fermé peut être réouvert si nécessaire à condition que le problème rencontré soit le même. On peut convenir de fermer un appel après un certain délai, si aucune nouvelle n’a été donnée concernant un incident signalé. Suivi du DAT : Une synthèse mensuelle de tous vos appels ouverts vous est envoyée par courrier électronique.
10.1.5 Conditions d’accès au support Tout client ayant un contrat de maintenance peut demander une assistance technique auprès du support . Il est souhaitable que les personnes qui appellent le support technique connaissent le produit et leur environnement opérationnel.
10.2MAINTENANCE DES SYSTEMES VISUAL TOM 10.2.1 Sauvegarde et restauration Tout client doit impérativement mettre en place des procédures de sauvegarde et de restauration afin d’éviter la perte de données. Nous vous conseillons de faire régulièrement vos sauvegardes et de pratiquer des simulations de restauration afin de vous assurer des résultats. En supplément des utilitaires de vos OS, vous disposez dans la documentation Visual Tom de tous les outils de sauvegarde et de restauration.
Remarque : nous pouvons vous offrir des services, conseils pour le choix et l’élaboration d’une stratégie de sauvegarde adéquate . Ces services font l’objet d’une tarification. 10.2.2 Environnement de test L’environnement de test constitue un élément essentiel de votre système. Il permet : de tester toute modification locale proposée. Il permet d’aider à isoler des anomalies par rapport à l’environnement réel. Il permet de fournir un cadre pour l’élaboration de scénarios de tests reproductibles. 44/46
91157135.doc
Visual TOM-Support de formation administrateurs
Il permet de tester de nouvelles versions. Il permet de tester vos stratégies de sauvegardes et de restauration. Bien qu’il ne soit évidemment pas toujours possible de reproduire ,dans votre environnement de test, les volumes de données ou les transactions de votre environnement réel, il n’en demeure pas moins qu’un environnement de test permet de minimiser l’impact des changements sur votre environnement réel.
10.2.3 Gestion de vos espaces Vous devez vous assurer en permanence que les machines ‘ client‘ et ‘ serveur’ disposent d’un espace suffisant pour le système de fichiers, notamment pour les répertoires de trace.
10.2.4 Installation de version Avant de réaliser votre installation, nous vous conseillons : - d’obtenir la dernière version - de lire toute la documentation. Nous vous rappelons que la documentation est disponible sur le CD et sur internet. - de vérifier tous les pré-requis logiciels et matériels. - de valider votre environnement de test avant l’installation réelle de la production.
Copyright © ABSYSS . All rights reserved Réf. : 91157135.docdoc
45/46 04/04/12