Manuel Formation Administrateur

Net job scheduler

Visual TOM Formation Administrateurs

The job scheduling company

Visual TOM-Support de formation administrateurs

SOMMAIRE

1 PRSENTATION................................................................................................................................4 1.1 VISUAL TOM SERVEURS (RFRENTIEL, ORDONNANCEUR)...............................................................................4 1.2 VISUAL TOM XVISION VT-XVI (CONCEPTION, PILOTAGE)...............................................................................4 1.3 VISUAL TOM CLIENTS (EXCUTION DES TCHES SUR UNE MACHINE)...................................................................5 1.4 VISUAL TOM MODULES OPTIONNELS............................................................................................................5 2 ARCHITECTURE TECHNIQUE..........................................................................................................6 3 INSTALLATION DES MODULES DE BASE.......................................................................................8 3.1 INSTALLATION SOUS UNIX............................................................................................................................8 3.1.1 Prparatifs..................................................................................................................................8 3.1.2 Transfert du package logiciel......................................................................................................8 3.1.3 Le fichier de configuration de l'installation : install_vtom.ini.........................................................9 3.1.4 Droulement de la procdure dinstallation..................................................................................9 3.1.5 Validation de linstallation..........................................................................................................10 3.2 INSTALLATION SOUS WINDOWS NT.............................................................................................................13 3.2.1 Dsinstallation..........................................................................................................................13 3.2.2 Conventions..............................................................................................................................13 3.2.3 Paramtres de linstallation.......................................................................................................13 3.2.4 Droulement de la procdure dinstallation................................................................................15 3.2.5 Validation de linstallation..........................................................................................................15 4 CONFIGURATION DU SERVEUR VISUAL TOM..............................................................................17 4.1 LES PORTS DE COMMUNICATION DU SERVEUR VISUAL TOM..............................................................................17 4.2 LES VARIABLES DENVIRONNEMENT DE LADMINISTRATEUR DE VISUAL TOM POUR UN SERVEUR UNIX.........................17 4.3 LES VARIABLES DENVIRONNEMENT POUR UN SERVEUR WINDOWS......................................................................18 4.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................18 4.5 PARAMTRAGE DE LA PROCDURE DE COMMUNICATION DES MOTEURS AVEC LES CLIENTS.........................................19 4.6 LA MISE EN PLACE DES TRACES DES MOTEURS...............................................................................................20 4.7 PRODUCTION DE TABLEAUX DE BORDS DES JOURNES DEXPLOITATION PRCDENTES.............................................21 4.8 LHISTORIQUE.........................................................................................................................................21 5 LES COMMANDES DUN MODULE SERVEUR...............................................................................22 5.1 SAUVEGARDE ET RESTAURATION DUNE BASE.................................................................................................22 5.1.1 Sauvegarde du rpertoire de la base de donnes.....................................................................22 5.1.2 Liste le contenu de la base dans un fichier texte.......................................................................22 5.1.3 Import des objets dfinis dans un fichier texte...........................................................................22 5.2 LA GESTION DES MOTEURS........................................................................................................................23 5.2.1 Dmarrage dun moteur sur un Environnement.........................................................................23 5.2.2 Arrt dun moteur sur un Environnement...................................................................................23 5.2.3 Remise OFF du flag moteur de linterface graphique pour un environnement.........................23 5.2.4 Test de prsence dun moteur actif pour un environnement......................................................23 5.2.5 Vrification des blocages de date..............................................................................................23 6 CONFIGURATION DU CLIENT VISUAL TOM..................................................................................24 6.1 LES PORTS DE COMMUNICATION UTILISS PAR UN CLIENT..................................................................................24 6.2 LES VARIABLES DENVIRONNEMENT DE LADMINISTRATEUR DU CLIENT VISUAL TOM SOUS UNIX.................................24 6.3 LES VARIABLES DENVIRONNEMENT WINDOWS DUN CLIENT VISUAL TOM............................................................25 6.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................25 6.5 LES QUEUE BATCH...................................................................................................................................262/46 91157135.doc

Copyright ABSYSS. All rights reserved04/04/12

Visual TOM Support de formation administrateurs 6.5.1 Configuration dune queue batch sous un client Unix................................................................26 6.5.2 Configuration dune queue batch sous un client Windows.........................................................27 6.6 LES SUBMITTER......................................................................................................................................27 6.7 GESTION DES LOGS.................................................................................................................................28 7 CONFIGURATION DUNE IHM VISUAL TOM..................................................................................30 7.1 LES PORTS DE COMMUNICATION UTILISS PAR UNE IHM...................................................................................30 7.2 LES VARIABLES DENVIRONNEMENT DE LADMINISTRATEUR DE LIHM SOUS UNIX...................................................31 7.3 LES VARIABLES DENVIRONNEMENT SYSTME WINDOWS DUNE IHM....................................................................31 7.4 LE FICHIER DE CONFIGURATION VTOM.INI.......................................................................................................31 7.5 MISE EN PLACE DES FONCTIONNALITS DOCUMENTATION ET CONSIGNES..............................................................32 8 CONCEPTION ET PILOTAGE DE LA PRODUCTION EN MODE COMMANDE...............................34 8.1.1 Ajout ou modification dobjets dans le domaine dexploitation....................................................34 8.2 AJOUT ET MODIFICATION DUNE APPLICATION..................................................................................................35 8.3 AJOUT OU MODIFICATION D'UN TRAITEMENT....................................................................................................37 8.4 SUPPRESSION D'UN TRAITEMENT.................................................................................................................39 8.5 SUPPRESSION DUN LIEN...........................................................................................................................39 9 INSTALLATION DES MODULES ISUPERVISER ............................................................................40 9.1 INSTALLATION DE LA PASSERELLE I-SERVER...................................................................................................40 9.2 INSTALLATION DU MODULE I-SUPERVISER......................................................................................................41 10 GUIDE DE LUTILISATEUR DU SUPPORT STANDARD...............................................................43 10.1 ASSISTANCE TELEPHONIQUE.....................................................................................................43 10.1.1 Comment nous contacter........................................................................................................43 10.1.2 Avant dappeler le support.......................................................................................................43 10.1.3 Informations fournir pour toute demande dassistance technique..........................................43 10.1.4 Dans quels cas appeler le support..........................................................................................43 10.1.5 Conditions daccs au support................................................................................................44 10.2 MAINTENANCE DES SYSTEMES VISUAL TOM...........................................................................44 10.2.1 Sauvegarde et restauration ....................................................................................................44 10.2.2 Environnement de test ...........................................................................................................44 10.2.3 Gestion de vos espaces .........................................................................................................45 10.2.4 Installation de version ............................................................................................................45


91157135.doc

3/46


1 PrsentationLes modules Visual TOM sont classes en quatre familles de modules

1.1 Visual TOM Serveurs (Rfrentiel, Ordonnanceur). Visual TOM Enterprise Server (VT-SES) Visual TOM Enterprise Server est llment de base de toute architecture. Il inclut le rfrentiel de production, les outils de conception du rfrentiel, le pilotage de lexploitation, le systme expert de planification et dordonnancement, les APIs et la documentation on-line. Il peut tre install indiffremment sur des machines UNIX ou Windows NT. Visual TOM Departmental Server (VT-SDS) Le serveur departemental gre l'autonomie des sites distants. Il rpartit la charge dans une architecture distribue. Il ncessite la prsence dun module Enterprise Server. Il peut tre install indiffremment sur des machines UNIX ou NT. Visual TOM Back Up Server (VT-SBU) Le serveur BACKUP relaye automatiquement un serveur Visual TOM en cas dincident. Ce module est systmatiquement mis en place dans les productions ncessitant un niveau de scurit optimal. Il peut tre install indiffremment sur des machines UNIX ou NT.

1.2 Visual TOM XVision VT-XVI (Conception, Pilotage) Visual TOM IHM Cest une interface graphique groupware dporte sur un LAN ou un Wan, connect tout type de serveur Visual TOM (y compris les NetClients) Elle permet la modlisation, la gestion et le pilotage de la production multi platesformes UNIX et Windows NT/95. Visual TOM I-Superviser Cest un ensemble de fonctionnalits permettant de suivre le droulement d'une production gre par Visual TOM. Cette fonctionnalit a t tudie pour permettre le suivi de la production via un rseau bas dbit (RTC, Internet). Visual TOM WebDoc Cest une Interface internet permettant de visualiser les caractristiques des objets de vos domaines dexploitation Visual TOM : (ressources, calendriers, environnements, applications, traitements ..)

4/46

91157135.doc


Visual TOM Support de formation administrateurs

1.3 Visual TOM Clients (Excution des tches sur une machine) Visual TOM Client (VT-CS) Cest un client Visual TOM permettant la production informatique en architecture Client/Serveur. Ces modules dpendent dun Visual TOM serveur; ils reoivent les ordres de soumission en provenance de ceux-ci et excutent les traitements batch. (exemple. : Excution dune tche sur une machine). Il peut tre install indiffremment sur des machines UNIX ou NT, VAX/VMS, Open VMS, AS400, GCOS7 et GCOS8. Visual TOM Net Client (VT-CN) Cest un client Visual TOM qui possde en local son propre rfrentiel de production, lui garantissant lautonomie de fonctionnement. Il peut tre install indiffremment sur UNIX ou NT.

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


91157135.doc

5/46


2 Architecture technique

A rchitecture techniqueTcp/ipTengineV tom serveur V T-S D S V T-S E S V tom backup serveur V T-S B U V tom client V T-C Stom D B d gw d ntfy

G estion rfrentiel de productio

Rplication en temps rel

d server g server p server d server g server p server

G estion graphique

G estion des vnem entstom D B d gw d ntfy

tom D Bd bdaem on

bdaem on S oum ission des batchs

vto m

tom D B d

Q ueues batchsQ ueueksh Q ueue S A P A ffichage S cript batch et log

V tom V T-X V IS IO NMrTOM

gw d ntfy

Visual TOM possde une architecture de type Client/Serveur base sur le protocole de communication TCP/IP. La communication avec le module serveur Visual TOM seffectue laide de trois processus. Le processus dserver gre la base de donnes de la production . Ce processus utilise le port de communication TCP tomDBd. Le processus gserver gre les mises jour graphiques sur toutes les IHM connectes via le port TCP gwd.6/46 91157135.doc



Le processus pserver reoit, via le port TCP ntfy, les notifications de modifications de la base de donnes. Le processus vtlserver gre la procdure de gestion des licences La communication avec le module client seffectue laide du processus bdaemon ; ce processus utilise le port TCP bdaemon. Le processus vtom permet de lancer linterface graphique Le tableau suivant fournit la liste valeurs par dfaut des ports TCP utiliss par Visual TOM.

tomdbd gwd ntfy bdaemon vtlicense

20001/tcp 20002/tcp 20003/tcp 20004/tcp 20006/tcp

NB : ces numros de ports ne sont que des propositions. Il est possible de prendre nimporte quel numro de port non utilis, mais pour la communication entre les diffrentes machines, il est impratif que ces ports soient dfinis de la mme manire sur chacune des machines. Si les services de votre systme Unix sont administrs par un serveur NIS, il sera ncessaire de les mettre jour sur la machine serveur NIS s'ils ne sont pas prsents.


91157135.doc

7/46


3 Installation des modules de baseLes modules de base de Visual TOM sont : le module Serveur le module Client le module IHM

3.1 Installation sous Unix3.1.1 PrparatifsPour installer Visual TOM, il est ncessaire davoir un compte utilisateur qui sera administrateur de Visual TOM. Par dfaut on utilise le compte vtom, mais il est possible de prendre nimporte quel autre utilisateur du systme dexploitation. Visual TOM est fourni avec des procdures dadministration en c-shell, tc-shell, bourne shell ou korn shell, ainsi lutilisateur qui administrera Visual TOM pourra fonctionner indiffremment avec l'un de ces quatre shells. Attention, pour linstallation de Visual TOM sur plusieurs machines (ex : 1 machine serveur et deux clients distants), si lutilisateur dadministration est le mme, il doit avoir le mme uid et gid sur toutes les machines. Le mot de passe de root sera galement ncessaire pour installer Visual TOM.

3.1.2 Transfert du package logicielA partir du CDROM, slectionnez le rpertoire correspondant votre systme dexploitation : AIX ou HPUX ou SOLARIS, Puis, slectionnez 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 VT-SES VT-SDS VT-SBU VT-CS VT-CSL VT-CN VT-CNL VT-XVI

Pack Serveur

Pack IHM

Pack Client

Copiez du CD-ROM vers le rpertoire temporaire dinstallation les fichiers ncessaires pour linstallation. Ces fichiers sont : install_vtom script d'installation install_vtom.ini fichier de configuration de linstallation module pour l'installation Pour la copie des fichiers ncessaires linstallation, il est recommand dutiliser un systme Windows, disposant dun lecteur CD-ROM, et de transfrer les fichiers par FTP. Les modes de transfert des fichiers sont les suivants :8/46 91157135.doc



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 dune installation dun module serveur. Ce fichier vous est fourni par le service support dAbsyss et doit tre copi dans le sous-rpertoire bin du rpertoire dinstallation du module Serveur de Visual TOM (cf paragraphe rpertoires dinstallation /vtom/bin).

3.1.3 Le fichier de configuration de l'installation : install_vtom.iniPour dfinir les paramtres de votre installation de Visual TOM, vous pouvez lancer directement le script d'installation. Il est cependant possible de paramtrer le fichier de configuration install_vtom.ini, qui contient les paramtres par dfaut (ex: installation de plusieurs clients Visual TOM avec les mmes paramtres).

3.1.4 Droulement de la procdure dinstallation 3.1.4.1 Lancement du script dinstallationDans le rpertoire dinstallation temporaire o vous avez extrait les fichiers, sous l'utilisateur root, vrifiez que le fichier install_vtom est en mode excutable, 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 linstallation termine il faut copier le fichier license.lic dans le sous rpertoire bin du rpertoire dinstallation du pack serveur (../vtom/bin).

3.1.4.2 Confirmation des paramtres dinstallationAprs initialisation (lecture du fichier install_vtom.ini), les paramtres de l'installation vous sont proposs. - Type d'installation : client, serveur, IHM (seuls les packs installer sont affichs) - Solution serveur de backup : si vous disposez de cette solution, ses paramtres sont affichs - Administrateur Visual TOM - Rpertoire de base de l'installation : sous lequel seront installes les rpertoires admin, abm (pack client), vtom (pack serveur) et visual (pack IHM). - Autres rpertoires utiliss par Visual TOM (il est possible de les dfinir indpendamment du rpertoire d'installation). - Navigateur HTML si dfini. Si les paramtres de l'installation vous satisfont, validez, sinon tapez n puis Entre.

3.1.4.3 Redfinition des paramtres dinstallationPour chacun des choix qui vous seront proposs, validez pour accepter le choix. Entrez la nouvelle valeur suivie d'Entre pour le redfinir. - Pack d'installation - Solution serveur de backup : nom du serveur primaire ou de backup - Rpertoire de base de l'installation - Administrateur de Visual TOMCopyright ABSYSS. All rights reserved04/04/12 91157135.doc 9/46


-

Navigateur HTML Rpertoire de la base de donnes Rpertoire de backup de la base de donnes Rpertoire des fichiers statistiques Rpertoire des traces du moteur Rpertoire des fichiers logs

3.1.4.4 Sauvegarde d'une installation prcdenteDans le cas o vous installez Visual TOM sur une installation existante, la base de donnes est toujours conserve, les anciens rpertoires admin et abm/config sont renomms en admin.old et abm/config.old, ce qui vous permet de conserver le paramtrage de la prcdente installation. De plus, si vous avez choisi de sauvegarder l'installation prcdente, tous les autres rpertoires seront conservs (renomms en .old).

3.1.4.5 Gnration des fichiers de configuration :vtom_init.[shell] Il existe quatre fichiers dinitialisation vtom_init pour les shells sh, ksh, csh et tcsh. Ces fichiers sont gnrs lors de linstallation et contiennent les dfinitions des diffrentes variables denvironnement utiles Visual TOM. .vtom.ini Le fichier .vtom.ini contient des paramtres de Visual TOM. Il est install dans le rpertoire dadministration. Un lien est fait sur le home directory de ladministrateur 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, intgrs la procdure de boot systme, permettent de lancer Visual TOM client ou serveur lors du dmarrage de la machine. fichier services.new Ce fichier contient les noms et numros de services TCP utiliss par Visual TOM. Le contenu de ce fichier doit tre insr dans le fichier /etc/services.

3.1.4.6 Rpertoires temporaires et script de dsinstallationLors de l'installation, tous les fichiers et rpertoires sont supprims (cas d'une rinstallation) et sont temporairement transfrs dans le rpertoire install_vtom.tmp. De plus, un script de dsinstallation est gnr : uninstall_vtom. Ce script permet de revenir la situation de dpart (avant l'installation) en cas de problme lors du droulement de l'installation. Ce rpertoire temporaire et le script de dsinstallation sont normalement supprims 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 allous pour cette opration).

3.1.4.7 Journal d'installationVous trouverez la trace de cette installation de Visual TOM dans le fichier install_vtom.log.

3.1.5 Validation de linstallationAttention : Si on utilise exceed pour lancer xvision x11, dans la configuration exceed, au niveau de la dfinition de l'cran, le paramtre "use native WM for embedded client" doit tre dcoch.si ce paramtre est coch " tort", cela peut provoquer des plantages sur xvision.10/46 91157135.doc



3.1.5.1 Accs Visual TOM Connexion sous lutilisateur dadministration Visual TOMConnectez vous sous lutilisateur dadministration Visual TOM dfini lors de linstallation afin de disposer des variables denvironnement Visual TOM.

Appel du menu adminsLancez le menu dadministration Visual TOM par la commande admins : > admins

Dmarrage des serveursDans le menu admins, choisissez loption 2 - Dmarrage des serveurs.

Lancement de linterface graphiqueDans le menu admins, choisissez loption Visual TOM. La fentre de login Visual TOM apparat.

Connexion Visual TOMUn utilisateur Visual TOM est dfini par dfaut : Utilisateur TOM Mot de passe TOM Domaine =

3.1.5.2 Mise jour de la base de donnes de testUne base de donnes par dfaut est gnre lors de linstallation. Il est ncessaire de la modifier pour tenir compte des paramtres tels que le nom de la machine ou celui de lutilisateur dadministration vtom.

UtilisateurAvec le menu Domaine Exploitation / Utilisateurs, appelez la fentre de dfinition des utilisateurs. Cliquez sur Nouveau et saisissez le nom de votre administrateur Visual TOM.

MachineAvec le menu Domaine Exploitation / Machines, appelez la fentre de dfinition des machines. Slectionnez default_machine, cliquez sur Modifier, et remplacez ce nom par celui de votre serveur Visual TOM.

DateAvec le menu Domaine Exploitation / Dates, appelez la fentre de dfinition des Dates d'exploitation. Slectionnez date_exp et cliquez sur Modifier. La fentre de dfinition de la date apparat. Cliquez sur systme puis sur automatique pour la mettre jour.

Rpertoires des scripts et des traces moteurAvec le menu Domaine Exploitation / Environnements, appelez la fentre de dfinition des environnements. Slectionnez lenvironnement exploitation et Cliquez sur Modifier. La fentre de dfinition de lenvironnement apparat. Modifiez les champs Rpertoire des Scripts et Rpertoire des traces moteur en remplaant {Rep_local}/Visual_TOM par le rpertoire dinstallation.


91157135.doc

11/46


3.1.5.3 Validation du bon fonctionnement de la partie serveur de Visual TOMCe paragraphe explique comment faire fonctionner la base de donnes de test en mode simulation. Lexcution des scripts en mode simulation permet de valider le bon fonctionnement de la partie serveur (planification et ordonnancement) de Visual TOM.

Appel du pilote graphiqueSlectionnez la fonction Pilote Graphique du menu Pilote. La fentre du pilote graphique de lenvironnement exploitation apparat. Vous tes dans le graphe des applications. Pour visualiser les traitements, cliquez deux fois sur lapplication. Les jobs sont tous A VENIR (couleur jaune).

Lancement du moteur (tengine)Dmarrez le tengine en cliquant sur licne OFF, confirmez en validant. Les trois jobs doivent excuter successivement, cest dire passer de ltat A VENIR (jaune) ltat EN COURS (bleu) puis ltat TERMINE (vert).

3.1.5.4 Validation du bon fonctionnement du clientCe paragraphe nous explique comment excuter les traitements et consulter leur fichier log.

Modification du mode dexcution des traitementsSlectionnez la fentre du graphe des applications (si vous tes dans le graphe des traitements cliquez sur la flche en haut droite). Cliquez sur lapplication test avec le bouton gauche de la souris et slectionnez Dfinition, la fentre de dfinition de lapplication saffiche. Dans le champ Mode dExcution, slectionnez excution et validez.

Lancement du dmon client : bdaemon.Retournez la fentre UNIX o vous avez lanc le menu admins. Choisissez loption Gestion du client, puis dmarrage.

Lancement de lexcution des traitementsSlectionnez la fentre du pilote graphique au niveau du graphe des applications. Cliquez sur lapplication test avec le bouton droit de la souris, choisissez le menu Actions, puis forcer A VENIR. Basculez sur la fentre du pilote graphique au niveau du graphe des traitements (si vous avez ferm cette fentre, cliquez deux fois sur lapplication). Les traitements sont tous passs A VENIR et vont sexcuter les uns aprs les autres.

Visualisation du fichier logCliquez deux fois sur un des traitements. La Liste des logs pour ce traitement saffiche. Cliquez deux fois sur le traitement, puis choisissez sortie standard.

3.1.5.5 Repartir dune base de donnes viergeUne fois valide votre installation, vous pouvez repartir d'une base de donnes vierge. Pour cela, arrtez Visual TOM (moteur, IHM et serveurs) et effacez le contenu du rpertoire de la base de donnes : Sous Unix : cd $TOM_BASES rm -r * Au redmarrage des serveurs, la base de donnes sera recre vierge.

12/46

91157135.doc



3.2 Installation sous Windows NTLinstallation dun module Serveur ou dun mode Client doit se faire dans une session dun compte administrateur local. Remarque : Linstallation dune application laide dun outil comme TSE ncessite lutilisation de la fonction Windows Ajout /Suppression dun programme

3.2.1 DsinstallationDans le cas dune rinstallation, il est ncessaire deffectuer une dsinstallation de Visual TOM. Pour dsinstaller Visual TOM, il faut arrter tous les process de Visual TOM : - Les moteurs (processus tengine) - Linterface graphique (processus vtom) - Les services (processus dserver, gserver, pserver, vtlserver et bdaemon) Lorsque Visual TOM est inactif (services et moteurs arrts), vous pouvez lancer le programme de dsinstallation automatique. Pour cela utilisez la fonction Windows Dmarrer\Panneau de configuration/Ajout/suppression de programmes Certains rpertoires ne sont pas supprims aprs la dsinstallation : - Le fichier vtom.ini dans le rpertoire %windir% qui contient des paramtres de configuration. Ce fichier sera copi sous vtom.old lors d'une nouvelle installation et pourra donc tre rutilis. - Les services TCP de Visual TOM dans le fichier %windir%\system32\drivers\etc\services ; ils seront les ports par dfaut lors de la prochaine installation (mais pourront tre modifis). - Les rpertoires modifis aprs l'installation (ex: la base de donnes) qui pourront tre conservs, ou tre limins par le gestionnaire de fichiers. Dans le cas dune rinstallation sur de nouveaux rpertoires, il faudra alors supprimer les variables denvironnement systme telles que : ABM\BIN, ABM_LOG, TOM_BIN, TOM_STATS, TOMSTATS, ND_PATH.

3.2.2 ConventionsLors de l'installation des fentres apparaissent pour confirmer les paramtres de l'installation. Ces fentres contiennent les boutons suivants: - Back / prcdent : revient l'cran prcdent - Next / suivant : valide les paramtres l'cran - Browse / Parcourir : slection d'un fichier ou d'un rpertoire - Cancel / Annuler : quitte la procdure d'installation

3.2.3 Paramtres de linstallationIl est possible d'installer un des quatre packages suivants:

1. Client / Serveur /IHM 2. Client 3. X-VISION

= VT-SES-WNT ou VT-SDS-WNT = VT-CS-WNT = VT-XVI-WNT


91157135.doc

13/46


ATTENTION : Un paramtre dinstallation commun aux quatre packages est le rpertoire de destination (base d'installation de Visual TOM). Il ne faut pas choisir un nom de rpertoire de destination compos de plusieurs mots spars par des espaces comme Program Files .

3.2.3.1 Pack Serveur : Client /Serveur /IHMCe pack permet l'utilisation complte de Visual TOM. Paramtres dinstallation dfinir : - rpertoire de destination (base d'installation de Visual TOM) - rpertoire de la base de donnes - rpertoire des logs (o seront archivs les traces d'excution des jobs) - rpertoire des statistiques (o seront stocks les fichiers d'analyse)

3.2.3.2 Pack X-VisionCe pack permet linstallation de lIHM, du Isuperviser et du Webdoc. Les modes opratoires dinstallation des modules ISuperviser Webdoc sont dcrits dans le chapitre Installation des modules Isuperviser et Webdoc . Paramtres dinstallation de lIHM dfinir: - rpertoire 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 ClientCe pack permet l'excution de traitements dclenchs par un serveur Visual TOM distant. Les paramtres dinstallation dfinir sont : rpertoire de destination (base d'installation de Visual TOM) et rpertoire des logs (o seront archives les traces d'excution des jobs).

14/46

91157135.doc



3.2.4 Droulement de la procdure dinstallation 3.2.4.1 Lancement de linstallationPour lancer linstallation 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 dinstallation dun pack serveur :

A la fin de linstallation, on vous propose dditer le compte-rendu dinstallation contenu dans le fichier Readme.txt situ dans le rpertoire dinstallation. Pour terminer linstallation de Visual TOM, il est ncessaire - de copier le fichier license.lic dans le sous rpertoire bin du rpertoire dinstallation du pack serveur (..\vtom\bin). - et de redmarrer la machine.

3.2.4.2 Cration de Groupes de programmes Visual TOMLors de l'installation, un groupe de programmes Visual TOM a t cr. Ce groupe de programme est accessible par le menu Dmarrer (Start) Il contient les icnes suivantes: - IHM Visual TOM TOM - ReadMe - Arrt des serveurs - Dmarrage serveurs - Fichier Vtom.ini Lancement de l'interface graphique de Visual Lecture du rapport dinstallation Arrt des services Visual TOM Dmarrage des services Visual TOM Fichier de configuration de Visual TOM

3.2.5 Validation de linstallation 3.2.5.1 Dmarrage/ Arrt des services Visual TOMLors de linstallation dun pack serveur ou un pack client des services Windows sont crs.Copyright ABSYSS. All rights reserved04/04/12 91157135.doc 15/46


Pour un pack serveur les services suivants sont crs : - AbsyssGestionGraphique gre tous les vnements graphiques - AbsyssOrdonnanceur gre tous les accs la base de donnes - AbsyssNotificateur gre les notification d'vnements graphiques aux autres IHM connects - AbsyssLicense gre le fichier de licences Pour un pack client, un seul service est cr : - AbsyssBatchManager gre le lancement des jobs

Les services peuvent tre grs par l'intermdiaire du panneau services du panneau de configuration: Dmarrer / Panneau de Configuration / Services Les services de Visual TOM sont configurs pour dmarrer automatiquement lors du dmarrage de la machine. Il est possible de dsactiver cette option via le bouton Dmarrage dans la fentre des Services.

3.2.5.2 Accs Visual TOMPour accder Visual TOM, il suffit de lancer lexcutable de lancement de linterface graphique vtom.exe dans le rpertoire visual. Vous pouvez aussi dmarrer linterface graphique par le menu Dmarrer\programmes\Visual TOM\IHM Visual TOM. Crez un environnement de test et validez linstallation.

16/46

91157135.doc



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

4.1 Les ports de communication du serveur Visual TOMLes numros de ports de communication doivent tre dfinies dans le fichier /etc/services pour un systme Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un systme Windows NT. Pour un systme Unix, les dfinitions des numros de ports doivent tre faites manuellement la fin de linstallation du serveur. Pour un systme Windows, les dfinitions des numros de port sont faites automatiquement au cours de la phase dinstallation. Ces numros de communication doivent avoir des valeurs identiques sur toutes les machines utilisant Visual TOM . Les valeurs par dfaut de ces ports de communication sont les suivantes : tomDBd 20001 gwd 20002 ntfy 20003 bdaemon 20004 vtlicense 20005

4.2 Les variables denvironnement de ladministrateur de Visual TOM pour un serveur UnixLes variables denvironnement de ladministrateur du serveur de Visual TOM sont dfinies dans le fichier vtom_init.[$SHELL]. La valeur de la variable $SHELL indique le type de shell associ ladministrateur du serveur de Visual TOM : ksh pour korn shell, Les valeurs de ces variables denvironnement sont positionnes lors de louverture dune session par ladministrateur de Visual TOM et elles sont utilises par les diffrents processus de Visual TOM ; par exemple la variable $TOM_BASES qui contient le nom du rpertoire de la base de donnes de Visual TOM est utilise comme argument lors du lancement des processus dserver, pserver et gserver. Le fichier vtom_init.[$SHELL] est gnr automatiquement dans le sous-rpertoire $TOM_ADMIN lors de linstallation du module serveur de Visual TOM, et il est intgr au fichier .profile de ladministrateur de Visual TOM.


91157135.doc

17/46


Ci dessous un tableau qui donne la liste des variables denvironnement utilises 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 Gnrales Nom de la machine Rpertoire dinstallation de Visual TOM Rpertoire des scripts dadministration Administrateur Visual TOM Serveur Rpertoire de la partie serveur Rpertoire de backup des bases Rpertoire de la base de donnes Visual TOM Rpertoire des excutables serveur Rpertoire des statiques Rpertoire des traces moteur et serveurs Le path comprend le rpertoire vtom/bin

4.3 Les variables denvironnement pour un serveur WindowsLes variables d'environnement cres lors de linstallation dun serveur Visual TOM Windows NT sont les suivantes : TOM_BIN = rpertoire des excutables du serveur Visual TOM TOM_STATS = Rpertoire des statiques TOMSTATS = Rpertoire des statiques

Le rpertoire contenant la base de donnes du serveur Visual TOM est dfini dans le fichier vtom.ini : [GLOBALES] bases=e:\vtom\bases Rpertoire de la base de donnes

La visualisation des valeurs des variables denvironnement systme de Windows se fait laide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement.

4.4 Le fichier de configuration vtom.iniSous Unix, ce fichier est gnr dans rpertoire $TOM_ADMIN lors de linstallation du serveur; cest un fichier cach .vtom.ini. Sous Windows, ce fichier est gnr au cours de la phase dinstallation du serveur dans le rpertoire %windir%V. La structure de ce fichier est organise en sections.

18/46

91157135.doc



4.5 Paramtrage de la procdure de communication des moteurs avec les clients.Les paramtres mettre en place doivent tre intgres dans la section [general] pour Unix et dans section [GLOBALES] pour Windows. Sous Unix, [general] delaiWait:30 Dlai d'attente "en secondes" d'une rponse dun client suite une demande de soumission dun traitement ou une demande sur ltat dexcution dun traitement delaiRetry:60 Dlai dattente "en secondes" avant une nouvelle tentative de contact avec un client qui na pas rpondu une demande nbWaitRetry:10 Nombre de tentatives de contact avec un client avant la modification du statut dun traitement StatusFailSubmit:ENCOURSNouveau statut d'un traitement qui n'a pas pu tre soumis un client StatusFailExist:ENCOURS contact Nouveau statut d'un traitement dont on a perdu le


91157135.doc

19/46


4.6 La mise en place des traces des moteursLa mise en place des traces moteurs de Visual-Tom seffectue 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 manire 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 paramtres ont la signification suivante : nom_environnement1=1 nom_environnementX=1 Directory= Filesize= X Filecount= N (permet de prciser les noms des environnements pour lesquel la trace moteur sera active, ainsi que leur niveau de trace respectifs, 1 tant conseill par dfaut) (Indique le rpertoire destination o seront gnres les traces) (Indique la taille en Mo de chacun des fichiers traces) (Permet une rotation dcriture des traces sur N fichiers + 1 fichier par dfaut)

ATTENTION, il faut sassurer que le rpertoire dfinit par Directory, possde lespace disque suffisant pour hberger lensemble des fichiers traces, savoir : (Filecount +1) x Filesize x Nombre denvironnements dclars dans la section [engine_trace] A NOTER, le paramtrage des traces moteurs est pris en compte dynamiquement et ne ncessite aucun arrt/relance de processus.

20/46

91157135.doc



4.7

Production de tableaux de bords des journes dexploitation prcdentes

Au cours de son activit quotidienne, les moteurs de Visual TOM alimentent la table de la base de donnes stats.dbf, appele fichier des statistiques. Les fonctions danalyse de traitements ou des statistiques permettent de produire les tableaux de bord de lexploitation ralise (cf les menus de linterface graphique Analyse\Analyse des traitements ou Statistiques). Ces tableaux de bord sont gnrs partir du fichier des statistiques stats.dbf. Attention : le fichier stats.dbf nest pas purg automatiquement par Visual TOM ; ce qui peut provoquer un ralentissement de lactivit des processus du serveur. La commande vtstools gre lexport ou la purge dune partie ou de la totalit du fichier stasts.dbf. Sous Unix, la fonction dalimentation du fichier des statistiques est active par dfaut, par contre sous Windows, il faut mettre la valeur du paramtre stats 1 pour que cette fonction soit active ou mettre la valeur 0 pour inhiber cette fonction. Le paramtre stats se trouve dans le fichier vtom.ini.

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

4.8 LhistoriqueCette fonction permet de consulter lhistorique des actions effectues sur les objets du domaine dexploitation. Cette fonction est active que lorsque le paramtre histo est positionn 1 dans le fichier de configuration de Visual TOM. Sous Unix, il faut dclarer ce paramtre dans la general . [general] histo :1 pour activer la fonction historique [GLOBALES] histo=1 pour activer la fonction historique De la mme manire que pour les statistiques, les moteurs de Visual TOM alimentent la table de la base de donnes histo.dbf . La fonction historique permet de gnrer un tableau rcapitulant toutes les actions effectues sur les objets du domaine dexploitation. (cf le menu de linterface graphique \historique). Ce tableau est gnr partir du fichier de lhistorique histo.dbf. Attention : le fichier histo.dbf nest pas purg automatiquement par Visual TOM ; ce qui peut provoquer un ralentissement de lactivit des processus du serveur. La commande vthtools gre lexport ou la purge dune partie ou de la totalit du fichier histo.dbf.


91157135.doc

21/46


5 Les commandes dun module serveur5.1 Sauvegarde et restauration dune baseOn peut sauvegarder une base de production en utilisant : - la commande tbackup - ou la commande texport

5.1.1 Sauvegarde du rpertoire de la base de donnestbackup /target= Cet outil de sauvegarde de la base de donnes fonctionne en client/serveur, c'est--dire que l'on peut raliser une sauvegarde de la base depuis une autre machine en positionnant la variable TOM_REMOTE_SERVER avec le nom de la machine sur laquelle on veut faire la sauvegarde de la base de donnes Visual TOM. Sous le rpertoire dfini par le path_de_sauvegarde est cr un rpertoire qui correspond la JJMMAA-HHMMSS sous lequel l'ensemble des fichiers de la base de donnes est sauvegard. Pour restaurer une base, Il faut dans un premier temps arrter tous les process Vtom puis copier la base sauvegarde puis relancer les services Vtom et lIHM.

5.1.2 Liste le contenu de la base dans un fichier textetexport > nom_fichier (base) Options : texport env/app/job > nom_fichier

Liste le contenu de la base de donnes dans un fichier ASCII (cf. Les tableaux comparatifs des options des commandes taddjob et taddapp et leurs formats au mode import/export). Il est possible d'exporter tout le contenu de la base (comportement par dfaut) ou de slectionner un environnement, une application ou un traitement. Le fichier gnr peut tre modifi (en tenant compte des rgles syntaxiques) avant d'tre import dans une autre base de donnes (ou dans la mme base de donnes).

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

Attention, pour les valeurs par dfaut, on rcupre les valeurs par dfaut de la nouvelle base de donnes (environnement ou applications).

22/46

91157135.doc



5.2 La gestion des moteurs5.2.1 Dmarrage dun moteur sur un Environnementestart nom_environnement] Dmarre le moteur de Visual TOM pour lenvironnement nom_environnement

5.2.2 Arrt dun moteur sur un Environnementestop nom_environnement Demande larrt du moteur Visual TOM pour lenvironnement [nom_environnement]. Messages de retour possibles: environnement non trouve lenvironnement a t trouv, mais le moteur nest pas actif arret du moteur demande lenvironnement a t trouv, mais le moteur nest pas actif

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

5.2.4 Test de prsence dun moteur actif pour un environnementepresent nom_environnement Signale si un Moteur est actif pour lenvironnement [nom_environnement]

5.2.5 Vrification des blocages de datePour UNIX : Pour NT : tchkdate /nom=date [/env=env] idem


91157135.doc

23/46


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

6.1 Les ports de communication utiliss par un clientEn dehors du port bdaemon, un seul port de communication est utilis par un client Visual TOM. Cest le port tomDBd du processus dserver du module serveur. La valeur par dfaut de ce port est 20001 et elle est dfinie dans le fichier /etc/services pour un systme Unix ou dans le fichier %windir%\systtem32\drivers\etc\services pour un systme Windows NT. Cette valeur est mise jour automatiquement lors de linstallation dun client Windows NT, par contre, sur un systme Unix, la mise jour de la valeur du port tomDBd doit tre faite manuellement. Pour tester ltat de la communication dun client vers un serveur, il suffit de positionner la valeur de la variable denvironnement TOM_REMOTE_SERVER avec le nom de la machine du serveur Visual et de lire la valeur dune ressource de Visual TOM avec la commande tval Tval name

6.2 Les variables denvironnement de ladministrateur du client Visual TOM sous UnixComme pour un serveur Visual TOM Unix, les variables denvironnement de ladministrateur du client de Visual TOM sont dfinies dans le fichier vtom_init.[$SHELL] ; la valeur de la variable $SHELL donne le type de shell associ ladministrateur du client de Visual TOM : ksh pour korn shell, Les valeurs de ces variables denvironnement sont positionnes lors de louverture dune session par ladministrateur de Visual TOM et elles sont utilises par le processus bdaemon; par exemple la variable $ABM_LOGS qui contient le nom du rpertoire des logs est utilise la fin de lexcution des traitements.24/46 91157135.doc



Le fichier vtom_init.[$SHELL] est gnr automatiquement dans le rpertoire $TOM_ADMIN lors de linstallation du module client Visual TOM, et il est intgr au fichier .profile de ladministrateur de Visual TOM. Dans la cas dune installation dun module serveur et dun module client sur la mme machine un seul fichier vtom_ini est gnr et il contient les variables denvironnement pour les processus du serveur et du client. Ci dessous un tableau qui donne la liste des variables denvironnement utilises par le module client de Visual TOM HOST TOM_HOME TOM_ADMIN TOM_USER_ADMIN Gnrales Nom de la machine Rpertoire dinstallation de Visual TOM Rpertoire des scripts dadministration Administrateur Visual TOM

Client ABM ABM_BIN ABM_LOGS ABM_SPOOL Rpertoire dinstallation du client ABM Rpertoire des excutables Rpertoire des logs Rpertoire de la file dattente des traitements

6.3 Les variables denvironnement Windows dun client Visual TOMLors de linstallation dun client, les variables d'environnement systme suivantes sont cres : - ABM_BIN = rpertoire des excutables du client Visual TOM - ABM_LOG = Rpertoire des logs La visualisation des valeurs des variables denvironnement systme de Windows se fait laide de la fonction Demarrer\Panneau de configuration\Systeme\Environnement.

6.4 Le fichier de configuration vtom.iniSous Unix, ce fichier est gnr dans rpertoire $TOM_ADMIN lors de linstallation du client ; cest un fichier cach .vtom.ini. Sous Windows, ce fichier est gnr lors de linstallation dans le rpertoire %windir%. Dans le cas dune installation dun serveur et dun client sur la mme machine, un seul fichier vtom.ini est gnr avec les paramtres du serveur et du client. Nota : Toute modification de ce fichier ncessite un arrt et une relance des processus de Visual TOM pour quelle soit prise en compte.


91157135.doc

25/46


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

6.5.1 Configuration dune queue batch sous un client UnixA chaque queue batch correspond un sous-rpertoire sous le chemin $ABM/config/queues. Ce sous-rpertoire contient les fichiers suivants : o fichier de configuration de la queue: queue.conf o dfinition des utilisateurs: users La description du fichier queue.conf est la suivante : N: Nombre maximum de jobs en excution simultane M: Nombre Maximum de jobs en attente Shell : Chemin et nom du shell ; le nom du shell doit tre le mme que lextension 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 excution simultane et a 5 jobs en attente. Elle utilisera le shell /user/bin/tcsh La priorit des jobs dans la queue est de 4 (non utilise sous UNIX).

6.5.1.1 Configuration des administrateursUn administrateur est un utilisateur du systme dexploitation qui peut grer toutes les queues et tous les jobs. Il est le seul habilit arrt et dmarrer le client. La liste des administrateurs est dfinie dans le fichier $ABM_CONFIG/managers

6.5.1.2 Configuration des utilisateursUn utilisateur peut tre associ a une ou plusieurs queues batch qu'il peut utiliser. Pour chaque user, on indique : o le nombre de jobs batch qui peuvent tre excuts en mme temps. o le nombre de jobs batch en attente. La syntaxe de saisie est la suivante : "Nom_Login:Max_Exe:Max_Wait". Cette liste des utilisateurs est dfinie dans le fichier users. NB : La dclaration du user "any" dans une queue rend accessible cette queue tout les users non dclars. Exemple :26/46

le fichier $ABM/config/queues/prod/users de la queue prod91157135.doc



oracle:1:1 Lutilisateur oracle a droit a un seul job en excution et un seul job en attente dans la queue prod

6.5.2 Configuration dune queue batch sous un client WindowsLa liste des queue batch est dclare dans le paramtre ABM_QUEUE de la section [bdaemon] du fichier vtom.ini. A linstallation, il n y a quune seule queue qui est dclare, cest la queue queue_wnt. Dans le fichier vtom.ini gnr linstallation on trouve : [bdaemon] ABM_QUEUES :/queue_wnt:1 Si voulez rajouter la queue queue_test, il suffit de rajouter le nom de la queue et le nombre de jobs simultans autoriss (par exemple 10) sur la ligne ABM_QUEUE. ABM_QUEUE : /queue_wnt :1 /queue_test :10 Il faut aussi crer un submiter associ toute nouvelle queue_batch et arrter et redmarrer le service AbsyssBatchManager.

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


91157135.doc

27/46


Le tableau ci-aprs 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 Nom de la machine serveur Visual TOM qui a lanc le traitement. Identifiant du traitement dans la base de donnes Nom du traitement Nom de lapplication Nom de lenvironnement Nom de la date dexploitation Valeur de la date dexploitation Utilisateur excution du traitement Nom du script a excuter Liste des paramtres du script ou job Priorit du job Nombre de reprises effectues Point de reprise. La valeur de la variable denvironnement TOM_JOB_POINT est gale 0 par dfaut. La modification de la valeur de cette variable denvironnement seffectue laide de la commande tstep (tstep l [,< par2 >,...,< parn >]

dfaut obligatoire obligatoire aucun aucune periodique non 00:00:00 journalire 00:00:00 illimite exec defaut de l'application defaut de l'application defaut de l'application non 23:59:59 oui oui aucun91157135.doc 37/46


Lien de ... Lien vers ... Calendrier Jours de la semaine Jours du mois Semaines du mois Mois de l'anne Formule Ressources Statut Gomtrie couleur bordure couleur fond couleur titre Copie de ... utilisation ou non du mode "Formule" dans un planning utilisation ou non du mode "Planning" dans un planning Mise en exploitation

/LienDe /LienVers /Cal /Jsem /Jmois /Smois /Mannee /Formule /Res /status /Geom /Cbord /Cfond /Ctitre /De /useformule /useplanning /exploit

liens_de liens_vers calendrier jour_semaine jour_mois semaine_mois mois_annee ressource Status geometrie sfrmclr Sbgclr sfrblclr NON DISPONIBLE

< env >/< appli >/< job >[< type de lien >] type de lien : obli | facu | excl | cond | erre < 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: ordonne, x:abscisse

aucun aucun defaut de lapplication OOOOOOO (O * 7) C * 31 OOOOO OOOOOOOOOOOO aucune aucune A_VENIR 90x16+0+0 defaut IHM defaut IHM defaut IHM aucun

< env >/< appli >/< job > [o,n] [o,n] 1 pour la mise en exploitation

38/46

91157135.doc



8.4 Suppression d'un traitementPour UNIX : Pour NT : tdeljob -a app e env -j job idem

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

8.5 Suppression dun lienPour UNIX : Pour NT : tdellink env/app/job (de)env/app/job(vers) idem

La commande tdellink permet de supprimer un lien entre traitements ou applications. L'option "-f" permet de supprimer des liens n'ayant pas d'existence graphique. Attention !!! Ce mode est utiliser avec prcautions, sauvegarde de base et arrt du moteur. Remarque X-Lien ET et Lien OU non supports

Copyright ABSYSS . All rights reserved Rf. : 91157135.docdoc

39/46 04/04/12


9 Installation des modules IsuperviserLe module I-Superviser utilisent une passerelle applicative appele I-Server qui permet de communiquer avec les domaines dexploitation de Visual TOM.

9.1 Installation de la passerelle I-serverLinstallation du module I-Server doit se faire dans une session dun compte administrateur local. Les fichiers ncessaires linstallation du module I-Server sont : iserver.exe, iserver.ini et security.ini. Lexcutable iserver.exe est situ dans le rpertoire bin du rpertoire dinstallation du module serveur ../vtom/bin pour Unix et ..\vtom\services\bin pour Windows. Sous Unix, crez la variable denvironnement $ISERVER_INI et positionner la valeur de cette variable avec le chemin complet du fichier iserver.ini : export $ISERVER_INI=. Sous Windows, crez et positionnez la variable denvironnement systme ISERVER_INI avec le nom du fichier iserver.ini, ou, il suffit de copier mettre le fichier iserver.ini dans le rpertoire point par la variable %windir%. Paramtrez les fichiers iserver.ini et security.ini. Lexcutable iserver.exe doit avoir un accs en mode lecture et criture sur ces deux fichiers.

Contenu du Ficher iserver.ini : [server] name location contact listenPort = nom de la machine dinstallation du I-server = nom de la socit = adresse E-mail du responsable technique = numro de port dcoute du service Iserver

[domain] host = nom ou adresse IP du domaine dexploitation de Visual TOM dserverPort = numro de port du dserver gserverPort = numro de port du gserver pserverPort = numro de port du pserver bdaemonPort= numro de port du bdaemon [security] file [extras] ping BaseUrl = nom complet du fichier security.ini (..\security.ini) nom complet du script permettant de tester la prsence dune machine (unix seulement) Url de base de la documentation et des consignes La documentation et les consignes doivent se trouver dans le rpertoire BaseUrl/NomDomaine/91157135.doc

40/46


[options] FamilylnLists = 1 1 pour que la famille soit passe dans les listes, 0 sinon LastExeclnLists = 0 0 pour que la date de la dernire excution soit passe dans les listes, 1 sinon Contenu du Ficher security.ini : Ce fichier peut tre install dans un rpertoire scuris. Ce fichier contient la liste des utilisateurs pouvant avoir accs aux fonctionnalits de la passerelle I-server : [USER1] name password alias enable [USER2] .. = nom de lutilisateur = mot de passe = alias Visual TOM = 1 actif, 0 inactif (cet utilisateur est actif par dfaut)

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

Sous Windows :Le processus iserver fonctionne sous le service Windows Absyss iServer. La commande dinstallation du processus iserver en tant que service Windows est la suivante : IServer install La commande de dsinstallation du processus iserver en tans que service Windows est la suivante : IServer remove Le dmarrage et larrt de la passerelle I-server seffectue en utilisant la fonction Windows : Dmarrer -> paramtres -> panneau de configuration ->services

9.2 Installation du module I-SuperviserLe module I-Superviser est crit en langage Java, il faut donc, au pralable installer lenvironnement JRE 1.3 (voir java.sun.com). Copiez le contenu du rpertoire darchivage du logiciel I-Superviser sur le rpertoire dinstallation de la machine cible . Le rpertoire dinstallation contiendra les fichiers suivants : isuperviser.jar (pour Unix) ou isuperviser.exe pour Windows et isuperviser.ini. Paramtrez le fichier de configuration isuperviser.ini. Ce fichier possde la structure suivante : [iserver] host = nom de la machine o est install le module I-Server port = numro de port dcoute du I-server (listenPort dans le fichier iserver.ini)Copyright ABSYSS . All rights reserved Rf. : 91157135.docdoc 41/46 04/04/12


user

= utilisateur par dfaut

[interface] fullscreen = 1 si plein cran ou 0 taille normale (la valeur par dfaut est 0) [options] sortByLastExec =1 1 pour le tri par dernire excution, 0 sinon la valeur par dfaut est 0

Sous Unix, le lancement du module isuperviser seffectue de la manire suivante : java jar isuperviser.jar isuperviser.ini Sous Windows, il suffit de lancer en mode commandes le fichier isuperviser.exe.

42/46

91157135.doc


10 Guide de lutilisateur du support standard10.1 ASSISTANCE TELEPHONIQUE10.1.1 Comment nous contacterAppeler au 01.40.84.89.01 ou [email protected] De 8 heures 19 heures Du lundi au Vendredi

10.1.2 Avant dappeler le supportSources dinformations consulter. Une abondante documentation technique est mise votre disposition : - Guides dutilisation et dinstallation en format word et HTML . - Releases notes en word. - FAQS en word et en HTML. Cette documentation est disponible sur :

- chaque CD dinstallation du produit Visual Tom . - le site internet pour les FAQS sur www.absyss.com en cliquant sur support, lutilisateur = nom de votre socit et le password = abs ! suivi des 3 premires lettres de votre socit . 10.1.3 Informations fournir pour toute demande dassistance technique-Votre nom. -Votre adresse -Votre numro de tlphone -Votre numro de fax, le cas chant -Votre mail -Votre N dappel hotline si celui-ci est dj ouvert -La machine et le systme dexploitation (OS) -La version actuelle de Visual Tom -Une description prcise de lincident Il Peut tre demand par le support : - Lenvoi de fichiers (fichiers traces, dumps, test cases : un test case est un ensemble programmes-jeu de donnes, permettant de reproduire lincident de faon systmatique ). - La connexion sur le site client avec un modem pour une tl-maintenance.

10.1.4 Dans quels cas appeler le supportUne assistance technique peut tre sollicite dans les cas suivants : - Questions sur linstallation - Identification, rsolution ou contournement derreurs logicielles (bogues) - Demande damlioration du produit .


43/46 04/04/12


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

10.1.5 Conditions daccs au supportTout client ayant un contrat de maintenance peut demander une assistance technique auprs du support . Il est souhaitable que les personnes qui appellent le support technique connaissent le produit et leur environnement oprationnel.

10.2 MAINTENANCE DES SYSTEMES VISUAL TOM10.2.1 Sauvegarde et restaurationTout client doit imprativement mettre en place des procdures de sauvegarde et de restauration afin dviter la perte de donnes. Nous vous conseillons de faire rgulirement vos sauvegardes et de pratiquer des simulations de restauration afin de vous assurer des rsultats. En supplment des utilitaires de vos OS, vous disposez dans la documentation Visual Tom de tous les outils de sauvegarde et de restauration.

Remarque : nous pouvons vous offrir des services, conseils pour le choix et llaboration dune stratgie de sauvegarde adquate . Ces services font lobjet dune tarification. 10.2.2 Environnement de testLenvironnement de test constitue un lment essentiel de votre systme. Il permet : de tester toute modification locale propose. Il permet daider isoler des anomalies par rapport lenvironnement rel. Il permet de fournir un cadre pour llaboration de scnarios de tests reproductibles.44/46 91157135.doc


Il permet de tester de nouvelles versions. Il permet de tester vos stratgies de sauvegardes et de restauration. Bien quil ne soit videmment pas toujours possible de reproduire ,dans votre environnement de test, les volumes de donnes ou les transactions de votre environnement rel, il nen demeure pas moins quun environnement de test permet de minimiser limpact des changements sur votre environnement rel.

10.2.3 Gestion de vos espacesVous devez vous assurer en permanence que les machines client et serveur disposent dun espace suffisant pour le systme de fichiers, notamment pour les rpertoires de trace.

10.2.4 Installation de versionAvant de raliser votre installation, nous vous conseillons : - dobtenir la dernire version - de lire toute la documentation. Nous vous rappelons que la documentation est disponible sur le CD et sur internet. - de vrifier tous les pr-requis logiciels et matriels. - de valider votre environnement de test avant linstallation relle de la production.


45/46 04/04/12


HOTLINE 01 40 84 89 01 [email protected]

ABSYSS 15/17, boulevard du Gnral de Gaulle 92120 - MONTROUGE - FRANCE 33 (0) 1 40 84 89 01 33 (0) 1 40 84 88 40 Fax [email protected]

www.absyss.com46/46 91157135.doc

Documents

Manuel Formation Administrateur