Documente Academic
Documente Profesional
Documente Cultură
ss
Version 6.5.1D
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 1/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 2/183
Visual TOM Guide Administrateur
SOMMAIRE
1 Objectifs ........................................................................................................................................................................................................... 9
1.1 Liste des modules. ............................................................................................................................................................................................ 9
1.1.1 Visual TOM Serveurs (Référentiel, Ordonnanceur). .......................................................................................................................................... 9
1.1.2 Visual TOM Agents (Exécution des tâches sur une machine) ........................................................................................................................... 9
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 3/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 4/183
Visual TOM Guide Administrateur
4 Modules XVISION............................................................................................................................................................................................ 82
4.1 Module IHM ................................................................................................................................................................................................... 82
4.1.1 Pré-requis ....................................................................................................................................................................................................... 82
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 5/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 6/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 7/183
Visual TOM Guide Administrateur
19.2.4 Remise à zéro de l’indicateur d’état d’un moteur dans la base .................................................................................................................... 149
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 8/183
Visual TOM Guide Administrateur
1 OBJECTIFS
Ce document décrit les procédures d’installation des différents modules de la suite logicielle Visual TOM.
Pour faciliter la compréhension du lecteur, les modules de la suite logicielle Visual TOM sont décrits ci-dessous. Ces
modules sont regroupés en cinq familles :
Pour plus de précisions sur les pré-requis, reportez-vous au document général des pré-requis.
Ce module est l’élément de base de toute architecture. Il inclut le référentiel de production, l’ordonnancement des
Jobs et les APIs. Il peut être installé indifféremment sur des machines UNIX ou Windows.
Ce module gère l'autonomie des sites distants. Il répartit la charge dans une architecture distribuée. Il nécessite la
présence d’un module Enterprise Server. Il peut être installé indifféremment sur des machines UNIX ou Windows.
Ce module relaye automatiquement un serveur Visual TOM en cas d’incident. Il est systématiquement mis en place
dans les productions nécessitant un niveau de sécurité optimal. Il peut être installé indifféremment sur des machines
UNIX ou Windows.
1.1.2 Visual TOM Agents (Exécution des tâches sur une machine)
Visual TOM Agent (VT-CS)
Ce module fonctionne en architecture Client/Serveur. Il dépend d’un Visual TOM serveur; il reçoit les ordres de
soumission en provenance du serveur et exécute les traitements batch. (exemple. : Exécution d’une tâche sur une
machine). Il peut être installé indifféremment sur des machines UNIX ou Windows, VAX/VMS, Open VMS, AS400,
GCOS7 et GCOS8.
Ce module 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.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 9/183
Visual TOM Guide Administrateur
Ce module représente l’interface graphique. Elle se connecte à tout type de serveur Visual TOM. Elle permet la
modélisation, la gestion et le pilotage de la production multi plates-formes UNIX et Windows.
Ce module est une Interface internet permettant de visualiser les caractéristiques des objets du domaine
d’exploitation Visual TOM (ressources, calendriers, environnements, applications, traitements …), et d’assurer le suivi
des travaux.
Ce module est une intégration à un système d’information possédant une plate-forme de supervision de systèmes et
de réseaux et/ ou d’application.
Ce module est une intégration entre l’application Visual TOM et un progiciel du marché (comme SAP R/3, BAAN, JDE, PEOPLE
SOFT, ORACLE APPLICATIONS, …).
Traitement :
Application :
Environnement :
Moteur :
Le Moteur est un processus qui gère la planification et l’ordonnancement de tous les travaux d’un Environnement.
Domaine :
Le Domaine est l’ensemble des objets constituant le référentiel (Environnements, Agents, Utilisateurs…).
Utilisateur :
Queue Batch :
La Queue Batch est l’encapsulation scriptée d’un Traitement ; elle correspond à un comportement d’exécution.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 10/183
Visual TOM Guide Administrateur
2 MODULE SERVEUR
Il est recommandé d’utiliser un système Windows disposant d’un lecteur CD-ROM et de transférer par FTP l’archive
du CD-ROM vers le système Unix.
2.1.1 Désinstallation
Dans le cas d’une réinstallation ou mise à jour, il est recommandé d’effectuer une désinstallation de Visual TOM.
Pour désinstaller Visual TOM, il faut arrêter tous les processus de Visual TOM :
Lorsque Visual TOM est inactif et après avoir effectué une sauvegarde (fichier vtom.ini et base au minimum pour le
serveur, queues batch/submitter pour l’agent), vous supprimez le répertoire d’installation de Visual TOM.
2.1.2 Préparatifs
Il est nécessaire de disposer d’un compte utilisateur qui administrera Visual TOM. Par défaut, le compte vtom, est
utilisé mais il est possible de prendre n’importe quel utilisateur du système.
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 shells.
Visual TOM étant installé à partir du compte administrateur du système, le mot de passe de root sera nécessaire
pour installer Visual TOM.
Copiez les archives représentant le module à installer vers le répertoire temporaire d’installation. Les fichiers copiés
sont :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 11/183
Visual TOM Guide Administrateur
Pour la copie de ces fichiers, 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 :
Remarques :
❑ Si vous souhaitez effectuer une installation en mode silencieux (mode batch), modifiez le paramètre
« batch » à la valeur « oui » dans le fichier install_vtom.ini.
❑ Pour que le démarrage du serveur http soit automatique, modifiez le paramètre « autostart_vthttpd » à la
valeur « oui » dans le fichier install_vtom.ini.
❑ Pour que le démarrage de l’interface SNMP soit automatique, modifiez le paramètre « autostart_tsnmp » à la
valeur « oui » dans le fichier install_vtom.ini.
./install_vtom [module]
Exemples :
Installation d’un module Visual TOM Enterprise Server HP
./install_vtom VT-SES-HPUX.51.Z
Installation d’un module Visual TOM Enterprise Server HP avec un module Visual TOM Agent local
./INSTALL_VTOM VT-SES-HPUX.51.Z VT-CS-HPUX.51.Z
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 12/183
Visual TOM Guide Administrateur
Le script d’installation utilise le fichier de configuration de l’installation (install_vtom.ini) pour proposer des
paramètres d’installation par défaut. Pour chacune des propositions, validez pour l’accepter ou entrez la nouvelle
valeur suivie d'Entrée :
Une fois l’installation terminée copiez le fichier de licence dans le sous répertoire bin du répertoire d’installation du
! serveur ([rep_install]/vtom/bin).
Mettez à jour le fichier /etc/services comme indiqué par la procédure. 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.
Il est recommandé de ne pas réaliser l’installation dans le répertoire d’accueil de l’administrateur Visual TOM ; les
droits sur les fichiers sont gérés à partir du répertoire d’installation, cela peut avoir des impacts sur les fichiers
existants.
Remarques :
• L’interface graphique est installée automatiquement avec le module serveur.
• Le nom du chemin d'installation doit être composé uniquement de caractères alpha-numériques, tiret et
souligné, en complément du séparateur de répertoires (ex : /produits/visual_tom). Cette remarque
s’applique à l’ensemble des modules à installer.
Le nom du fichier de configuration du profil de l’administrateur du Serveur est établi selon la syntaxe suivante :
vtom_init.[$SHELL]. La variable $SHELL contient le nom du shell par défaut de l’administrateur du Serveur : ksh pour
korn shell, sh pour bourne shell, ….
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 13/183
Visual TOM Guide Administrateur
#-----------------------------------------------------------------------
# Exemple de Fichier de configuration du profil de l’administrateur du serveur Visual TOM
# ----------------------------------------------------------------------
# vtom_init.ksh
#
#General
[ -z "${HOST}" ] && HOST=frodon ; export HOST
if [ -n "${LD_LIBRARY_PATH}" ] ; then
[ -z "`echo $LD_LIBRARY_PATH | grep /usr/lib/:/usr/openwin/lib:`" ] &&
LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/home4/vtom/visu
al:/usr/lib/:/usr/openwin/lib: ; export LD_LIBRARY_PATH
else
LD_LIBRARY_PATH=/home4/vtom/visual:/usr/lib/:/usr/openwin/lib: ; export LD_LIBRARY_PATH
fi
TOM_HOME=/home4/vtom ; export TOM_HOME
TOM_ADMIN=/home4/vtom/admin ; export TOM_ADMIN
[ -z "`echo $PATH | grep $TOM_ADMIN`" ] && PATH=${PATH}:${TOM_ADMIN} ; export PATH
TOM_USER_ADMIN=vtom ; export TOM_USER_ADMIN
# Serveur
TOM_STILL_WAIT=yes ; export TOM_STILL_WAIT
TOM_ABORT_SIGNAL=9 ; export TOM_ABORT_SIGNAL
VTOM=/home4/vtom/vtom ; export VTOM
TOM_BACKUP=/home4/vtom/backup ; export TOM_BACKUP
TOM_BASES=/home4/vtom/bases ; export TOM_BASES
TOM_BIN=${VTOM}/bin ; export TOM_BIN
TOM_STATS=/home4/vtom/stats ; export TOM_STATS
TOM_TRACES=/home4/vtom/traces ; export TOM_TRACES
TOM_LP=${TOM_ADMIN}/tom_imprim ; export TOM_LP
[ -z "`echo $PATH | grep $TOM_BIN`" ] && PATH=${PATH}:${TOM_BIN} ; export PATH
Les fichiers du profil .cshrc (ou .login) et .profile du profil de l’administrateur du module Serveur sont modifiés par
l’installation : une ligne contenant la commande d’exécution du fichier de configuration vtom_init[$HELL] est insérée
en fin des fichiers de profil.
#-----------------------------------------------------------------------
# Exemple de Fichier .profile de l’administrateur du serveur Visual TOM
# ----------------------------------------------------------------------
<Ligne 1>
<Ligne 2>
<Ligne 3>
…
. /home4/vtom/admin/vtom_init.ksh
A chaque ouverture de session par l’administrateur de Visual TOM, le script vtom_init.[$SHELL] est exécuté et les
variables d’environnement Visual TOM sont valorisées.
! A chaque nouvelle installation d’un module de Visual TOM, une ligne de commande de lancement du script
vtom_init.[$SHELL] est rajoutée à la fin du fichier .profile de l’administrateur de Visual TOM. Supprimez les lignes de
commande obsolètes.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 14/183
Visual TOM Guide Administrateur
Attention : Le paramétrage d’un émulateur X a des impacts sur le fonctionnement de l’interface graphique.
Exemple:
Si on utilise exceed pour lancer xvision x11, le paramètre "use native WM for embedded client" doit être décoché
dans la configuration exceed au niveau de la définition de l'écran. Si ce paramètre est coché, cela peut engendrer des
erreurs sur l’interface graphique.
Menu « admins »
Choisissez l’option 2 pour démarrer les processus du serveur et connectez-vous au serveur à l’aide du module IHM.
Un utilisateur est défini par défaut dans la base du serveur :
• Utilisateur TOM
• Mot de passe TOM
• Domaine = <nom_de_la_machine_serveur_vtom>
Remarque :
Les procédures d’administration sont génériques. Elles peuvent nécessiter un paramétrage de l’administrateur pour
s’adapter au contexte.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 15/183
Visual TOM Guide Administrateur
Une base de données est générée lors de l’installation. Il est nécessaire de mettre à jour cette base de données pour
tenir compte des paramètres tels que le nom de la machine ou celui de l’utilisateur d’administration.
Utilisateur
Avec le menu « Domaine Exploitation / Utilisateurs », affichez la fenêtre de définition des Utilisateurs.
Cliquez sur « Nouveau » et saisissez le nom de votre administrateur du serveur, renseigné lors de l’installation.
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.
Sélectionnez la fonction Supra manager du menu Pilote. La fenêtre du Supra Manager apparaît.
Démarrage du moteur
Démarrez le moteur en cliquant sur l’icône de la colonne « Moteur », à droite de la barre d’avancement, et confirmez
en validant.
Pour obtenir une vision des Applications, double-cliquez sur le nom de l’Environnement dans le Supra manager.
Puis pour obtenir une vision des Traitements, double-cliquez sur le nom de l’Application dans le Supra manager.
Pour revenir à l’Environnement, cliquez sur le nom du Domaine, indiqué juste sous la barre du haut présentant les
différents états
Pour obtenir une vision graphique de l’Environnement, cliquez sur sa barre d’avancement.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 16/183
Visual TOM Guide Administrateur
Accès au graphe
Nom du de
Domaine l’Environnement
Si vous avez installé un agent sur la même machine que le serveur, ce paragraphe nous explique comment exécuter
les Traitements et consulter leur compte rendu d’exécution.
Associez l’Utilisateur maître de l’administration de Visual TOM, indiqué lors de l’installation, à l’aide du bouton de la
colonne « Valeurs possibles ». Positionnez cet Utilisateur comme étant celui par défaut sur l’Environnement.
Association d’un
Choix de Utilisateur à
l’Utilisateur l’Environnement
par défaut
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 17/183
Visual TOM Guide Administrateur
Basculez vers le mode conception en utilisant le bouton en bas à gauche de la fenêtre représentant le graphe de
l’Environnement.
Bascule
Conception
Pilotage
Cliquez sur l’Application « appli_test » avec le bouton droit de la souris pour obtenir son menu contextuel. Cliquez
sur « Définition », la fenêtre de définition de l’Application s’affiche.
Double cliquez sur l’Application pour obtenir la représentation graphique des Traitements. Cliquez sur le Traitement
« job1 » avec le bouton droit de la souris pour obtenir son menu contextuel. Cliquez sur « Définition », la fenêtre de
définition du Traitement s’affiche. Vérifiez que le script existe, en cliquant sur le bouton situé en fin de ligne du
champ « Script ». Sinon, saisissez dans le champ script la ligne suivante :
scripts/job_ ksh
Validez en cliquant sur le bouton situé en fin de ligne du champ « Script ».
Démarrage de l’agent
Ouvrez la console UNIX où vous avez lancé le menu pour démarrer les processus serveur. Dans le menu admins,
choisissez l’option 5- Gestion de l’agent : démarrage de l’agent.
Lancement de l’exécution
Ouvrez le graphe de l’environnement « exploitation » depuis la fenêtre Supra manager, comme vu précédemment,
pour obtenir la représentation graphique des Applications.
Cliquez sur l’Application « appli_test » avec le bouton droit de la souris, choisissez le menu « Actions », puis l’item
« Forcer à A VENIR ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 18/183
Visual TOM Guide Administrateur
Double cliquez sur l’Application pour obtenir la représentation graphique des Traitements. Ceux-ci sont passés au
statut « A VENIR » et vont s’exécuter les uns après les autres.
Cliquez deux fois sur un des Traitements pour obtenir la liste des compte rendus d’exécution. Vous pouvez
également y accéder en utilisant le bouton droit de la souris et le menu contextuel du Traitement, puis l’item
« Logs ».
La Liste des comptes rendus d’exécution de ce Traitement s’affiche. Double cliquez sur le premier élément de la liste,
ou utilisez le menu contextuel de l’élément : le contenu du fichier compte-rendu s’affiche.
2.2.1 Désinstallation
Dans le cas d’une réinstallation ou mise à jour, il est nécessaire d’effectuer une désinstallation de Visual TOM. Pour
désinstaller Visual TOM, il faut arrêter tous les processus de Visual TOM :
Remarques :
Certains répertoires ou fichiers ne seront pas supprimés après la désinstallation :
• Le fichier « vtom.ini » situé dans le répertoire %windir% 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, déclarés 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
supprimés par le gestionnaire de fichiers.
• Les variables d’environnement système préfixées par TOM ou ABM (exemple « TOM_BIN ») ne sont pas
supprimées. La variable PATH n’est pas mise à jour.
Lorsque Visual TOM est inactif et après avoir effectué une sauvegarde (fichier vtom.ini et base au minimum pour le
serveur, queues batch/submitter pour l’agent), vous désinstallez à partir du setup.
Pour une désinstallation permanente, supprimez le compte « vtomsgbd » avec l’aide de votre administrateur.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 19/183
Visual TOM Guide Administrateur
2.2.2 Préparatifs
Visual TOM étant installé à partir du compte administrateur du système, le mot de passe administrateur sera
nécessaire pour installer Visual TOM.
Une installation en mode RODC nécessite au préalable la création d’un utilisateur pour la gestion du compte du
! service « AbsyssSgbd ». Ce compte doit être disponible pour démarrer l’installation.
Lancez l’exécutable.
Il est recommandé de ne pas utiliser un nom de répertoire comprenant des espaces, caractères accentués et
! caractères spéciaux.
Cliquez sur le bouton « Suivant » ; la fenêtre du choix des modules à installer est affichée.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 20/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 21/183
Visual TOM Guide Administrateur
Il est recommandé de ne pas utiliser un nom de répertoire comprenant des espaces, caractères accentués et
! caractères spéciaux.
Cliquez sur suivant. L’installation démarre. En fin d’installation, la fenêtre suivante s’affiche :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 22/183
Visual TOM Guide Administrateur
Finalisation de l’installation
! Il est impératif de redémarrer le serveur pour finaliser l’installation. Au redémarrage, les services démarrent
automatiquement.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 23/183
Visual TOM Guide Administrateur
Remarques :
❑ Deux commandes sont fournies avec le groupe de programme de Visual TOM pour une gestion plus rapide
des services.
❑ Le nom du chemin d'installation doit être composé uniquement de caractères alpha-numériques, tiret et
souligné, en complément du lecteur et du séparateur de répertoires (ex : d:\produits\visual_tom). Cette
remarque s’applique à l’ensemble des modules à installer.
Le champ script des Traitements est valorisé. Validez en cliquant sur le bouton situé en fin de ligne du champ
« Script », dans la définition des Traitements.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 24/183
Visual TOM Guide Administrateur
• la réplication automatique des données de la base entre le serveur primaire et le serveur de backup,
• la prise de responsabilité de la planification et de l’ordonnancement par le serveur de backup en cas de
défaillance du serveur primaire (réseau, processus, machine…).
• le pilotage depuis l’interface graphique de l’état des processus et de la synchronisation.
Par défaut, l’état des processus et de la synchronisation est mis à jour toutes les 10 secondes. La mise à jour de cette
valeur est effectuée dans le fichier vtom.ini du primaire, dans l’item « backup_monitor_loop » de la section
« GLOBALES ».
• Le serveur de backup doit être sur le même réseau que le serveur primaire.
• Le serveur primaire et le serveur de backup doivent utiliser le même système d’exploitation (Unix ou
Windows).
• Les arborescences d’installation doivent être identiques sur les deux serveurs.
• Sous Unix, le nom de l’administrateur de Visual TOM doit être le même sur les deux serveurs.
• Les deux machines du serveur primaire et du serveur de backup doivent pouvoir communiquer entre elles.
• Les ports TCP utilisés par Visual TOM doivent être identiques sur les deux serveurs.
Remarque :
Lorsqu’un Traitement se termine, le serveur Primaire et le serveur de Backup sont synchronisés.
La procédure d’installation d’un serveur primaire est identique à celle d’un module Serveur comme c’est décrit ci-
dessous dans le chapitre d’installation d’un module Serveur.
Remarque :
Lors de l’installation sous Unix, vous pouvez définir le serveur de backup.
B. Configuration
Sous Unix
Une variable d’environnement TOM_BACKUP_SERVER doit être définie dans le fichier vtom_init.[$SHELL] situé dans
le répertoire $TOM_ADMIN. La variable d’environnement TOM_BACKUP_SERVER doit contenir le nom ou l’adresse
IP du serveur de backup.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 25/183
Visual TOM Guide Administrateur
Sous Windows
Une variable d’environnement de type système TOM_BACKUP_SERVER doit être définie dans le système Windows
et aura comme valeur le nom ou l’adresse IP du serveur de backup.
La procédure d’installation d’un serveur de backup est identique à celle d’un module Serveur comme c’est décrit ci-
dessous dans le chapitre d’installation d’un module Serveur.
B. Configuration
Sous Unix
Une variable d’environnement TOM_PRIMARY_SERVER doit être définie dans le fichier vtom_init.[$SHELL] situé
dans le répertoire $TOM_ADMIN. La variable d’environnement TOM_PRIMARY_SERVER doit contenir le nom ou
l’adresse IP du serveur primaire.
Remarque :
Lorsque le primaire est actif, la connexion d’une interface et l’usage du mode commande sur le backup sont
proscrits.
Sous Windows
Une variable d’environnement de type système TOM_PRIMARY_SERVER doit être définie dans le système Windows
et aura comme valeur le nom ou l’adresse IP du serveur primaire.
Remarque :
Lorsque le primaire est actif, la connexion d’une interface et l’usage du mode commande sur le backup sont
proscrits.
Pour synchroniser les bases au démarrage, supprimer le contenu du répertoire « BASES » sur le serveur de backup.
!
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 26/183
Visual TOM Guide Administrateur
Remarque :
Si l’arrêt doit être long, il est conseillé de le faire quand aucun traitement n’est en cours d’exécution, pour ne pas
risquer la perte de l’acquittement de terminaison.
Si l’agent ne parvient pas à envoyer une commande au serveur primaire (acquittement sur terminaison d’un
traitement ou mode commande), il renvoie sa commande vers le serveur de backup.
Ce mécanisme est répété jusqu’à concurrence du nombre maximum de tentatives, indiqué par l’item
« TOM_TSEND_MAX_RETRY » de la section « GLOBALES » du fichier de paramétrage « vtom.ini » de l’Agent
exécutant la commande. Le temps entre 2 tentatives est défini par l’item « TOM_TSEND_WAIT_RETRY » dans cette
même section.
B. Procédure de basculement
Les moteurs qui étaient actifs sur le serveur primaire sont démarrés sur le serveur de backup, l’état des moteurs
étant stocké dans la base de données.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 27/183
Visual TOM Guide Administrateur
Remarques :
• Le serveur de backup devient actif lorsque le fichier « bascule » est créé dans le répertoire contenant la base.
• Si le serveur primaire est redémarré ou reçoit une demande de mise à jour, alors que le serveur de backup a
pris la main, il s’arrête immédiatement.
• Le temps maximum de prise de décision pour la bascule peut être forcé depuis le fichier vtom.ini du serveur
de backup.
• L’indisponibilité du serveur primaire est visible à partir de l’interface graphique, dans le bandeau bas. Après 5
minutes, une connexion vers le backup est proposée.
Lorsque le backup a pris la main, la procédure de retour au mode normal est la suivante :
Si le serveur de backup est arrêté (ou non joignable) pendant une période supérieure à la valeur indiquée par le
paramètre « backup_sync_timeout », il sera nécessaire de faire une synchronisation avant démarrage :
Le Primaire doit être accessible par le Backup pour que la synchronisation soit faite.
!
Si le backup est arrêté pendant une durée inférieure à la valeur indiquée par le paramètre « backup_sync_timeout »,
la synchronisation sera effectuée automatiquement.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 28/183
Visual TOM Guide Administrateur
La procédure d’installation d’un serveur de backup est identique à celle d’un module Serveur comme c’est décrit ci-
dessous dans le chapitre d’installation d’un module Serveur.
B. Configuration
Sous Unix
Une variable d’environnement TOM_PRIMARY_SERVER doit être définie dans le fichier vtom_init.[$SHELL] situé
dans le répertoire $TOM_ADMIN. La variable d’environnement TOM_PRIMARY_SERVER doit contenir le nom ou
l’adresse IP du serveur primaire.
Une variable d’environnement TOM_BACKUP_MODE doit être définie dans le fichier vtom_init.[$SHELL] situé dans
le répertoire $TOM_ADMIN. La variable d’environnement TOM_BACKUP_MODE doit contenir la valeur « R ».
Remarques :
• Toute autre valeur provoque l’arrêt du processus.
• La valeur est paramétrable dans le fichier vtom.ini.
Sous Windows
Sous Windows
Une variable d’environnement de type système TOM_PRIMARY_SERVER doit être définie dans le système Windows
et aura comme valeur le nom ou l’adresse IP du serveur primaire.
Une variable d’environnement TOM_BACKUP_MODE doit être définie dans le système Windows et doit contenir la
valeur « r » ou « R ».
Remarques :
• Toute autre valeur provoque l’arrêt du processus.
• La valeur est paramétrable dans le fichier vtom.ini.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 29/183
Visual TOM Guide Administrateur
C. Test d’activité
A intervalle régulier, le serveur de backup exécute une requête pour tester l’activité du serveur primaire. Si le
serveur primaire ne répond pas, le serveur de backup envoie une requête vers chaque agent pour que ceux-ci
effectuent un test d’activité. Si aucun agent ne réussit le test d’activité, le serveur de backup s’arrête.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 30/183
Visual TOM Guide Administrateur
3 MODULE AGENT
Il est recommandé d’utiliser un système Windows disposant d’un lecteur CD-ROM et de transférer par FTP l’archive
du CD-ROM vers le système Unix.
L’option « nosuid » ne doit pas être activée sur le point de montage où se trouve le répertoire d’installation.
Pour utiliser un Modèle de Traitement, la version de l’agent doit être la même que celle du serveur.
Lorsque l’Agent est configuré en mode DMZ, il est nécessaire d’ajouter manuellement un droit d’écriture sur le
répertoire SPOOL pour que les commandes tsend puissent stocker le résultat des traitements soumis par différents
comptes de soumission.
3.1.1 Désinstallation
Dans le cas d’une réinstallation ou mise à jour, il est recommandé d’effectuer une désinstallation de Visual TOM.
Pour désinstaller Visual TOM, il faut arrêter tous les processus de Visual TOM :
Lorsque Visual TOM est inactif et après avoir effectué une sauvegarde (fichier vtom.ini, queues batch/submitter pour
l’agent), vous supprimez le répertoire d’installation de Visual TOM.
3.1.2 Préparatifs
Il est nécessaire de disposer d’un compte utilisateur qui administrera Visual TOM. Par défaut, le compte vtom, est
utilisé mais il est possible de prendre n’importe quel utilisateur du système.
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 shells.
Visual TOM étant installé à partir du compte administrateur du système, le mot de passe de root sera nécessaire
pour installer Visual TOM.
Copiez les archives représentant le module à installer vers le répertoire temporaire d’installation. Les fichiers copiés
sont :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 31/183
Visual TOM Guide Administrateur
Pour la copie de ces fichiers, 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 :
Remarque :
Si vous souhaitez effectuer une installation en mode silencieux (mode batch), modifiez le paramètre « batch » à la
valeur « oui » dans le fichier install_vtom.ini.
Le script d’installation utilise le fichier de configuration de l’installation (install_vtom.ini) pour proposer des
paramètres d’installation par défaut.. Pour chacune des propositions, validez pour l’accepter ou entrez la nouvelle
valeur :
Mettez à jour le fichier /etc/services comme indiqué par la procédure. 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.
Il est recommandé de ne pas réaliser l’installation dans le répertoire d’accueil de l’administrateur Visual TOM ; les
droits sur les fichiers sont gérés à partir du répertoire d’installation, cela peut avoir des impacts sur les fichiers
existants.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 32/183
Visual TOM Guide Administrateur
Le nom du fichier de configuration du profil de l’administrateur du Serveur est établi selon la syntaxe suivante :
vtom_init.[$SHELL]. La variable $SHELL contient le nom du shell par défaut de l’administrateur du Serveur : ksh pour
korn shell, sh pour bourne shell, ….
#-----------------------------------------------------------------------
#Extrait du fichier vtom_init.ksh
# ----------------------------------------------------------------------
# Agent
ABM=/home4/abm ; export ABM
ABM_BIN=${ABM}/bin ; export ABM_BIN
ABM_LOGS=/home4/logs/ ; export ABM_LOGS
ABM_SPOOL=${ABM}/spool ; export ABM_SPOOL
Les fichiers du profil .cshrc (ou .login) et .profile du profil de l’administrateur du module Agent sont modifiés par
l’installation : une ligne contenant la commande d’exécution du fichier de configuration vtom_init[$HELL] est insérée
en fin des fichiers de profil.
#-----------------------------------------------------------------------
# Exemple de Fichier .profile de l’administrateur du serveur Visual TOM
# ----------------------------------------------------------------------
<Ligne 1>
<Ligne 2>
<Ligne 3>
…
. /home4/vtom/admin/vtom_init.ksh
A chaque ouverture de session par l’administrateur de Visual TOM, le script vtom_init.[$SHELL] est exécuté et les
variables d’environnement Visual TOM sont valorisées.
! A chaque nouvelle installation d’un module de Visual TOM, une ligne de commande de lancement du script
vtom_init.[$SHELL] est rajoutée à la fin du fichier .profile de l’administrateur de Visual TOM. Supprimez les lignes de
commande obsolètes.
Les variables d’environnement de l’administrateur du serveur Visual TOM sont définies dans le fichier
vtom_init.[$SHELL] .
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 33/183
Visual TOM Guide Administrateur
Liste des variables d’environnement utilisées par le module serveur de Visual TOM
Générales
Serveur
Menu « adminc »
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 34/183
Visual TOM Guide Administrateur
Remarque :
Les procédures d’administration sont génériques. Elles peuvent nécessiter un paramétrage de l’administrateur pour
s’adapter au contexte.
Une base de données est générée lors de l’installation. Il est nécessaire de mettre à jour cette base de données pour
tenir compte des paramètres tels que le nom de la machine ou celui de l’utilisateur d’administration.
Agent
Avec le menu « Domaine Exploitation / Agents », affichez la fenêtre de définition des Agents.
Vérifiez la disponibilité de l’agent en utilisant le suivi des agents, à l’aide du menu « Pilotage / Suivi des Agents ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 35/183
Visual TOM Guide Administrateur
Association de
l’Unité de
soumission à
l’Environnement
Basculez vers le mode conception en utilisant le bouton en bas à gauche de la fenêtre représentant le graphe de
l’Environnement.
Double cliquez sur l’Application pour obtenir la représentation graphique des Traitements. Cliquez sur le Traitement
« job2 » avec le bouton droit de la souris pour obtenir son menu contextuel. Cliquez sur « Définition », la fenêtre de
définition du Traitement s’affiche. Choisissez la Machine correspondant à l’agent distant.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 36/183
Visual TOM Guide Administrateur
Lancement de l’exécution
Ouvrez le graphe de l’environnement « exploitation » depuis la fenêtre Supra manager, comme vu précédemment,
pour obtenir la représentation graphique des Applications.
Cliquez sur l’Application « appli_test » avec le bouton droit de la souris, choisissez le menu « Actions », puis l’item
« Forcer à A VENIR ».
Double cliquez sur l’Application pour obtenir la représentation graphique des Traitements. Ceux-ci sont passés au
statut « A VENIR » et vont s’exécuter les uns après les autres.
Cliquez deux fois sur le Traitement « job2 » pour obtenir la liste des compte-rendus d’exécution. Vous pouvez
également y accéder en utilisant le bouton droit de la souris et le menu contextuel du Traitement, puis l’item
« Logs ».
La Liste des compte-rendus d’exécution de ce Traitement s’affiche. Double cliquez sur le premier élément de la liste,
ou utilisez le menu contextuel de l’élément : le contenu du fichier compte-rendu s’affiche.
Pour utiliser un Traitement modèle, la version de l’agent doit être la même que celle du serveur.
3.2.1 Désinstallation
Dans le cas d’une réinstallation ou mise à jour, il est nécessaire d’effectuer une désinstallation de Visual TOM. Pour
désinstaller Visual TOM, il faut arrêter tous les processus de Visual TOM :
Lorsque Visual TOM est inactif et après avoir effectué une sauvegarde (fichier vtom.ini, queues batch/submitter pour
l’agent), vous désintallez avec le setup fourni.
Remarques :
Certains répertoires ou fichiers ne seront pas supprimés après la désinstallation :
• Le fichier « vtom.ini » situé dans le répertoire %windir% 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, déclarés 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
supprimés par le gestionnaire de fichiers.
• Les variables d’environnement système préfixées par TOM ou ABM (exemple « TOM_BIN ») ne sont pas
supprimées. La variable PATH n’est pas mise à jour.
Il est préférable d’effectuer la désinstallation lorsqu’il n’y a plus aucun Traitement actif.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 37/183
Visual TOM Guide Administrateur
3.2.2 Préparatifs
Visual TOM étant installé à partir du compte administrateur du système, le mot de passe administrateur sera
nécessaire pour installer Visual TOM.
Lancez l’exécutable.
Il est recommandé de ne pas utiliser un nom de répertoire comprenant des espaces, caractères accentués et
! caractères spéciaux.
Cliquez sur le bouton « Suivant » ; la fenêtre du choix des modules à installer est affichée.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 38/183
Visual TOM Guide Administrateur
Cliquez sur le bouton « Suivant » sur les fenêtres suivantes jusqu’à la fenêtre ci-dessous :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 39/183
Visual TOM Guide Administrateur
Finalisation de l’installation
! Il est impératif de redémarrer le serveur pour finaliser l’installation. Au redémarrage, le service démarre
automatiquement.
Remarques :
• Deux commandes sont fournies avec le groupe de programme de Visual TOM pour une gestion plus rapide
des services.
• Pour utiliser l’agent 64 bits, utilisez le setup approprié.
3.3.1 Pré-requis
Le système d’exploitation OS 400 doit être de version V5R3 ou supérieure.
Visual TOM est compatible avec le mode « sécurité 40 » (niveau de protection des objets).
Un travail est soumis avec l'Utilisateur et la Queue Batch définis dans le Traitement Visual TOM. Visual TOM soumet :
Les paramètres de la soumission (exemple : JOBD) sont chargés depuis la queue batch et sont sur-chargeables au
niveau des paramètres du Traitement Visual TOM.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 40/183
Visual TOM Guide Administrateur
Quand le traitement est soumis, il produit des comptes-rendus d’exécution en fonction du répertoire de logs indiqué
dans le fichier de configuration « VTOM ». Ces comptes-rendus sont visualisables :
S’il y a une installation précédente de l’agent Visual TOM, vous pouvez la sauvegarder ou la désinstaller.
Remarque :
Un modèle de Traitement est disponible pour créer un Traitement AS400.
• bdaemon, port d’écoute de l’agent. Ce port TCP doit avoir la même valeur que le port bdaemon déclaré sur
le serveur Visual TOM.
• tomDBd , port utilisé par l’agent pour communiquer avec le Serveur Visual. Ce port TCP doit avoir la même
valeur que le port tomDBd déclaré sur le serveur Visual TOM.
Ces ports sont surchargés par la présence éventuelle de leur définition dans le fichier de configuration « VTOM ».
Pour contrôler la présence ou l’absence d’utilisation des numéros de ports de communication, effectuez les actions
suivantes :
Sur le système OS400, la modification du numéro de port implique une suppression du service et une nouvelle
création de ce service. Ceci doit être fait par le menu CFGTCP, en utilisant l’utilisateur QSECOFR.
! Pour les noms de service, la casse doit être respectée (« tomDBd » et « bdaemon »).
A. Arrêt de l’agent
Affichez le menu « Administration de l’agent AS400 » en ouvrant une session avec l’utilisateur VTOM (mot de passe
VTOM).
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 41/183
Visual TOM Guide Administrateur
Choisissez l’option 3 « Arrêt de l’agent » et fermer la session courante (commande « signoff »).
Ouvrez une session avec l’utilisateur QSECOFR ; le mot de passe doit être fourni par l’administrateur système.
Sauvegardez l’installation courante avec les commandes suivantes :
CRTSAVF QGPL/VTOMXXX
------------- XXX correspond au numéro de version installée (exemple : VTOM561-------------------
SAVLIB LIB(VTOM) DEV(*SAVF) SAVF(QGPL/VTOMXXX)
Sauvegarde d’une installation de l’agent
3.3.4 Désinstallation
Arrêtez l’agent (cf paragraphe ci-dessus) et supprimez la bibliothèque « VTOM ». Pour supprimer cette bibliothèque
« VTOM » :
WRKLIB VTOM
• Utilisez la touche « 4 ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 42/183
Visual TOM Guide Administrateur
3.3.6 Installation
L’installation de l’agent consiste à créer un environnement AS400 pour l’agent et puis à lancer la procédure
d’installation :
RSTOBJ OBJ(QINSTAPPCD VTOMINSTAL) SAVLIB(VTOMXXX) DEV(*SAVF)
SAVF(QGPL/VTOMOS400) RSTLIB(QTEMP)
------------- XXX correspond à la version à installer -----------------------------------
Restauration de l’objet contenu dans l’archive
Saisissez la commande suivante, puis pressez la touche F4 (ne pas presser la toucher ENTER)
QTEMP/VTOMINSTAL
Lancement de la procédure d’installation
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 43/183
Visual TOM Guide Administrateur
Le jeu de caractères utilisé est précisé en dernier paramètre (00297 correspond à EBCDIC FR, 00037 correspond à
EBCDIC UK).
A la fin de la procédure d’installation, un message indique le bon déroulement et le menu d’administration de l’agent
AS400 est affiché.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 44/183
Visual TOM Guide Administrateur
Remarque :
La première installation est réalisée à partir du compte QSECOFR. Lors de cette installation, le compte administrateur
de Visual TOM est automatiquement créé (mot de passe par défaut : valeur de l’administrateur VTOM) et utilisable
pour les installations/désinstallations suivantes.
A. Démarrage de l’agent
Si le démarrage de l’agent s ‘effectue sans erreur, détruisez le fichier « VTOMXXX » en utilisant la commande
suivante :
DLTF QGPL/VTOMXXX
Destruction du fichier
Si le démarrage de l’agent s’effectue anormalement, vérifiez que la bibliothèque QGPL n’est pas utilisée par le
système (cette bibliothèque doit posséder le type « PROD »).
Remarque :
La jobq utilisée est celle indiquée dans la jobd « VTOM/VTOM ».
B. Arrêt de l’agent
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 45/183
Visual TOM Guide Administrateur
Choisissez l’option 8 du menu d’administration pour consulter les variables d’environnement de l’agent. Le tableau
suivant fournit une liste non exhaustive des variables d’environnement.
Si les ports sont définis dans la section « ports », les valeurs surchargent celles indiquées dans la table des services.
!
D. Gestion des Queues Batch
qbatch
name Nom de la queue (stockée dans VTOM/TCLSRC)
10
maxrun Nombre maximum de travaux actifs simultanément
-1
maxwait Nombre maximum de travaux dans la queue (-
1=nomax)
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 46/183
Visual TOM Guide Administrateur
nameshell QBATCH
Priorité
user01 VTOM,10,10
Notion de groupe
mg01 VTOM
Manager de la jobq
JOBQ
JOB
Paramètres de la SBMJOB
JOBD
…
…
…
CPYENVVAR
…
Paramètres de la SBMJOB
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 47/183
Visual TOM Guide Administrateur
! Le nom d’un Job AS400 ne doit pas dépasser 10 caractères (Limite système), son nom doit commencer par une lettre.
Création de l’Agent
Utilisez le menu principal « Domaine/Machines ». Créez l’Agent avec création automatique de l’Unité de Soumission.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 48/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 49/183
Visual TOM Guide Administrateur
Bouton
« Sélection »
Bouton
« Ajouter un
Accès au
nœud »
graphe par le
menu
contextuel de
l’Application
Traitement
Bouton
« Mise en
Exploitation »
Graphe de l’Application
Sélectionnez le bouton « Ajouter un nœud ». Avec le bouton gauche de la souris, cliquez sous le dernier Traitement
« job3 ». Un nœud graphique apparaît.
Sélectionnez le bouton « Sélection ». Utiliser le menu contextuel nœud graphique nouvellement créé. Choisissez
l’item « Créer un Traitement ».
Exemple 1 :
Créez un Traitement. Insérez les paramètres suivants :
Paramètre 1, pour préciser la commande à exécuter : CMD=DLYJOB 5
Exécutez le Traitement ; celui-ci doit se terminer correctement, après une attente de 5 secondes.
Onglet
Paramètres
Mode
d’exécution
Unité de
soumission
Utilisateur
Queue
Batch
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 50/183
Visual TOM Guide Administrateur
Paramètres du Traitement
! Pour être réellement exécuté, le Traitement doit être en mode Exécution et mis en exploitation.
Exemple 2 :
Créez un Traitement. Valorisez le champ script avec « # », valorisez et/ou surchargez les paramètres de soumission
comme suit :
CMD=[nom_bib]/[nom_clp]
JOBD=[valeur du parametre]
Exemple 3 :
Créez un Traitement. Valorisez le champ script avec « [nom_bib]/[nom_clp] ». Pour surcharger un paramètre de
soumission, valorisez les paramètres comme suit :
JOBD=[valeur du paramètre]
Remarque :
Les paramètres du Traitement sont valorisés comme suit :
CMD=[nom_bib]/[nom_clp] PARM(‘xxx’ ‘yyy’)
3.3.8 Démarrage automatique de l’agent
Pour que l’agent AS400 démarre automatiquement lors du boot de la machine, il faut modifier le fichier de commandes exécuté au
boot. La procédure de modification de ce fichier est la suivante :
ADDLIBLE VTOM
MONMSG MSGID(CPF0000)
CALL PGM(VTOM/BDAEMON)
MONMSG MSGID(CPF0000)
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 51/183
Visual TOM Guide Administrateur
Les données de configuration et les données liées aux messages sont stockées dans le fichier
« messageManager.cfg ». Ce fichier est situé dans le même répertoire que l’exécutable.
Le module est utilisable, que le traitement ait été soumis via Visual TOM ou non.
Cet exécutable est utilisable en mode automatique ou manuel, avec affichage permanent ou non.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 52/183
Visual TOM Guide Administrateur
Machine
Utilisateur
Champ obligatoire. Le champ utilisateur indique le compte sous lequel la réponse est effectuée. Cet utilisateur doit
disposer des droits pour avoir la visibilité de messages et y répondre.
Mot de passe
Champ obligatoire.
Rafraîchissement
Ce champ indique la fréquence à laquelle l’exécutable vérifie l’existence de messages, et y répond. S’il y a plusieurs
règles de réponse correspondant au message, la première est utilisée (ordre de création / affichage).
Quand ce mode n’est pas actif, la fenêtre se ferme après 1 cycle de vérification.
Mode interactif
Lorsque ce mode est activé, la fenêtre est masquée dans la barre de tâches, et s’affiche à l’écran lorsqu’un message
nécessite une réponse qui n’a pas été automatisée.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 53/183
Visual TOM Guide Administrateur
Lorsque ce mode est désactivé, la fenêtre n’est pas masquée dans la barre de tâches et reste affichée à l’écran. La
fenêtre peut être minimisée manuellement, mais ne réapparaitra pas automatiquement à l’arrivée d’un message
dont la réponse est manuelle.
Queue de message
Champ obligatoire. Ce champ correspond au chemin de la librairie contenant les messages de la queue QSYSOPR
(%LIBL% indique la librairie de l’utilisateur mentionné).
Réponse automatique
Champ
Valeur
Lorsque ce champ est validé, c’est la réponse définie sur l’AS400 qui est utilisée pour une réponse automatique.
Autre réponse
La fenêtre « Historique des réponses automatiques et manuelles » fournit les informations suivantes : date,
utilisateur ayant répondu, réponse apportée, type manuel ou automatique.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 54/183
Visual TOM Guide Administrateur
3.4.1 Pré-requis
La validation des pré-requis doit être réalisée avec le Responsable Systèmes/Réseaux du site.
3.4.2 Installation
A. Mise à jour sur GCOS7
Créez l’utilisateur dans le projet OPERATOR ou dans un autre projet de type « main ».
Créez si nécessaire une startup IOF pour générer le message qui indiquera que la connexion est effective (message
indiqué dans le fichier « vtom.ini », paramètre « GCOS_CNX_STEPS »).
Remarque :
Une « startup système » peut être considérée comme profil d’un utilisateur. Vous pouvez préférer une startup
projet.
Exemple :
Membre OPERATOR_OPABS01_B, stocké dans la bibliothèque « SITE.STARTUP ».
! Vérifiez que l’utilisateur déclaré lors de la création de la startup (ex : OPABS01) a le droit d’exécuter la startup.
Installez un agent Windows standard. Reportez-vous au chapitre d’installation d’un agent Windows.
Ajoutez le nom de la queue batch de l’agent GCOS7 à la liste des valeurs du paramètre ABM_QUEUES du fichier
« vtom.ini » (par exemple « queue_gcos7 »).
[BDAEMON]
ABM_QUEUES=/queue_w9x:10 /queue_wnt:10 /queue_gcos7:64
…
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 55/183
Visual TOM Guide Administrateur
D. Paramétrage de la connexion
[VT2GCOS_SERVER:]
AGENTS=
JAVA_PATH=C:\Program Files\Java\jre6\bin\
JAR_PATH=C:\vtom\abm\bin\vtom2gcos7.jar
# Url du serveur viplet
VIPLET_URL=http://192.00.00.01/viplet/
# User de connexion Viplet
VIPLET_USER=xxx
VIPLET_CNX_GRP=Absyss
VIPLET_CNX_NAME=Bull_GCOS7
# Mode prompt : Connexion a GCOS avec user (1400), projet (1500), mot de passe (1600) et message de détection
# de connexion
GCOS_CNX_STEPS=$$ 1400=OPABS01,$$ 1500=OPABSYSS,$$ 1600=ABSYSSVAC, CONNEXION OPERATEUR
# Mode ecran : Connexion a GCOS avec valeurs des champs, a separer par ‘/’. Si plusieurs ecrans, separer par ‘,’.
# Indiquer la chaine permettant d’identifier la connexion.
GCOS_CNX_STEPS=V2/MBOX,S:
# Répertoire de gestion des spools. Les répertoires doivent exister. Ne pas utiliser le répertoire spool standard. Mettre un séparateur à la fin
SPOOLS=c:\vtom\abm\spoolgcos\
LOGS= c:\vtom\abm\logs\
LOGS_ACTIV=1
LOOPTIME=5
# Nombre de tentatives sur la lecture d’un fichier (fichiers spool et fichier temporaires de logs)
RETRY=1000
WAIT_BETWEEN_RETRIES=1000
TRACE_SCREEN=1
TRACE_FILE_DIR=C:\vtom\traces
# Traces de la partie serveur
TRACE_FILE_NAME=vtom2gcos.log
TRACE_FILE=1
TRACE_LEVEL=6
TRACE_FILE_SIZE=2
Pour crypter une valeur d’un des steps du paramètre « GCOS_CNX_STEPS », utilisez l’utilitaire « bcrypt » et
remplacez la valeur calculée précédée du caractère « * ».
E. Copie des fichiers de l’agent GCOS7
Sélectionnez dans le répertoire « Installation » l’archive de l’agent GCOS7 et copiez-le vers le répertoire
%ABM_BIN%.
! Après la copie des fichiers, le nom du fichier « SUBMIT_QUEUE_GCOS7 » doit être en phase avec le nom déclaré dans
le fichier « vtom.ini ». Ce nom est établi comme suit : Submit_ « Nom_de _Queue_Batch » .bat
• un nom de Machine correspondant à l’agent windows installé, qui gère la connexion à GCOS7,
• une Queue Batch de nom « queue_gcos7 »,
• une Application,
• un Traitement.
Création de l’Agent
Utilisez le menu principal « Domaine/Machines ». Créez l’Agent avec création automatique de l’Unité de Soumission.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 56/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 57/183
Visual TOM Guide Administrateur
Bouton
« Sélection »
Bouton
« Ajouter un
Accès au nœud »
graphe par le
menu
contextuel de
l’Application Traitement
Bouton
« Mise en
Exploitation »
Graphe de l’Application
Sélectionnez le bouton « Ajouter un nœud ». Avec le bouton gauche de la souris, cliquez sous le dernier Traitement
« job3 ». Un nœud graphique apparaît.
Sélectionnez le bouton « Sélection ». Utiliser le menu contextuel nœud graphique nouvellement créé. Choisissez
l’item « Créer un Traitement ».
Exemple :
Créez un Traitement. Insérez les paramètres suivants :
Script
Mode
d’exécution
Unité de
soumission
Utilisateur
Queue
Batch
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 58/183
Visual TOM Guide Administrateur
Sur GCOS7, dans la bibliothèque « SITE.JCL », créez un membre « J-VALID » avec le contenu suivant :
$JOB J-VALID ;
SEND ‘TRAITEMENT SOUMIS PAR VISUAL TOM’ ;
$ENDJOB ;
Exécutez le Traitement ; celui-ci doit se terminer correctement.
3.5.1 Pré-requis
La validation des pré-requis doit être réalisée avec le Responsable Systèmes/Réseaux du site.
Dans le cas d’une installation initiale, une bande magnétique 18 pistes contenant le nom de l’UMC « VAB0T00 » est
fournie. Dans le cas d’une réinstallation ou une mise à jour de l’agent, le fichier « ABM.C » est livré via ftp ou sur
bande magnétique.
3.5.2 Installation
A. Mise à jour sur GCOS8
Copiez le contenu de la bande magnétique sur le système GCOS8. La copie de la bande magnétique créera deux
catalogues : TOM et TOM-V1.
• EXEC,
• FIC,
• JCL ,
• SRC.
Dans le catalogue VTOM-V1, le répertoire « FIC » de la base de données de la workstation wd est créé.
C. Compilation
Assurez vous que le source est prévu pour un fonctionnement en mode « snumb » alétaoire, sans mode « privity ».
Vérifiez que le fichier « ABM.C » livré dans le répertoire « TOM/SRC » contient les valeurs ci-dessous :
int flag_snumb_attribute = 0 ;
int mode_privity = 0 ;
Compilez le fichier source « ABM.C ». La compilation du fichier créera un fichier objet « ABM.O » dans le répertoire
« TOM/SRC ».
CWD TOM
CWD SRC
NSC ABM.C F=OM O=ABM.O
Compilation du fichier ABM.C
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 59/183
Visual TOM Guide Administrateur
Lancez le JCL « ABM.L » à partir du répertoire TOM/SRC. L’édition des liens créera un exécutable « ABM.V » dans le
répertoire « TOM/EXEC ».
$ SELECT VAB0T00/TOM/JCL/IDENT
$ LKED
$ RESOURC VSPACE=300K
$ LIMITS 100,100K,,75000,,15K
$ PRMFL O*,R,R,VAB0T00/TOM/SRC/ABM.O
$ PRMFL O1,R,R,VAB0T00/TOM/SRC/CSGCOS.O
$ PRMFL V*,W,R,VAB0T00/TOM/EXE/ABM-N.V
$ prmfl cl,q,r,sys_rcv/w3cv00r12000/lib.oml
$ data n*
$ ascii
GENERATE_RUN_UNIT -FC v* -NAME abm & -ENTRY C$ENTRY
LIBRARY -FC cl -language sockets -S
INCLUDE -FC O1
SOFTWARE_STACK_SEGMENT 6k -USE_DATA_STACK
CREATE_REFERENCE -SYMREF C$PROGRAM & -SYMREF EASEE$ENTRIES
CREATE_HEAPS -DATA 128k -DESC_HEAP 1K
JCL d’édition de liens ABM.L
Mettez à jour le fichier « sys_etc/services » du système GCOS8 en fonction des ports définis sur le serveur Visual
TOM :
F. Démarrage de l’agent
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 60/183
Visual TOM Guide Administrateur
• un nom de Machine,
• une Queue Batch de nom « $job$ »,
• une Application,
• un Traitement.
Création de l’Agent
Utilisez le menu principal « Domaine/Machines ». Créez l’Agent avec création automatique de l’Unité de Soumission.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 61/183
Visual TOM Guide Administrateur
Bouton
« Sélection »
Bouton
« Ajouter un
Accès au nœud »
graphe par le
menu
contextuel de
l’Application Traitement
Bouton
« Mise en
Exploitation »
Graphe de l’Application
Sélectionnez le bouton « Ajouter un nœud ». Avec le bouton gauche de la souris, cliquez sous le dernier Traitement
« job3 ». Un nœud graphique apparaît.
Sélectionnez le bouton « Sélection ». Utiliser le menu contextuel nœud graphique nouvellement créé. Choisissez
l’item « Créer un Traitement ».
Exemple :
Créez un Traitement. Insérez les paramètres suivants :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 62/183
Visual TOM Guide Administrateur
Script
Mode
d’exécution
Unité de
soumission
Utilisateur
Queue
Batch
Sur GCOS8, dans le répertoire «TOM/JCL », créez un JCL « JVTOM » avec le contenu suivant :
$ IDENT VAB0T00, S **VTOM**
$ RUN RUFILE=VAB0TOO/TOM/EXE/TBEGIN.V
$ RESOURC VSPACE=1000K, CSSIZE=400K
$ LIMITS VSPACE=100, 100K, , 100K, , 16K
$ WORKST VTOM, PERM, 40
$ PRMFL HT, Q, S, SYS_ETC/HOSTS
$ PRMFL WD, Q, R, VAB0T00/VTOM-V1/FIC/WD
$ DATA CZ
$ TSTEP 2 [adresse IP du serveur Visual TOM] [port de tomDBd]
Exécutez le Traitement ; celui-ci doit se terminer correctement.
• reportez le paramétrage existant sur le nouveau fichier ABM.C (gestion des snumbs, mode privity),
• reportez le paramétrage des numéros de port
• arrêtez l’agent,
• compilez
• éditez les liens,
• démarrez l’agent.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 63/183
Visual TOM Guide Administrateur
3.6.1 Pré-requis
La validation des pré-requis doit être réalisée avec le Responsable Systèmes/Réseaux du site.
Utilisez un système de transfert de fichiers tel que ftp pour copier les fichiers d’installation sur le système VMS.
! Certains systèmes de transfert de fichiers VMS ne respectent pas le format des fichiers ; leur utilisation pour la copie
de l’archive peut provoquer des erreurs dans la phase d’installation.
A partir de votre accès ftp, copiez les deux fichiers d’installation VTOM035.A et VTOM035.B sur le répertoire
précédemment créé.
Fichiers d’installation
Selon le type de machine (Digital Alpha ou Vax), copiez l’utilitaire « FIX_SAVESET_ALPHA » ou « FIX_SAVESET_VAX »
dans le répertoire d’installation.
Utilitaires VMS
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 64/183
Visual TOM Guide Administrateur
3.6.3 Installation
A. Mise en place de l’archive
Copiez l’utilitaire FIX_SAVESET du répertoire d’installation vers le répertoire « sys$system » à l'aide de la commande
"copy" VMS.
Procédure
Utilisez la procédure d’installation standard « VMSINSTALL » pour installer l’agent Visual TOM.
La procédure « VMSINSTALL » doit être exécutée sous le compte « SYSTEM » ; elle se déroule en mode interactif avec
la convention syntaxique suivante, en précisant où se trouvent les fichiers d’installation (distribution volumes) :
@ sys$update:vmsinstal
* Do you want to continue anyway [NO]? Yes
* Are you satisfied with the backup of your system disk [YES]?
* Where will the distribution volumes be mounted: DKB300:
* Products: vtom
* Enter installation options you wish to use (none):
* Indiquez votre support pour installer VTOM035 ex : dua2 ? dkb300:
* Indiquez l'Owner de l'application, exemple : 500,1 ? 500,1
*Pouvons-nous commencer l'installation de VTOM035 [O/n] ?
*Enter the products to be processed from the next distribution volume set.
Products:
Procédure d’installation : les valeurs à utiliser sont indiquées en gras.
Particularité
La procédure d’installation crée un compte utilisateur VMS « VTOM035 ». Ce compte est en charge de
l’administration de l’agent Visual.
Le compte utilisateur « VTOM035 » est créé à l’état inactif avec un mot de passe expiré.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 65/183
Visual TOM Guide Administrateur
Remarque :
Si le mot de passe n’est pas modifié, il sera nécessaire de le changer lors de la prochaine connexion.
Etablissez une connexion avec l’utilisateur SYSTEM. Editez le fichier « sys$startup:vtomstartup.com » pour prendre
en compte la modification des symboles suivants :
deassign /system
TOM_LITTLE_ENDIAN
Remarques :
• La variable d’environnement positionnée par la commande « tstep » est « TOM_JOB_POINT ».
• Le terminal renvoie par défaut la chaîne en minuscules. Utilisez la commande « tstart » avec des noms
d’arguments en minuscules.
Exemple :
tstart "prod" "app" "job1"
Après l’installation, il est impératif de vérifier la cohérence entre le propriétaire, le groupe défini lors de la procédure
d’installation, et les attributs du répertoire d’installation. Effectuez cette vérification avec la commande suivante :
$dir/sec vtom$root:[000000...]
Contrôle des attributs du répertoire d’installation
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 66/183
Visual TOM Guide Administrateur
Modifiez éventuellement le propriétaire des fichiers Visual TOM en remplaçant 500,1 par le propriétaire et le groupe
corrects et DKB300 par le disque où s'est faite l'installation, en agissant ainsi :
$set file/owner=<500,1> VTOM$ROOT:[000000...]*.*
$set file/owner=<500,1> DKB300:[000000]VTOM035.DIR
Correction des paramètres d’installation
Toujours avec une connexion établie sous le compte « SYSTEM », activez la startup ainsi :
$@ sys$startup:vtomstartup.com
Les Traitements Visual TOM sont soumis dans la Queue Batch « VTOM$BATCH »., créée pendant la phase
d’installation avec une seule entrée. Cette unique entrée est utilisée par le processus associé à l’agent. Modifiez la
Queue Batch ainsi pour définir le nombre d’entrées :
set queue VTOM$BATCH /job_limit=<valeur>
Paramétrage de queue batch VTOM$BATCH
Controlez que l’agent est actif dans la queue batch « VTOM$BATCH » ainsi :
$ sh ent
Contrôle de l’activité de l’agent
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 67/183
Visual TOM Guide Administrateur
Création de l’Agent
Utilisez le menu principal « Domaine/Machines ». Créez l’Agent avec création automatique de l’Unité de Soumission.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 68/183
Visual TOM Guide Administrateur
Bouton
« Sélection
» Bouton
« Ajouter un
Accès au nœud »
graphe par le
menu
contextuel de
l’Application Traitement
Bouton
« Mise en
Exploitation »
Graphe de l’Application
Sélectionnez le bouton « Ajouter un nœud ». Avec le bouton gauche de la souris, cliquez sous le dernier Traitement
« job3 ». Un nœud graphique apparaît.
Sélectionnez le bouton « Sélection ». Utiliser le menu contextuel nœud graphique nouvellement créé. Choisissez
l’item « Créer un Traitement ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 69/183
Visual TOM Guide Administrateur
Script
Mode
d’exécution
Unité de
soumission
Utilisateur
Queue
Batch
Pour utiliser les commandes Visual TOM avec des paramètres comportant des majuscules, passez ces paramètres
! entre guillemets.
3.7.1 Pré-requis
Le système d’exploitation MVS ou Z/OS doit disposer de TCP/IP et JES2. La version du système d’exploitation
Z/OS doit être supérieure ou égale à la version V1R11.
Le port TCP de l’agent doit être indiqué dans le fichier « TCPIP.ETC.SERVICES » sous la forme :
bdaemon 30004/tcp
Quand le traitement est soumis, il produit des compte-rendus d’exécution. Ces compte-rendus sont visualisables :
S’il y a une installation précédente de l’agent Visual TOM, vous pouvez la sauvegarder ou la désinstaller.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 70/183
Visual TOM Guide Administrateur
Pour contrôler la présence ou l’absence d’utilisation des numéros de ports de communication, effectuez les actions
suivantes :
Sur le système Z/OS, la modification du numéro de port implique un redémarrage du processus agent.
! L’agent lance les travaux et informe le serveur lorsque le moteur demande l’état du traitement.
A. Arrêt de l’agent
Depuis TSO/ISPF, utilisez la commande STOP : « P SBDAEMON », si l’agent a été lancé en STC, sinon utilisez la
commande STOP : « P JBDAEMON ».
3.7.4 Désinstallation
Arrêtez l’agent (cf paragraphe ci-dessus) et supprimez les DataSets d’installation, ainsi que le fichier
« [userid].VTOM[version].SPOOL » contenant les données concernant les travaux en cours.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 71/183
Visual TOM Guide Administrateur
Les fichiers « VTOM[version].JCL.XMI » et « VTOM[version].LOAD.XMI » doivent être transférés en mode binaire par
FTP, à partir de votre accès ftp vers le répertoire d’accueil de l’utilisateur Visual TOM.
3.7.6 Installation
L’installation de l’agent consiste à restaurer 2 DataSets contenant le programme exécutable et les JCLs, et
paramétrer le JCL de lancement de l’agent :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 72/183
Visual TOM Guide Administrateur
A. Démarrage de l’agent
• Depuis TSO/ISPF, utilisez la commande START : « S BDAEMON », par exemple sous l’option LOG de SDSF.
• Lancez le JCL JBDAEMON en utilisant le menu 3.4 avec l’action SUB. Vérifiez son lancement avec le menu
« SD.ST ».
! La charge de l’agent peut exiger la mise à jour du paramètre REGION, dans le JCL de lancement. L’utilisation multiple
de piles TCP/IP peut exiger l’utilisation d’une carte supplémentaire dans le JCL de lancement (exemple de définition
d’une pile TCP : « SYSTCPD DD DSN=TCPIP.DATA,DISP=SHR »).
! Le nom de l’Utilisateur de soumission n’est pas significatif. Le nom de la queue batch n’est pas significatif mais il est
recommandé de fournir un nom significatif tel que proposé ci-dessus.
Création de l’Agent
Utilisez le menu principal « Domaine/Agents ». Créez l’Agent avec création automatique de l’Unité de Soumission.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 73/183
Visual TOM Guide Administrateur
Bouton
« Sélection »
Bouton
Accès au « Ajouter un
graphe par le nœud »
menu
contextuel de
l’Application
Traitement
Bouton
« Mise en
Exploitation »
Graphe de l’Application
Sélectionnez le bouton « Ajouter un nœud ». Avec le bouton gauche de la souris, cliquez sous le dernier Traitement
« job3 ». Un nœud graphique apparaît.
Sélectionnez le bouton « Sélection ». Utiliser le menu contextuel nœud graphique nouvellement créé. Choisissez
l’item « Créer un Traitement ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 74/183
Visual TOM Guide Administrateur
Exemple :
Créez un Traitement. Insérez le JCL suivant :
Mode
d’exécution
Unité de
soumission
Queue Utilisateur
Batch
! Pour être réellement exécuté, le Traitement doit être en mode Exécution et mis en exploitation.
Exemple de JCL :
//JOBTEST JOB
// EXEC PGM=IEFBR14
3.7.8 Fonctionnalités
L’agent Z/OS autorise :
• l’utilisation de la ressource fichier, PDS ou membre de PDS, sans utilisation de caractères joker,
• l’utilisation de la ressource générique,
• l’utilisation de RVS pour gérer le paramétrage des travaux,
• l’arrêt d’un traitement,
• la consultation du script,
• la consultation des logs d’exécution : la sortie standard correspond à la sortie SYSLMESG, la sortie des erreurs
à JESJCL.
L’agent Z/OS ne dispose pas d’un mode commande (gestion des Ressources notamment). L’édition du script en
écriture n’est pas disponible.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 75/183
Visual TOM Guide Administrateur
Remarques :
• La fonctionnalité RVS est mise en œuvre par paramétrage du fichier vtom.ini du serveur comme indiqué ci-
dessous :
[VTOM_MVS]
actif=1
• La longueur de la chaîne à remplacer doit être identique à la longueur de la chaîne de remplacement.
• Les 2 mots clés particuliers : MAXRC et MINRC ne sont pas utilisés pour effectuer un remplacement de chaîne
mais pour valoriser les valeurs minimum et maximum du code retour.
Ce programme est livré sous forme de dataset, tout comme l’agent. La procédure d’installation est la même.
Un JCL modèle est fourni dans le dataset. Son paramétrage est effectué via une carte « DD » nommée « TSWINI »
utilisable sous forme de « SYSIN » ou de membre de bibliothèque.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 76/183
Visual TOM Guide Administrateur
planifie.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 77/183
Visual TOM Guide Administrateur
3.8.1 Principe
Le principe des clusters (exemples : MC Service Guard pour HP, HACMP pour IBM, MS Cluster pour Microsoft) est
d'utiliser l'une des machines réelles en activité et l'autre en attente. Lorsque la machine « en activité » n'est plus
opérationnelle, la machine en attente en reprend l'activité et les ressources, à l’initiative du cluster.
Schéma de principe
Des scripts et procédures sont disponibles pour l’arrêt /relance des processus serveur.
L’accusé de réception de fin d’un traitement (commande « tsend ») doit répondre au nœud actif. Le nœud actif n’est
pas obligatoirement celui qui a initié la demande de soumission. Dans un contexte standard hors cluster, la
commande « tsend » s’adresse au serveur en faisant référence à la valeur de la variable « TOM_REMOTE_SERVER ».
Pour pouvoir répondre au nœud actif, indépendamment de la valeur de « TOM_REMOTE_SERVER », il est nécessaire
de valoriser la variable « TOM_SERVER_CLUSTER » sur les nœuds hébergeant le module Serveur.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 78/183
Visual TOM Guide Administrateur
Remarque :
Il est conseillé de déclarer cette variable sur les nœuds du cluster :
! Le démarrage des moteurs est conditionné par la configuration mise en place. Pour disposer d’un démarrage
automatique des moteurs en cas de bascule, le paramétrage suivant doit être effectué :
• Sur windows, ajouter dans la section « [GLOBALES] » du fichier « vtom.ini » le paramètre suivant :
restartEngine=1
• Sur unix, ajouter dans la section « [GLOBALES] » du fichier « .vtom.ini » le paramètre suivant :
restartEngine=1
Le package agent est installé sur les différents nœuds du cluster susceptibles de prendre le relai. Les services Visual
TOM sont actifs sur l’ensemble des nœuds si la ressource disque est partagée (répertoire des logs), sinon le seul
l’agent actif est celui du nœud opérationnel.
Dans ce cadre l’agent est actif sur l’ensemble des nœuds. L’applicatif est adressé par une machine logique. Pour
chaque machine logique est associé un répertoire log (traces d’exécutions). Si la ressource n’est pas partagée par les
agents, elle est basculée par le cluster.
Pour que l’agent Visual TOM soit opérationnel dans ce contexte, l’administrateur doit :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 79/183
Visual TOM Guide Administrateur
[CLUSTER]
applicatif_paie:1
applicatif_2:1
applicatif_3:1
[applicatif_paie]
ABM_LOGS:/vtom/applicatif_paie/logs
[applicatif_2]
ABM_LOGS:/vtom/applicatif_2/logs
[applicatif_3]
ABM_LOGS:/vtom/applicatif_3/logs
Extrait du paramétrage agent
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 80/183
Visual TOM Guide Administrateur
Dans ce cadre l’agent est basculé sur un nœud où un agent est déjà actif. Pour rendre possible la cohabitation de
plusieurs agents sur un même nœud, il est impératif de :
• disposer d’un administrateur Visual TOM différent sur les 2 nœuds (ex : vtom1 et vtom2),
• disposer d’un répertoire d’installation différent sur les 2 nœuds (ex : /vtom1 et /vtom2),
• mettre à jour le fichier de configuration .vtom.ini des agents susceptibles de se retrouver sur le même nœud.
Remarque :
Dans le référentiel, la déclaration de la machine doit soit adresser l’adresse IP de l’agent (package à basculer), soit un
alias.
[general]
BindIP=192.90.84.102
Extrait du paramétrage agent
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 81/183
Visual TOM Guide Administrateur
4 MODULES XVISION
Le module IHM (Interface Homme Machine) permet de concevoir les modèles de planification et d’ordonnancement,
et d’en assurer le pilotage.
Remarques :
• L’utilisateur doit disposer de droit d’écriture sur le répertoire temporaire de l’utilisateur au sein du système ;
le paramètre « java.io.tmpdir » permet de surcharger cet emplacement.
• Si nécessaire, le fichier de configuration « VtomXvision.l4j.ini », à créer dans le répertoire où se trouve
VtomXvision.exe, permet de préciser ce paramètre.
• Les paramètres surchargeables dans le fichier « VtomXvision.l4j.ini »sont les suivants :
-Dvtom.user.language=en
-Dvtom.java.io.tmpdir=.
-Dvtom.user=TOM
-Dvtom.password=TOM
-Dvtom.cpassword=xxx
-Dvtom.server=localhost:30007
-Dvtom.desktop=mydesk
• Ces paramètres sont également surchargeables dans la commande java de lancement de l’interface.
4.1.1 Pré-requis
La version du module IHM doit être la même que celle du serveur Visual TOM.
Remarque :
L’installation d’un module IHM est intégrée à l’installation du module Serveur.
! La procédure décrit l’installation d’un module IHM sur un serveur où ni module Serveur ni module Agent n’est
installé. Le cas échéant, procédez à une installation de serveur Unix, décrite précédemment.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 82/183
Visual TOM Guide Administrateur
A. Désinstallation
B. Transfert de l’archive
Copiez les archives du dossier représentant le module à installer vers le répertoire temporaire d’installation. Les
fichiers copiés sont :
Pour la copie de ces fichiers, 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 :
Positionnez-vous dans le répertoire d’installation temporaire où vous avez extrait les fichiers, sous l'utilisateur root,
et effectuez les actions suivantes :
• décompressez l’archive
• restaurez le répertoire « visual »
• modifiez les droits d’accès,
• associez la variable TOM_VISUAL au profil des utilisateurs de l’interface.
Exemple :
cd /usr/vtom
uncompress VT-XVI-HPUX.51.Z
cd visual
chmod +x *
Mettez à jour le profil des utilisateurs susceptibles d’utiliser l’interface. Assurez-vous que la variable DISPLAY est bien
! positionnée. Assurez-vous de la disponibilité de JAVA.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 83/183
Visual TOM Guide Administrateur
D. Validation de l’installation
Positionnez-vous dans le répertoire où a été installé le module, sous l'utilisateur root, et effectuez les actions
suivantes :
Exemple :
export TOM_VISUAL=.
./VtomXvision.ksh
Fenêtre de connexion.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 84/183
Visual TOM Guide Administrateur
Remarques :
Certains répertoires ou fichiers ne seront pas supprimés après la désinstallation :
• Le fichier « vtom.ini » situé dans le répertoire %windir% 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 répertoires modifiés après l'installation (ex: la base de données locale) qui pourront être conservés, ou
être supprimés par le gestionnaire de fichiers.
• Si un module serveur et/ou agent était installé auparavant, les variables d’environnement système préfixées
par TOM ou ABM (exemple « TOM_BIN ») ne sont pas supprimées. La variable PATH n’est pas mise à jour.
Remarque :
Pour éviter que l’utilisateur n’installe d’autres modules, un package ne contenant que l’interface est disponible.
Lancez l’exécutable.
Il est recommandé de ne pas utiliser un nom de répertoire comprenant des espaces, caractères accentués et
! caractères spéciaux.
Cliquez sur le bouton « Suivant » ; la fenêtre du choix des modules à installer est affichée.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 85/183
Visual TOM Guide Administrateur
Cliquez sur le bouton « Suivant » sur les fenêtres suivantes jusqu’à la fenêtre ci-dessous :
Finalisation de l’installation
Remarque :
Il n’est pas nécessaire de redémarrer le poste client pour finaliser l’installation.
C. Validation de l’installation
Cliquer sur le raccourci « IHM Visual TOM » se trouvant dans le groupe de programmes généré par l’installation. La
fenêtre de connexion s’affiche.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 86/183
Visual TOM Guide Administrateur
Fenêtre de connexion.
Les messages issus du serveur sont restitués dans la langue d’installation du serveur (exemples : échec de connexion,
résultat de la simulation d’une intégration de lot,…).
Ce composant est installé soit en complément de l’interface graphique, et accessible directement via cette interface,
soit en mode stand-alone.
B. Validation de l’installation
En mode stand-alone :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 87/183
Visual TOM Guide Administrateur
Remarque :
Le module WYSIWYG est opérationnel sur les plateformes Windows 32/64, Solaris X86 et Linux.
Pour effectuer la mise en œuvre du module, décompressez l’archive fournie par le support dans le répertoire
« visual ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 88/183
Visual TOM Guide Administrateur
• exploration du référentiel,
• pilotage,
• gestion des bureaux.
Remarques :
• Cette fonctionnalité est opérationnelle uniquement avec le serveur http fourni.
• Le navigateur doit accepter les cookies.
• Les comptes Visual TOM déclarés authentifiés via LDAP sont pris en compte.
• Le nom du serveur doit être renseigné et connu au niveau des alias hosts, local ou DNS. Le nom du host est
utilisé dans l’URL.
! L’authentification LDAP est soumise à l’utilisation d’un module externe Java ; la commande java doit être disponible
et indiquée dans le PATH au démarrage du processus.
5.1.1 Désinstallation
La désinstallation est manuelle. Les actions particulières relatives aux composants d’une version inférieure ou égale à
5.2 sont les suivantes :
Il est recommandé d’utiliser un système Windows disposant d’un lecteur CD-ROM et de transférer par FTP le
package du CD-ROM vers le système Unix.
Remarque :
L’installation du serveur http Visual TOM est intégrée à l’installation du module Serveur.
! La procédure décrit l’installation sur un serveur où ni module Serveur ni module Agent n’est installé. Le cas échéant,
procédez à une installation de serveur Unix, décrite précédemment.
Copiez l’archive du dossier représentant le module à installer vers le répertoire temporaire d’installation. Le fichier
copié est « <module.os.version> » (archive du module serveur à installer (le serveur comprend le serveur http).
Pour la copie de ce fichier, il est recommandé d’utiliser un système Windows, disposant d’un lecteur CD-ROM, et de
transférer le fichier par FTP. Les modes de transfert du fichier est « bin ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 89/183
Visual TOM Guide Administrateur
• décompressez l’archive,
• restaurez le fichier vthttpd dans le répertoire « $TOM_BIN »,
• restaurez le fichier vthttpd.ini dans le répertoire « $TOM_ADMIN »,
• restaurez le répertoire « www » dans le répertoire « $TOM_HOME »,
• modifiez les droits d’accès,
• créez un lien vers vthttpd.ini à partir de « $TOM_HOME ».
Exemple :
cd /usr/vtom
uncompress VT-XVI-HPUX.51.Z
cd vtom/bin
chmod +x vthttpd
cd /usr/vtom
ln –s admin/vthttpd.ini vthttpd.ini
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 90/183
Visual TOM Guide Administrateur
Etablissez la connexion, en précisant un compte utilisateur et son mot de passe pour accéder au Domaine.
5.2.1 Désinstallation
Les actions relatives aux composants d’une version inférieure ou égale à 5.2 sont les suivantes :
Exemple :
Suppression du service :
cd /d %TOM_BIN%\..\services
instsrv Visual_TOM_Iserver -remove
Suppression du service
Les actions relatives aux composants d’une version supérieure ou égale à 5.3 sont réalisées en utilisant le setup.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 91/183
Visual TOM Guide Administrateur
Etablissez la connexion, en précisant un compte utilisateur et son mot de passe pour accéder au Domaine.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 92/183
Visual TOM Guide Administrateur
5.3 PARAMÉTRAGE
Le portail est préconfiguré : il est directement opérationnel et utilise les ports par défaut.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 93/183
Visual TOM Guide Administrateur
Remarque :
La visibilité des logs d’exécution et des consignes est assujettie à un mode de mise à jour dynamique des pages.
Pour Unix, le fichier de paramétrage est nommé vthttpd.ini et est stocké dans le répertoire « $TOM_ADMIN ».
Pour Windows, le fichier de paramétrage est nommé vthttpd.ini et est stocké dans le répertoire « %windir% ».
Les ACL sont définis par une liste d’adresses où les éléments sont séparés par une virgule. Chaque sous-réseau est
préfixé de « + » pour autorisation, « - » pour interdiction.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 94/183
Visual TOM Guide Administrateur
Exemples :
# Autorisation de l’adresse 127.0.0.1
httpAcl=+127.0.0.1/32
Exemples :
Windows
@echo off
set OPENSSL_CONF=c:\OpenSSL-Win32\bin\openssl.cfg
@rem Generate a Private Key
openssl genrsa -des3 -out server.key 1024
@rem Generate a CSR (Certificate Signing Request)
openssl req -new -key server.key -out server.csr
@rem Remove Passphrase from Key
copy server.key server.key.org
openssl rsa -in server.key.org -out server.key
@rem Generating a Self-Signed Certificate
openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt
@rem Merge Certificate and Private Key
type server.key > vthttpd.crt
type server.crt >> vthttpd.crt
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 95/183
Visual TOM Guide Administrateur
Unix
#!/bin/sh
# Generate a Private Key
openssl genrsa -des3 -out server.key 1024
# Generate a CSR (Certificate Signing Request)
openssl req -new -key server.key -out server.csr
# Remove Passphrase from Key
cp server.key server.key.org
openssl rsa -in server.key.org -out server.key
# Generating a Self-Signed Certificate
openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt
# Merge Certificate and Private Key
cat server.key > vthttpd.crt
cat server.crt >> vthttpd.crt
Sur Windows, le démarrage du service est automatique. Toutefois, le processus peut être lancé en ligne de
commande :
vthttpd -console
Sur unix, le démarrage automatique du processus doit être intégré aux procédures de démarrage du système par
l’administrateur du système. Toutefois, le processus peut être lancé en ligne de commande :
nohup /vtom/vtom/bin/vthttpd &
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 96/183
Visual TOM Guide Administrateur
La sécurisation des flux est intégrée sur tous les échanges entre les différents modules : serveur/moteur, agents
Windows/Linux/Unix, interface graphique, mode commande. Le protocole TLS V1.2 est pris en charge.
Si un Visual TOM Enterprise Server et un Visual TOM Backup Server sont utilisés, la configuration SSL doit être mise
en place pour chacun d’eux ; Si un Visual TOM Enterprise Server et un Visual TOM Departmental Server sont utilisés
(pour gestion des mises en production), la configuration SSL doit être mise en place pour chacun d’eux.
Pour implémenter un certificat spécifique, le fichier server.crt doit être positionné à la racine de l’installation de
Visual TOM.
Les ports « svtserver » (30017 par défaut), « svtnotifier » (30018 par défaut) doivent être indiqués dans le fichier des
services, en complément des services existant. Cette déclaration induit la vérification du certificat et de la clé privée,
et donc l’usage de SSL. Le port de « vtapiserver » (30002 par défaut) est défini dans son fichier de configuration
« vtomapiserver.ini » stocké dans le répertoire « [install]/vtom/bin ».
Pour que les échanges soient sécurisés, l’interface doit se connecter sur le port de « svtserver ». Aucune
configuration n’est nécessaire. Lorsque ce mode est utilisé, un cadenas est affiché dans le bandeau bas de la fenêtre
principale. Un clic sur ce cadenas affiche le certificat.
Exemple de certificat
Le port « sbdaemon » (30014 par défaut) et le port de « svtmanager » (30010 par défaut) doivent être indiqués dans
le fichier des services, en complément des services existant. Cette déclaration induit l’usage de SSL. Dans ce cas, le
mode commande utilisé dans les traitements soumis par l’agent bénéficie de l’échange sécurisé.
Remarques :
❑ La déclaration de l’Agent dans le référentiel doit indiquer l’usage de SSL (Agent et Manager).
❑ Le suivi des Agents et le suivi des Managers indique si le mode SSL est utilisé.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 97/183
Visual TOM Guide Administrateur
Pour que les échanges soient sécurisés, à partir d’une commande Visual TOM lancée manuellement sur le serveur ou
sur un agent, la variable d’environnement « TOM_SSL » doit être valorisée manuellement à 1.
Pour que les échanges soient sécurisés, à partir d’une commande Visual TOM lancée via l’Agent, le fichier de
configuration « .vtom.ini » doit contenir une section pour chaque commande autorisée, et le paramétrage associé.
Ci-dessous un exemple :
[VTEXPORT]
SSL=1
Lorsque le serveur est démarré par les scripts d’administration, le fichier de configuration « vthttpd.ini » doit
contenir :
svtserver=[numéro de port sécurisé]
L’entrée par défaut « vtserver » ne doit pas être utilisée.
Lorsque le serveur est démarré manuellement sous le compte d’administration Visual TOM sans utiliser les scripts,
l’utilisateur en interactif doit exporter la variable « TOM_SSL » avec pour valeur « 1 ».
Dans tous les cas, le fichier de configuration « vtom.ini » doit contenir une section « [VTHTTPD] » avec :
SSL=1
Lorsque le serveur est démarré par les scripts d’administration, le fichier de configuration « vtomapiserver.ini » doit
contenir :
port=[numéro de port sécurisé]
Pour simplifier la configuration des processus « vt* » et des commandes « vt* », la section « [GLOBALES] » doit
contenir :
SSL=1
Remarques :
❑ En configuration primaire / backup, il est impératif d’invalider SSL pour le processus « vtserver » du primaire
et du backup, en précisant leur paramétrage :
[GLOBLALES]
SSL=1
[VTSERVER]
SSL=0
❑ Le processus server API REST n’est pas pris en charge par la configuration globale définie dans le fichier
« vtom.ini ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 98/183
Visual TOM Guide Administrateur
Visual TOM propose de restreindre la liste des répertoires contenant des scripts à exécuter, pour un compte
d’exécution sur une machine. Une vérification est effectuée avant exécution du script ; si le répertoire n’est pas
autorisé pour l’utilisateur indiqué dans la définition du Traitement, le Traitement est statué en erreur.
Pour que cette sécurisation soit prise en compte par un agent, la section « BDAEMON » doit être renseignée.
Remarque :
Le caractère séparateur des éléments autorisés est la virgule.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 99/183
Visual TOM Guide Administrateur
Le module IgraphBuilder a pour objet la génération de pages html et de graphes svg représentant un état
d’avancement de la production Visual TOM. Il s’appuie sur les disponibilités du Domaine Visual TOM et du serveur
http Visual TOM.
Remarques :
• Cette fonctionnalité est opérationnelle uniquement avec le serveur http fourni.
• La configuration du serveur http doit indiquer un mode de rafraîchissement permanent.
Remarque :
Les fichiers peuvent être décompressés dans le répertoire « www » dans lequel sont installés les fichiers du portail
web.
• cd [rep_install]
• java –jar IgraphBuilder.jar
Décompressez le fichier igraphbuilder.zip livré dans le répertoire « Installation » dans le répertoire de votre choix.
Remarque :
Les fichiers peuvent être décompressés dans le répertoire « www » dans lequel sont installés les fichiers du portail
web.
• cd [rep_install]
• java –jar IgraphBuilder.jar
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 100/183
Visual TOM Guide Administrateur
8.3 PARAMÉTRAGE
IgraphBuilder est préconfiguré : il est directement opérationnel et utilise les ports par défaut. La personnalisation des
pages est réalisable en modifiant les scripts xsl et/ou le fichier css fourni.
Exemple (Windows) :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 101/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 102/183
Visual TOM Guide Administrateur
Le serveur Visual TOM reçoit du moteur une information de fin de traitement. En fonction du paramétrage du
traitement, une alarme est transmise à l’agent SNMP.
L’agent SNMP formate ces alarmes au format SNMP, puis émet les traps vers le port UDP 162 (port standard). La
machine destinataire des traps est désignée dans un fichier de configuration Visual TOM.
L’agent est composé de 2 processus : l’un est chargé de l’envoi des traps, l’autre de l’interrogation de la Mib.
Remarque :
L’agent utilise le protocole SNMP V1.
Il est nécessaire de mettre à jour le fichier de configuration « .vtom.ini » pour activer SNMP.
9.2.1 Installation
L’agent est pré-installé lors de l’installation du module Serveur. Les éléments spécifiques à l’agent SNMP ont la
localisation suivante :
Remarque :
L’agent peut être installé sur un serveur différent de celui qui héberge le serveur Visual TOM.
• Transférez l’archive VT-XFR-SNMP-<OS>.<version>.Z dans le répertoire cible de votre système Unix, en mode
binaire,
• Installez le package ainsi :
cd <repertoire cible>
zcat VT-XFR-SNMP-<OS>.<version>.Z | tar xf - .
Remarque :
Il n’est pas indispensable d’être connecté sous le compte « root » pour installer l’agent. Habituellement, un compte
« vtom » est créé, qui est propriétaire de l’arborescence Visual TOM et assure la gestion des processus.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 103/183
Visual TOM Guide Administrateur
Remarque :
Si l’agent est hébergé sur un autre serveur que celui qui héberge le serveur Visual TOM, le fichier des services doit
également être modifié sur le serveur Visual TOM.
• port : port de l’agent SNMP Visual TOM déclaré dans le fichier « services »
• Host_Trap : machine ou IP vers laquelle les Traps SNMP de l’agent SNMP Visual TOM sont routées.
• entreprise : paramètre fixe
• Oid_Text_Trap : paramètre fixe
• Oid_Code_Trap : paramètre fixe
• portTrap : port vers lequel sont routées les traps (par défaut, port 162)
• portVtomMib : port utilisé pour l’interrogation de la Mib
• community : nom de la communauté (public (valeur par défaut), private ou security)
Remarque :
La casse doit être respectée. Seule la communauté « public » est prise en compte.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 104/183
Visual TOM Guide Administrateur
Pour démarrer les processus automatiquement, adaptez la procédure start_servers.snmp, ou adaptez la procédure
start_servers. Ces procédures sont localisées sous « $TOM_ADMIN ».
Remarque :
L’arrêt des processus serveur nécessite un redémarrage de l’agent SNMP.
Il est nécessaire de mettre à jour le fichier de configuration « vtom.ini » pour activer SNMP.
9.3.1 Installation
Les éléments spécifiques à l’agent SNMP ont la localisation suivante :
Remarques :
• L’agent peut être installé sur un serveur différent de celui qui héberge le serveur Visual TOM.
• Le fichier vtom.con peut être positionné dans un autre répertoire. Pour cela, déclarez une variable
d’environnement %TOM_ADMIN%, créez le répertoire correspondant, et déposez le fichier dans ce
répertoire.
Pour installer l’agent en complément d’un module déjà installé, utilisez le package VT-XFR-SNMP.
Remarque :
Si l’agent est hébergé sur un autre serveur que celui qui héberge le serveur Visual TOM, le fichier des services doit
également être modifié sur le serveur Visual TOM.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 105/183
Visual TOM Guide Administrateur
• port : port de l’agent SNMP Visual TOM déclaré dans le fichier « services
• Host_Trap : machine ou IP vers laquelle les Traps SNMP de l’agent SNMP Visual TOM sont routées.
• entreprise : paramètre fixe
• Oid_Text_Trap : paramètre fixe
• Oid_Code_Trap : paramètre fixe
• portTrap : port vers lequel sont routées les traps (par défaut, port 162).
• portVtomMib : port utilisé pour l’interrogation de la Mib.
Remarque :
La casse doit être respectée. Seule la communauté « public » est prise en compte.
Remarque :
L’arrêt des processus serveur nécessite un redémarrage de l’agent SNMP.
9.4.1 Installation
Les éléments spécifiques à l’intégration ont la localisation suivante, sur Unix :
Remarque :
L’intégration de la MIB dans les différents Frameworks varie selon le Framework, sa version, le système
d’exploitation, les procédures d’utilisation en vigueur chez l’agent.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 106/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 107/183
Visual TOM Guide Administrateur
Le fichier tsnmp.reg doit être généré dans le répertoire /etc/snmp/conf. La structure est la suivante :
Agents =
{
{
name= “tsnmp”
substrees = { 1.3.6.1.4.1.2190.166 }
timeout = 2000000
watch-dog-time = 86400
port = 20161
}
}
Le fichier tsnmp.rsrc est facultatif. Sa localisation est répertoire /etc/snmp/conf. La structure est la suivante :
Resource =
{
{
registration_file = “/etc/snmp/conf/tnsmp.reg”
policy = “spawn”
type = “legacy”
command = “<rep install vtom >/vtom/bin/tsnmp –s”
}
}
Le fichier vtom.con doit être copié sous $TOM_ADMIN ou le répertoire local au binaire tnsmp.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 108/183
Visual TOM Guide Administrateur
Les processus de Visual TOM fonctionnent en mode Client / Serveur Le protocole de communication utilisé est
TCP/IP.
• les processus de gestion des objets de la production : accès à la base de données, connexions avec les IHM et
mises à jour à partir de ces IHM, connexions avec les API REST publiques et mode commande,
• les processus d’ordonnancement appelés moteurs.
• sous Unix, les exécutables associés à ce processus sont installés dans le répertoire référencé par la variable
$TOM_BIN,
• sous Windows, les exécutables associés à ce processus sont installés dans le répertoire
<répertoire_installation>\vtom\bin.
Le module serveur comprend un processus « vtmonitor » lancé automatiquement par le processus « vtserver ».Ce
processus « vtmonitor » est dédié à la gestion des alarmes :
• sous Unix, l’exécutables associé à ce processus est installé dans le répertoire référencé par la variable
$TOM_BIN,
• sous Windows, l’exécutable associé à ce processus est installé dans le répertoire
« <répertoire_installation>\vtom\bin ».
Le processus vtserver lance 3 threads (vtserver, vtnotifier, tomDBd). 3 ports de communication sont utilisés (un pour
chaque thread).
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 109/183
Visual TOM Guide Administrateur
• l’exécutable associé aux Moteurs est localisé sur le répertoire pointé par la variable d’environnement
TOM_BIN,
• pour chaque environnement actif, le moteur associé effectue des tâches de planification, d’ordonnancement
et de surveillance de l’activité des agents de Visual TOM.
Pour chaque entité d’un Environnement (Application et Traitement), les tâches d’ordonnancement sont les
suivantes :
• évaluation de la planification,
• évaluation des contraintes horaires de début et de fin,
• évaluation des dépendances (liens),
• évaluation des ressources,
• demande de soumission à l’Agent.
• suivi de l’activité des Agents pour les travaux en cours.
Leur utilisation est sécurisée et nécessite la création de jetons de sécurité à partir de l’interface.
L’agent correspond au processus « bdaemon ». Lorsque l’agent démarre il se met en écoute sur un port :
• Sous Unix, l’exécutable associé au processus se trouve dans le répertoire référencé par la variable
$ABM_BIN.
• Sous Windows, l’exécutable associé au processus se trouve dans le répertoire
<répertoire_installation>\abm\bin.
Remarque :
Sur Windows, l’agent peut être lancé à partir d’un explorateur ou d’une invite de commande ; dans ce cas, les actions
d’arrêt et de démarrage à partir du suivi des Agents ne sont pas opérationnelles.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 110/183
Visual TOM Guide Administrateur
Le manager correspond au processus « vtmanager ». Ce processus a pour objectif de prendre en charge les mises à
jour des agents Unix, Linux et Windows, pilotées depuis l’interface graphique. Il est installé sur chaque système
hébergeant un processus agent Unix, Linux ou Windows.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 111/183
Visual TOM Guide Administrateur
Le module Interface graphique comprend un seul processus (VtomXvision). Il établit la connexion sur le port du
processus « vtserver » :
Sous Unix, l’exécutable associé au processus se trouve dans le répertoire associé à la variable $TOM_VISUAL,
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 112/183
Visual TOM Guide Administrateur
Deux menus d’administration des processus de Visual TOM sont disponibles dans le répertoire $TOM_ADMIN :
Option 1 :
Option 2 et 3 :
Option 4 :
Option 5 :
Option 6 :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 113/183
Visual TOM Guide Administrateur
• Appel de l’interface graphique. Cet appel est opérationnel uniquement si les processus serveur sont actifs.
Option 7 :
• Appel de l’utilitaire de sauvegarde vtbackup, quel que soit l’état des processus serveur. La base est
sauvegardée dans le répertoire $TOM_BACKUP.
Option 1 :
• Affiche le processus agent, avec l’état des queues batch prises en charge.
Option 2 et 3 :
Option 4 et 5 :
Le démarrage des processus serveur est tracé dans le fichier « serveurs.log ». Le démarrage des processus manager
et agent est tracé dans le fichier « client.log ».
Pour éviter que ces fichiers ne remplissent l’espace disque, il est nécessaire de gérer leur taille, avec par exemple
l’utilitaire externe « logrotate ». Cet utilitaire doit être installé et configuré par l’administrateur système.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 114/183
Visual TOM Guide Administrateur
Les exécutables associés aux processus serveur et agent sont lancés automatiquement lors du démarrage de la
machine. Ils apparaissent en tant que services sous Windows. Les processus sont démarrés et/ou arrêtés à partir de
la fonction « Démarrer\programmes\Paramètres\Panneau de configuration\Services ».
Remarque :
Un moteur peut être lancé interactivement par la commande « estart [environnement] ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 115/183
Visual TOM Guide Administrateur
12 CONFIGURATION DU SERVEUR
Les numéros de ports de communication sont définis dans le fichier /etc/services pour un système Unix ou dans le
fichier %windir%\system32\drivers\etc\services pour un système Windows.
Ces numéros de communication ont des valeurs identiques sur toutes les machines utilisant Visual TOM ; les valeurs
par défaut de ces ports de communication sont les suivantes :
Pour Unix, les variables d’environnement sont définies dans le fichier « vtom_init.[$SHELL] ». Elles sont positionnées
dans le shell courant lors de l’ouverture de session de l’administrateur Visual TOM, et connues des processus soumis
par cet utilisateur.
Pour Windows, une partie des variables d’environnement est définie sur le système. Ces variables sont de type
système. Tout utilisateur connecté hérite de ces variables.
D’autres variables sont issues du fichier de paramétrage vtom.ini (ex : répertoire des bases)
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 116/183
Visual TOM Guide Administrateur
Remarque :
La prise en compte d’une nouvelle variable système induit un redémarrage de la machine.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 117/183
Visual TOM Guide Administrateur
Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du serveur; c’est un fichier caché
nommé « .vtom.ini ».
Sous Windows, ce fichier est généré au cours de la phase d’installation du serveur dans le répertoire %windir%.
On y trouve notamment :
Remarques :
• Une modification du fichier concernant les traces ne nécessite pas un redémarrage des processus serveur,
moteur et agent. La modification est prise en compte après 60 secondes.
• Toute autre modification de ce fichier nécessite un redémarrage des processus concernés.
• Le fichier vtom.ini / .vtom.ini peut être déplacé ; créez la variable d’environnement %TOM_INI_PATH% /
$TOM_INI_PATH et indiquez les répertoires de recherche.
Sous Unix, ce fichier est généré dans répertoire $TOM_BIN lors de l’installation du serveur.
Sous Windows, ce fichier est généré au cours de la phase d’installation du serveur dans le répertoire %TOM_BIN%.
On y trouve notamment :
Remarques :
• Toute modification du fichier de configuration nécessite un redémarrage du processus.
• En cas de mise à jour de version, le fichier de paramétrage doit être mis à jour s’il a été personnalisé lors de
l’installation ou mise à jour précédente.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 118/183
Visual TOM Guide Administrateur
Par défaut, la connexion à la base de données ne demande pas de mot de passe. Pour sécuriser l’accès, procédez
comme indiqué dans la procédure ci-dessous.
Remarques :
• Un compte en lecture seule est disponible : « vtomro » (pas de mot de passe).
• En configuration primaire backup, la gestion des mots de passe doit être alignée.
• La récupération d’une base de données à partir d’une sauvegarde réalisée par « vtbackup » doit être en
cohérence avec la configuration de l’accès (voir la procédure de mise à jour des fichiers vtom.ini et
.pgpass/pgpass.conf ci-dessous).
• La base de données doit être démarrée.
cd $TOM_HOME/sgbd/bin
./psql -U vtom –h localhost –p <port vtsgbd>
ALTER USER vtom WITH PASSWORD '<nouveau mdp vtom>' VALID UNTIL 'infinity';
ALTER USER vtomadmin WITH PASSWORD '<nouveau mdp vtomadmin>' VALID UNTIL 'infinity';
\q
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 119/183
Visual TOM Guide Administrateur
[VTOM_SGBD]
cd $TOM_HOME/sgbd/share/postgresql
vi pg_hba.conf.sample
--- lignes impactées : 83/86 et 91
#host all all all @authmethodhost@
local all all all md5
#host replication @default_username@ all @authmethodhost@
host replication @default_username@ all md5
--- lignes impactées : 83/86 et 91
cd $TOM_BASES/sgbd
vi pg_hba.conf
--- lignes impactées : 87/90 et 95
#host all all all @authmethodhost@
local all all all md5
#host replication @default_username@ all @authmethodhost@
host replication @default_username@ all md5
--- lignes impactées : 87/90 et 95
Dans le répertoire d’accueil du compte d’administration de Visual TOM, créez un fichier « .pgpass » avec les droits
600.
cd $HOME
vi .pgpass
----- début du contenu du fichier
<nom du serveur>:<n°de port vtsgbd>:*:vtomadmin:<nouveau mdp vtomadmin >
<nom du serveur>:<n°de port vtsgbd>:*:vtom:< <nouveau mdp vtom>
cd /d %TOM_HOME%/sgbd/bin
psql -U vtom –h localhost –p <port vtsgbd>
ALTER USER vtom WITH PASSWORD '<nouveau mdp vtom>' VALID UNTIL 'infinity';
ALTER USER vtomadmin WITH PASSWORD '<nouveau mdp vtomadmin>' VALID UNTIL 'infinity';
\q
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 120/183
Visual TOM Guide Administrateur
cd /d %ABM_BIN%
bcrypt <nouveau mdp vtom>
bcrypt <nouveau mdp vtomadmin>
[VTOM_SGBD]
cd /d %TOM_HOME%/sgbd/share
notepad pg_hba.conf.sample
--- lignes impactées : 83 et 86
host all all 0.0.0.0/0 md5
local all all md5
--- lignes impactées : 83 et 86
cd /d %TOM_HOME%/bases/sgbd
notepad pg_hba.conf
--- lignes impactées : 85 et 88
host all all 0.0.0.0/0 md5
--- lignes impactées : 85 et 88
Dans le répertoire des données d’applications du compte du service « AbsyssSGBD », créez un fichier
« pgpass.conf ».
cd /d %APPDATA%/postgresql
notepad pgpass.conf
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 121/183
Visual TOM Guide Administrateur
Sur le primaire une entrée doit être ajoutée dans le fichier « .pgpass » ou « pgpass.conf » en fonction de
l'architecture sous la forme :
<nom du serveur de backup>:<numéro de port vtsgbd>:*:vtomadmin:<nouveau mdp vtomadmin >
<nom du serveur primaire>:<numéro de port vtsgbd>:*:vtomadmin:<nouveau mdp vtomadmin >
Sur le backup une entrée doit être ajoutée dans le fichier « .pgpass » ou « pgpass.conf » en fonction de l'architecture
sous la forme :
<nom du serveur primaire>:<numéro de port vtsgbd>:*:vtomadmin:<nouveau mdp vtomadmin >
<nom du serveur de backup>:<numéro de port vtsgbd>:*:vtomadmin:<nouveau mdp vtomadmin >
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 122/183
Visual TOM Guide Administrateur
13 CONFIGURATION DE L’AGENT
Les numéros de ports de communication sont définis dans le fichier /etc/services pour un système Unix ou dans le
fichier %windir%\system32\drivers\etc\services pour un système Windows.
Remarque :
Les autres ports, décrits sur le serveur, sont néanmoins utilisés par certaines commandes. Dans certains cas,
l’utilisation de tous les ports peut être justifiée.
Pour Unix, les variables d’environnement sont définies dans le fichier « vtom_init.[$SHELL] ». Elles sont positionnées
dans le shell courant lors de l’ouverture de session de l’administrateur Visual TOM, et connues des processus soumis
par cet utilisateur.
Pour Windows, une partie des variables d’environnement est définie sur le système. Ces variables sont de type
système. Tout utilisateur connecté hérite de ces variables.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 123/183
Visual TOM Guide Administrateur
Remarque :
La prise en compte d’une nouvelle variable système induit un redémarrage de la machine. Ces variables sont
définies dans le registre Windows.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 124/183
Visual TOM Guide Administrateur
Sous Unix, ce fichier est généré dans répertoire $TOM_ADMIN lors de l’installation du serveur; c’est un fichier caché
nommé « .vtom.ini ».
Sous Windows, ce fichier est généré au cours de la phase d’installation du serveur dans le répertoire %windir%.
On y trouve notamment :
Remarque :
Une modification de ce fichier nécessite un arrêt / relance des processus.
Sous Unix, l’agent assure naturellement la substitution d’identité ; le Traitement est exécuté sous le compte indiqué
dans les caractéristiques du Traitement dans le référentiel.
Sous Windows, le compte de service associé à l’agent (AbsyssBatchManager) est « LocalSystem » par défaut.
• indiquer au niveau du service un compte utilisateur particulier ; dans ce cas, tous les travaux sont soumis
avec les droits de ce compte, indépendamment des caractéristiques du Traitement,
• indiquer au niveau du service un compte disposant de droits spécifiques, et paramétrer le fichier de
configuration vtom.ini afin que la substitution d’identité puisse se faire, conformément aux caractéristiques
du Traitement.
Les droits requis sur le compte de service pour assurer la substitution sont les suivants :
Le fichier vtom.ini doit contenir le domaine, l’utilisateur, son mot de passe crypté avec l’utilitaire bcrypt, pour
pouvoir effectuer la substitution d’identité.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 125/183
Visual TOM Guide Administrateur
Lorsque la substitution d’identité est mise en place, et que le Traitement doit être soumis sous le compte du service
sans pour autant indiquer ce compte avec son mot de passe dans le fichier de configuration « vtom.ini », le
Traitement doit disposer d’une variable « TOM_IMPERSONATE » ayant pour valeur 1 (onglet Contexte de la
définition du Traitement).
Remarques :
• Pour que l’utilisateur de soumission du traitement dispose de ses lecteurs réseaux, la gestion des utilisateurs
doit être activée ainsi que l’option « users_logon » (section « BDAEMON »).
• Les mots-clés de la section « USERS » doivent être renseignés sous la forme [user][n] où n représente un
chiffre. La séquence numérique doit être respectée.
• Sur Windows 2008, le lancement du service « détection de services interactifs est nécessaire s’il doit y avoir
interaction.
• Sur Windows 2008, le compte administrateur utilisé ne doit pas être affecté à un groupe contenu dans un
autre groupe.
• Les noms longs ou comportant des caractères spéciaux sont gérés avec des alias.
• La modification de paramétrage est prise en compte sans nécessité d’arrêt/relance des procesus.
• La substitution d’identité est opérationnelle avec le compte de service « LocalSystem ».
• Les droits associés aux utilisateurs sont respectés, l’Agent ne s’octroie pas automatiquement des droits qui
ne lui sont pas conférés.
• L’accès à un répertoire ne doit pas être sujet à une validation interactive. Les droits doivent explicitement
donner l’accès au répertoire.
Par défaut, l’Agent ouvre une session sous le compte de soumission pour exécuter le Traitement, ce qui nécessite un
privilège pour ouvrir une session locale sur ce compte ; ce privilège est défini dans la stratégie de sécurité locale.
Pour exécuter un Traitement sous un compte de soumission ne disposant pas de ce privilège, il est nécessaire
d’associer la variable de Contexte « TOM_LOGON_MODE » au Traitement, avec la valeur « NETWORK » (la valeur par
défaut étant « LOGON ».
Cette variable peut également être associée à un Environnement ou une Application, une Unité de soumission ou un
Agent, et sera héritée par les Traitements.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 126/183
Visual TOM Guide Administrateur
Exemple :
[BDAEMON]
users=1
users_logon=1
[USERS]
user1=<domaine>,<utilisateur>,<mot de passe crypté>
user2=<domaine>,<utilisateur>,<mot de passe crypté>
user2.alias=Albert DUPONT
...
usern=<domaine>,<utilisateur>,<mot de passe crypté>
TRACE_LEVEL=0
Extrait du fichier vtom.ini
L’agent assure la gestion d’un ensemble de queues batch. Il y a deux solutions pour personnaliser l’exécution des
travaux :
Pour créer une nouvelle queue batch sur Unix, effectuez les opérations suivantes :
• créez un fichier tom_submit.xxx par copie du fichier tom_submit.ksh, dans le répertoire $TOM_ADMIN,
• effectuez votre personnalisation dans le fichier tom_submit.xxx,
• copiez le répertoire $ABM/config/queues/queue_ksh vers queue_xxx (cp –rp),
• modifiez le fichier $ABM/config/queues/queue_xxx/queue.conf en remplaçant ksh par xxx,
• créez un lien sous $ABM_BIN de xxx vers /bin/ksh (ln –s),
• relancez l’agent.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 127/183
Visual TOM Guide Administrateur
Exemple :
cd $TOM_ADMIN
cp –p tom_submit.ksh tom_submit.myq
cd $ABM/config/queues
cd queue_myq
vi queue.conf
queue_myq
10
-1
/vtom/abm/bin/myq
20
Contenu du fichier queue.conf
cd $ABM_BIN
ln –s /bin/ksh myq
Le fichier queue.conf utilise les 5 paramètres suivants (ordre d’apparition dans le fichier) :
• nom de la queue,
• nombre maximum de travaux en exécution simultanée,
• nombre maximum de travaux en attente,
• shell utilisé (chemin et nom ; le nom du shell doit être équivalent à l’extension du nom de la queue),
• priorité (paramètre obsolète).
Le fichier users indique le nombre maximum de travaux simultanés et le nombre maximum de travaux en attente
pour une liste d’utilisateurs.
Exemple :
Pour l’utilisateur oracle, 10 travaux peuvent s’exécuter simultanément, 5 travaux peuvent être en attente
oracle:10:5
Contenu du fichier users
Remarque :
La déclaration de l’utilisateur « any » dans le fichier users indique rend cette queue accessible à tous les utilisateurs.
Pour créer une nouvelle queue batch sur Windows, effectuez les opérations suivantes :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 128/183
Visual TOM Guide Administrateur
Le nombre de travaux simultanés est spécifié après le nom de la queue, dans le fichier vtom.ini.
Exemple :
cmd
cd /d %ABM_BIN%
Qu’il s’agisse d’Unix ou de Windows, le Traitement n’est pas soumis à partir du répertoire où le script est localisé.
! L’utilisation de chemins relatifs dans le script peut avoir un impact sur l’exécution. La personnalisation d’une queue
batch rend transparent l’utilisation relative ou absolue des chemins et fichiers dans le script.
Lors de la soumission d’un Traitement, le Moteur transmet à l’agent un ensemble de variables d’environnement. Les
principales variables sont affichées par la queue batch, et sont disponibles dans le compte rendu d’exécution du
Traitement.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 129/183
Visual TOM Guide Administrateur
TOM_JOB_POINT Valeur du label de reprise (valeur par défaut : 0). Cette valeur
alphanumérique est mise à jour soit manuellement dans l’interface,
soit automatique avec la commande vtstep.
Remarque :
La valeur de ces variables peut être utile pour la personnalisation d’une queue batch. La variable « JAVA_HOME »,
valorisée dans la queue batch pour définir la version de Java à utiliser, est surchargeable avec une variable associée à
la définition de l’Agent :
• JAVA_CMD : chemin d’accès direct à la commande java directement (prioritaire sur JAVA_HOME)
• JAVA_OPTS : positionnement d’une ligne d’options passées à java (prioritaire sur JAVA_TRACE_LEVEL et
JAVA_TRACE_SOURCE).
Sur Unix et Windows, tout traitement exécuté dispose de deux fichiers de traces d’exécution (logs), stockés dans le
répertoire $ABM_LOGS. Ces fichiers sont nommés comme suit :
Pour les autres systèmes d’exploitation, le format est spécifique (exemple : pour GCOS7, le Job Output Report est
stocké dans le fichier SYSOUT, son nom est identifié par le Run Output Number du traitement).
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 130/183
Visual TOM Guide Administrateur
Sur Unix uniquement, la gestion des priorités est prise en charge suite à :
La priorité est définie par un identifiant numérique contenu en suffixe du nom de la queue batch, dans le référentiel.
Exemple :
Gestion de la priorité sur la queue batch « queue_ksh » :
• création d’une queue batch « queue_ksh.0 » pour les Traitements non prioritaires,
• création d’une queue batch « queue_ksh.3 » pour les Traitements peu prioritaires,
• création d’une queue batch « queue_ksh.7 » pour les Traitements relativement prioritaires,
• création d’une queue batch « queue_ksh.10 » pour les Traitements prioritaires.
Paramétrez vtom.ini
[BDAEMON]
ABM_QUEUES_PRIORITY_INCREMENT:BY_ONE
Extrait du fichier vtom.ini
Remarques :
• Les Traitements ayant une priorité initiale à 10 la conservent et sont prioritaires quelque soit la priorité des
autres Traitements.
• Les Traitements ayant une priorité initiale à 0 la conservent.
• La priorité par défaut est 5.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 131/183
Visual TOM Guide Administrateur
Pour disposer d’une vision du code retour des travaux Unix et Windows dans l’interface graphique, il est nécessaire
d’utiliser l’option « -r » de la commande « tsend » située dans les queues batch. Par défaut, le code retour est affiché
(Unix / Windows).
Exemples :
…
call %TOM_SCRIPT% %arg%
set RETCODE=%ERRORLEVEL%
IF %RETCODE% EQ 0 goto TERMINE
…
:TERMINE
tsend -sT -r%RETCODE%
…
Aperçu partiel d’une queue batch de type Windows adaptée
L’activation des traces sur les connecteurs est réalisée en modifiant la ligne de commande dans la queue batch du
connecteur.
Ces traces sont opérationnelles sur les connecteurs prenant en charge les types de travaux suivants : WebServices,
AP BO, Transferts, Mail et Visual TOM.
Pour ajouter un niveau de trace, modifiez l’appel du connecteur comme indiqué ci-dessous
…
Java -Dtrace.level=[all|debug|info|warn|error|none] –jar $ABM_BIN/vtom2mail.jar $*
Pour ajouter l’affichage du fichier source, modifiez l’appel du connecteur comme indiqué ci-dessous:
…
Java -Dtrace.source=[0|1] –jar $ABM_BIN/vtom2mail.jar $*
Remarque :
Le niveau de traces par défaut est « info ». Par défaut, le fichier source n’est pas affiché.
17:04:00 | INFO | Vtom2Mail.java: 51 | Vtom2Mail : 5.6.1 EN NT 2013/08/30 Visual Tom (c) Absyss
17:04:00 | INFO | Vtom2Mail.java: 58 | Retrieve connection properties from environment
Extrait d’une trace d’exécution
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 132/183
Visual TOM Guide Administrateur
Pour pallier le gel d’un moteur issu d’une communication bloquante avec un agent ayant accepté une connexion et
ne pouvant répondre, le paramétrage du moteur implique la mise en place du paramètre :
• secureEngineTimeout, pour fixer le délai au-delà duquel le moteur est redémarré automatiquement après un
gel.
Remarque :
Ce mécanisme ne doit pas être mis en place par défaut. La mise en place doit avoir pour origine un gel constaté.
La mise en œuvre de ce paramètre nécessite une connaissance approfondie du paramétrage global et des
mécanismes associés.
…
[TENGINE:<nom>]
secureEngineTimeout=300
…
Exemple de paramétrage
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 133/183
Visual TOM Guide Administrateur
14 INTÉGRATION LDAP
Par défaut, l’utilisateur se connecte directement sans authentification LDAP. Un mot de passe est spécifié dans
l’objet « Compte utilisateur ».
Pour une connexion basée sur un attribut ou les groupes LDAP, le compte ne doit pas être créé dans Visual TOM.
• le paramétrage LDAP doit être validé par l’administrateur (accès par le bouton « paramètres »).
• la connexion LDAPS est établie par le serveur Visual TOM, le certificat du client doit être intégré dans le
répertoire « [rep_install]\vtom\bin ». La procédure d’import du certificat est indiquée dans le fichier
« ldapcheck.ini » stocké sous ce répertoire. Le stockage du certificat est personnalisable, via paramétrage de
ce fichier « ldapcheck.ini ».
Remarque :
Les paramètres indiqués sont uniques et utilisés par l’ensemble des comptes authentifiés via LDAP.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 134/183
Visual TOM Guide Administrateur
14.1 AUTHENTIFICATION
Utilisateur du Domaine
L’utilisateur du Domaine est le compte avec lequel la vérification est effectuée sur l’annuaire, pour authentifier le
compte de l’utilisateur qui se connecte à l’interface.
Base de recherche
Champ obligatoire. Arborescence à partir de laquelle est effectuée la recherche en fonction du critère défini dans
la base de recherche.
Filtre de recherche
Correspondance
Les autres paramètres de la zone Correspondance ne doivent pas être utilisés lorsque le compte est créé sur
Visual TOM.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 135/183
Visual TOM Guide Administrateur
Pour s’affranchir de la création des comptes dans Visual TOM et faire correspondre le profil définit dans l’AD avec un
profil existant dans Visual TOM, l’administrateur doit renseigner les éléments de correspondance.
Utilisateur du Domaine
L’utilisateur du Domaine est le compte avec lequel la vérification est effectuée sur l’annuaire, pour authentifier le
compte de l’utilisateur qui se connecte à l’interface.
Base de recherche
Champ obligatoire. Arborescence à partir de laquelle est effectuée la recherche en fonction du critère défini dans la
base de recherche.
Filtre de recherche
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 136/183
Visual TOM Guide Administrateur
Type de correspondance
Champ obligatoire. Le type indique si les droits sont basés sur les valeurs d’un attribut LDAP ou sur le nom des
groupes LDAP.
Champ obligatoire. Nom de l’attribut dans l’annuaire contenant la liste des profils (profilesVtom ci-dessus ; cet
attribut de l’annuaire contiendra une liste de profils Visual TOM). Le premier nom de profil valide est utilisé par
défaut.
Champ obligatoire. Caractère utilisé pour délimiter les noms de profils s’il y en a plusieurs.
Exemple :
Sur l’attribut « Description » d’un utilisateur de l’AD, l’administrateur indique une liste de noms de profils Visual
TOM séparés par une virgule.
Dans les paramètres LDAP Visual TOM, le champ « Attribut pour les profils » contiendra « Description ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 137/183
Visual TOM Guide Administrateur
Utilisateur du Domaine
Champ obligatoire. L’utilisateur du Domaine est le compte avec lequel la vérification est effectuée sur l’annuaire,
pour authentifier le compte de l’utilisateur qui se connecte à l’interface.
Base de recherche
Champ obligatoire. Arborescence à partir de laquelle est effectuée la recherche en fonction du critère défini dans la
base de recherche.
Filtre de recherche
Type de correspondance
Champ obligatoire. Le type indique si les droits sont basés sur les valeurs d’un attribut LDAP ou sur le nom des
groupes LDAP.
Type de LDAP
Champ obligatoire.
Correspondance automatique
La correspondance automatique indique que les noms des profils qui seront associés à l’utilisateur correspondent
aux noms des groupes LDAP. La non-correspondance automatique indique que les noms des utilisateurs ou des
groupes LDAP sont associés à des profils Visual TOM ; cette association est paramétrée dans l’onglet « Autorisation
LDAP » de la fenêtre « liste des comptes utilisateurs ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 138/183
Visual TOM Guide Administrateur
Remarque :
La liste des utilisateurs et groupes LDAP est affiché à partir du bouton situé à droite de la fenêtre.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 139/183
Visual TOM Guide Administrateur
15 CONFIGURATION DE L’INTERFACE
La configuration de l’interface est basée sur les ports de communication, sur le fichier de paramétrage
VTXVision.ini situé :
Exemples :
/home/exploit
Remarques :
• Aucune variable d’environnement n’est nécessaire.
• En mode pilotage, la vision du code retour d’exécution des travaux Unix et Windows, est assujetti au
paramétrage des queues batch.
15.1PORT DE COMMUNICATION
Remarque :
La déclaration de ces ports n’est pas obligatoire au niveau du fichier %windir%\system32\drivers\etc\services.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 140/183
Visual TOM Guide Administrateur
Valeur par
Section Nom Objet
défaut
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 141/183
Visual TOM Guide Administrateur
Pour l’item « documentation » de la section « vtom », le nom du répertoire contenant les consignes d’exploitation ne
! doit pas contenir la chaîne de caractères « webdoc ». Cette valeur surcharge celle qui est déclarée dans le fichier
« vtom.ini ».
Remarques :
Par défaut, le nom des fichiers docs et consignes est construit à partir du nom des objets, selon le modèle suivant :
Le paramètre « documentation » de la section « vtom » est issu du fichier vtom.ini du serveur. Si ce paramètre n’est
pas renseigné, c’est le paramètre du fichier « VtXVision.ini » qui est utilisé. Si ce paramètre n’est pas renseigné dans
un des deux fichiers, le chemin pris en compte est « [rep_install]/visual/doc ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 142/183
Visual TOM Guide Administrateur
Exemple :
[TRACE]
level=0
screen=1
directory=.
file=0
fileName=VTXvision.log
fileSize=-1
[SERVER]
hostName=localhost
serverPort=30007
lastUser=TOM
hostList=
[IHM]
hideMemoryWatcher=1
[NETWORK]
compressionLevel=9
[vtom]
#browser="C:\Program Files\Internet Explorer\iexplore.exe"
#documentation=http://localhost/documentation/localhost
documentation= F:\VT-documentation\www\localhost
Exemple de fichier VTXVision.ini
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 143/183
Visual TOM Guide Administrateur
16 CONFIGURATION DU MOTEUR
Pour intégrer un fichier d’export ou un lot de mise en production lors de la bascule de Date, le fichier de
paramétrage « vtom.ini » doit être configuré pour permettre l’exécution d’un script spécifique.
Dans la section « GLOBALES », le script est utilisé par tous les moteurs. Dans la section « TENGINE », le script est
utilisé par l’environnement concerné.
• Nom de l’environnement,
• Nom de la Date,
• Valeur de la Date au format jj-mm-aaaa.
Remarques :
❑ Quand la Date bascule (la fonction de « reset » est effectuée ainsi que la mise à jour de la Date), et si la
variable est positionnée avec un nom de script présent et accessible en lecture, ce script est exécuté. La fin
du script est bloquante pour la suite des actions du moteur.
❑ Un échec du script (code retour différent de 0), ou l’insuffisance de droits pour son exécution, provoque
l’arrêt du moteur. L’absence du script ne provoque pas l’arrêt du moteur. Dans tous les cas, l’arrêt du moteur
est historisé.
❑ Une trace indique le démarrage et la terminaison du script. Les traces doivent être activées.
❑ Pour un moteur, la bascule de 2 dates se fait toujours séquentiellement. Par contre, pour 2 moteurs traitant
une Date, les 2 exécutions peuvent être simultanées. Il faut donc veiller à la bonne écriture des scripts en cas
d’exécution concurrente.
❑ L’écriture du script est à la charge du client. Ce script doit vérifier s’il y a des lots de gestion des mises en
production à intégrer en exploitant la commande « vttdf », ou des fichiers d’export à intégrer. Dans tous les
cas, il faudra choisir des noms signifiants pour les lots et fichiers d’export.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 144/183
Visual TOM Guide Administrateur
Pour que le serveur accepte une commande en ligne sécurisée, 2 actions sont nécessaires :
Remarques :
❑ Le fichier de pré-authentification peut contenir plusieurs pré-authentifications vers des serveurs différents.
Ce fichier est nommé « .vtompass » et est stocké dans le répertoire d’accueil de l’utilisateur (par exemple,
cela correspond à %HOMEDRIVE%/%HOMEPATH% si ces variables sont définies, sinon à la valeur de la
variable %USERPROFILE% sur Windows 10).
❑ Le fonctionnement est restreint aux commandes « vt* » excepté : vtcmd, vtomkill, vttdf, vtmonitor, vthttpd,
tengine.
Exemple :
[rep_install]\vtom\vtom\bin\vtcmd /login /server antipodes /port 30007 /account TOM /password xxx
Exemple :
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 145/183
Visual TOM Guide Administrateur
• des Stratégies : une stratégie est un regroupement d’APIs et de méthodes. Les Stratégies sont associées aux
Jetons.
• des Jetons : un Jeton dispose d’une période de validité, de filtres IP et d’un ensemble de stratégies, est actif
ou non.
Remarques :
❑ La création de Stratégies et de Jetons de sécurité nécessite un droit dans le Profil de l’utilisateur.
❑ Les Jetons de sécurité sont utilisables à partir des entêtes http ou en paramètre de l’URL.
❑ Le serveur Visual TOM renvoie le port du serveur d’api à l’interface ; le serveur d’api doit être installé sur le
serveur Visual TOM, l’accès au port du serveur d’API doit être autorisé pour l’interface.
Portée
La portée de la stratégie liste les APIs utilisables. La sélection des APIs est facilitée par un filtre sur les actions et sur
les objets.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 146/183
Visual TOM Guide Administrateur
Filtrage
Le filtrage permet de restreindre les APIs sur des types d’objets en fonction de leur nom.
Le Jeton est valide uniquement lorsque la date d’utilisation est située dans la période définie.
Filtrage IP
Si aucun filtre n’est défini, toutes les adresses sont valides. Elles sont précisées en IPV4 et IPV6.
Exemples :
Uniquement l’adresse 192.90.84.99 : -0.0.0.0/0,- ::0,+192.90.84.99
Toutes les adresses sauf 192.90.84.99 : +0.0.0.0/0,+ ::0,-192.90.84.99
Uniquement les accès locaux : -0.0.0.0/0,-::/0,+::1,+127.0.0.0/8
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 147/183
Visual TOM Guide Administrateur
Pour obtenir de l’aide sur une commande, utilisez les commandes suivantes :
• [commande] –h
• vthelp [commande]
! L’utilisation du mode commande serveur sur une machine nécessite l’installation locale d’un module serveur.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 148/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 149/183
Visual TOM Guide Administrateur
Remarque :
La commande est autorisée sur le serveur Primaire et sur le serveur de Backup.
Un modèle de Traitement est disponible pour créer une sauvegarde de la base Visual TOM. Ce modèle doit être
utilisé par une action glisser/coller, de l’arbre du domaine vers un graphe d’Application.
Sélection du Modèle
Paramétrage du Traitement
19.4 PURGES
19.4.1 Statistiques
• Paramètre 1 : fonction (export, purge, liste des dates)
• Paramètre 2 : "date de début de de fin"
Remarque :
Avant la purge, les données peuvent être sauvegardées.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 150/183
Visual TOM Guide Administrateur
Exemple :
vtstools –e "22-10-2008 26-10-2008" > stats_20081022-20081026.dat
Un modèle de Traitement est disponible pour gérer les données statistiques. Ce modèle doit être utilisé par une
action glisser/coller, de l’arbre du domaine vers un graphe d’Application.
Sélection du Modèle
Paramétrage du Traitement
19.4.2 Historique
• Paramètre 1 : fonction (export, purge, liste des dates)
• Paramètre 2 : "date de début date de fin"
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 151/183
Visual TOM Guide Administrateur
Remarque :
Avant la purge, les données peuvent être sauvegardées.
Exemple :
vthtools –e "22-10-2008 26-10-2008" > stats_20081022-20081026.dat
Un modèle de Traitement est disponible pour gérer les données de l’historique. Ce modèle doit être utilisé par une
action glisser/coller, de l’arbre du domaine vers un graphe d’Application.
Sélection du Modèle
Paramétrage du Traitement
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 152/183
Visual TOM Guide Administrateur
19.5 SUIVI
Commande d’affichage des dates d’exploitation avec leur valeur : vtlist –v dates
19.5.2 Anomalies
Commande d’affichage des travaux en erreur : vtlist –v ENERREUR
19.5.3 Risques
Commande d’affichage des travaux retenus : vtlist –v retenu
Commande d’affichage des processus serveurs, moteurs et sessions (ihm et commande) : vtping
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 153/183
Visual TOM Guide Administrateur
Pour obtenir de l’aide sur une commande, utilisez les commandes suivantes :
• [commande] –h
• vthelp [commande]
L’utilisation du mode commande agent sur une machine nécessite l’installation locale d’un module agent. La variable
! TOM_REMOTE_SERVER indique à qui sont adressées les commandes.
Remarque :
Pour afficher le nom du serveur auquel s’adresse une commande en ligne lors de l’usage de cette commande,
l’utilisateur doit déclarer la variable « TOM_TRACE_REMOTE_SERVER » avec une valeur à 1.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 154/183
Visual TOM Guide Administrateur
Cet utilitaire, disponible pour Unix et Windows, est employée principalement dans la ressource générique, pour
étendre les capacités de la ressource fichier.
Exemple :
Vérifier qu’un fichier est présent et cohérent : si ce fichier existe, il ne doit pas être en cours de transfert ou utilisé
par un processus.
rem %1 : nom du fichier
rem %2 : nombre de fichier devant répondre à la sélection
tfile -m W -f %1
if "%ERRORLEVEL%" == "%2" goto OK
:KO
echo "Erreur : Il y a %ERRORLEVEL% fichier(s) correspondant a la sélection"
exit /B %ERRORLEVEL%
:OK
echo "Succès : il y a %ERRORLEVEL% fichier(s) correspondant a la sélection"
:fin
exit /B 0
Script Windows utilisant l’utilitaire tfile
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 155/183
Visual TOM Guide Administrateur
Commande Objet
vtlist Affiche des listes sur l’état des travaux, sur les objets du domaine
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 156/183
Visual TOM Guide Administrateur
vthelp Affiche une aide globale sur les commandes et sur le paramétrage (vtom.ini)
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 157/183
Visual TOM Guide Administrateur
vtplan Affiche la planification des traitements et applications pour une date ou plage
de date
vtping Affiche l’état des processus serveurs, moteurs et sessions (ihm et commande)
vttdf Gestion des lots de mise en production (listes, transfert, simulation, intégration)
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 158/183
Visual TOM Guide Administrateur
Commande Objet
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 159/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 160/183
Visual TOM Guide Administrateur
(**) : Les paramètres par défaut de la commande « tmail » peuvent être indiqués dans le fichier tmail.ini. Ces mêmes
paramètres peuvent être surchargés à l’exécution. Pour plus d’information sur les paramètres, utilisez la commande
« tmail –h » ou « vthelp tmail ».
Commande Objectif
VTLSTJOB Liste de toutes les tâches en exécution
VTLSTMSGW Liste des messages en attente de réponse dans
une queue de message
VTSNDRPLY Envoi d’une réponse à un message
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 161/183
Visual TOM Guide Administrateur
Processus serveur
GLOBALES SSL Serveur Agent 0 [1] Forçage du mode SSL pour l’ensemble des Commun
commandes en ligne.
classes_machines classe1 à classe[n] Tremote Liste des machines d’une classe sur lesquelles Commun
sont exécutées une commande à partir de
l’utilitaire tremote.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 162/183
Visual TOM Guide Administrateur
VTSERVER daemonNotChecked Serveur machine1, Désactive la vérification cyclique de l’état des Commun
machine2,… machines spécifiées.
Exemple : ACL=+192.90.84.0/24,-192.90.84.121
GLOBALES StatusFailSubmit Moteur ENERREUR Statut d’un Traitement qui n’a pu être soumis Commun
[ENCOURS, sur l’Agent.
DEPLANIFIE]
GLOBALES StatusFailExist Moteur ENERREUR Statut d’un Traitement soumis mais inconnu de Commun
[ENCOURS] l’agent lors d’un test d’activité.
GLOBALES delaiHost (*) Moteur 90 Délai d’attente en secondes entre 2 tentatives Commun
de connexion à un agent.
GLOBALES loglongnames bdaemo 1[0] Permet de réduire le nom des fichiers dont la Agent
n taille est limitée par le système d’exploitation Windows
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 163/183
Visual TOM Guide Administrateur
(valeur 0)
Log loglongnames bdaemo 1[0] Permet de réduire le nom des fichiers dont la Agent Unix
n taille est limitée par le système d’exploitation
(valeur 0)
GLOBALES maxLogSize Moteur 1 073 741 824 Taille maximum, exprimée en octets, pour
l’affichage des traces d’exécution.
GLOBALES maxScriptSize Moteur 10 485 760 Taille maximum, exprimée en octets, pour
l’affichage et l’édition des scripts.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 164/183
Visual TOM Guide Administrateur
GLOBALES AcceptOrItems Moteur 0 [1] Gestion des Liens OU. Les objets dont le nom Commun
est préfixé par « OU_ » ou « OR_ » sont
considérés comme étant un lien de type OU.
GLOBALES forceOrItemsToSimu Moteur [0] 1 Force la simulation (valeur « 1 ») sur le nœud Commun
représentant le « OU ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 165/183
Visual TOM Guide Administrateur
GLOBALES timeBexist Moteur 120 Cycle d’évaluation en secondes : vérification des Commun
ressources, des travaux en cours, et du temps
maximum d’exécution des traitements.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 166/183
Visual TOM Guide Administrateur
GLOBALES statusPileAll Moteur 0 [1] Statue le Traitement à chaque itération (valeur Commun
0) ou attend que la pile soit vide (valeur 1). En
cas d’erreur sur une itération, l’élément courant
n’est pas dépilé, les éléments restant à dépiler
subsistent dans la pile.
GLOBALES statusPileOne Moteur 0 [1] Traite le premier élément de la pile uniquement Commun
(valeur 1) ou l’ensemble (valeur 0).
GLOBALES fileresdelay (**) bdaemon 0 Intervalle de temps minimum en secondes sans Commun
modification du fichier, requis pour considérer
le fichier présent. Ce paramètre ne doit pas être
mentionné dans la déclaration de la Ressource
fichier.
GLOBALES fileresdelay1 bdaemon Optionnel. Pour être utilisé, ce paramètre doit Commun
être mentionné dans la déclaration de la
Ressource fichier et dans le fichier de
configuration.
GLOBALES fileresdelay2 bdaemon Optionnel. Pour être utilisé, ce paramètre doit Commun
être mentionné dans la déclaration de la
Ressource fichier et dans le fichier de
configuration.
GLOBALES fileresdelay3 bdaemon Optionnel. Pour être utilisé, ce paramètre doit Commun
être mentionné dans la déclaration de la
Ressource fichier et dans le fichier de
configuration.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 167/183
Visual TOM Guide Administrateur
GLOBALES nbJoursRattrapage (***) Moteur 2 [2 à 10] Nombre de journées à partir duquel le mode Commun
Rattrapage est activé (10 maximum)
GLOBALES JobBlockDateSyst Moteur 0 [1] Permet le blocage (valeur 1) d’une date de type Commun
système
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 168/183
Visual TOM Guide Administrateur
GLOBALES ResetDateOnAppCopy Serveur [0] 1 Permet d’affecter la date par défaut de Commun
l’environnement cible lors de la copie
d’application d’un environnement vers un autre
(valeur 1), ou partage la date entre les
environnements source et cible (valeur 0).
GLOBALES resetDateWithoutFlush Moteur [0] 1 Permet de réduire le temps de bascule de date. Commun
GLOBALES AppCheckDateValue Moteur 1 [0] Permet de valider un lien en tenant compte Commun
(valeur 1) de la cohérence de valeur de 2 dates
lorsque 2 applications liées disposent de dates
différentes.
GLOBALES deplan_obj Moteur 0 [1] Sur un traitement non planifié disposant de Commun
l’option « ne pas déplanifier les successeurs »,
et disposant d’un successeur lié par un lien
obligatoire, inhibe la déplanification de ce
successeur (valeur 1) ; le successeur reste à
venir.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 169/183
Visual TOM Guide Administrateur
GLOBALES relanceAppCycliqueEnErr Moteur 0 [1] Permet de continuer les cycles d’une Commun
eur Application de type cyclique même si son statut
est en erreur
GLOBALES relanceJobCycliqueEnErre Moteur 0 [1] Permet de continuer les cycles d’un Traitement Commun
ur de type cyclique même si son statut est en
erreur
GLOBALES relanceAppCycliqueDepla Moteur 0 [1] Permet de continuer les cycles d’une Commun
nParRes Application (valeur 1) de type cyclique si la
déplanification est due à l’invalidité d’une
Ressource, en prenant en compte la non
planification liée au paramètre resnopla.
GLOBALES relanceJobCycliqueDepla Moteur 0 [1] Permet de continuer les cycles d’un Traitement Commun
nParRes (valeur 1) de type cyclique si la déplanification
est due à l’invalidité d’une Ressource, en
prenant en compte la non planification liée au
paramètre resnopla.
GLOBALES usePriority Moteur 1 [0] Autorise (1) ou non (0) la gestion des priorités Commun
et affiche l’attribut dans l’interface graphique
(1) ou le masque (0). La section d’un moteur
peut surcharger la valeur globale « 1 » valeur
par « 0 ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 170/183
Visual TOM Guide Administrateur
GLOBALES AfterChangeOfDateCmdR Moteur 1 [0] Autorise (1) ou non (0) le renommage Commun
ename automatique du script en fin d’exécution.
VTOM_GCOS8 Actif vtserver 1 [0] Fournit l’accès aux contextes dans l’interface Commun
GLOBALES GNSP Moteur 0 [1] Prise en charge du gestionnaire réseau GNSP Commun
entre le Moteur et l’Agent GCOS8.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 171/183
Visual TOM Guide Administrateur
BDAEMON
VTSERVER
TSEND
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 172/183
Visual TOM Guide Administrateur
spécifiée.
BDAEMON ABM_QUEUES bdaemon queue_wnt :10 Prise en compte des queues batch listées, avec Agent
[,queue_xxx :n] pour chacune le nombre d’exécutions Windows
simultanées
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 173/183
Visual TOM Guide Administrateur
CLUSTER [nom machine logique] bdaemon 0 [1] Liste des machines logiques faisant partie du Commun
cluster pour visualisation des logs dans
l’interface
[nom machine ABM_LOGS bdaemon Répertoire des logs de la machine logique Commun
logique]
Gestion cluster
GLOBALES BindIP bdaemon Ecoute de l’agent sur une adresse précise pour Commun
autoriser une utilisation multiple d’agents sur
bstat une machine. La valeur correspond à une
adresse IP.
bdown
BDAEMON ABM_QUEUES_PRIORITY_ bdaemon BY_ONE Affecte une priorité au Traitement en file Agent Unix
INCREMENT d’attente, en fonction de la de la queue batch
associée.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 174/183
Visual TOM Guide Administrateur
BDAEMON ABM_QUEUES_PRIORITY_TRACES bdaemon NON [OUI] Affiche les traces spécifiques à la gestion des Agent Unix
priorités dans le fichier de traces de l’agent.
BDAEMON connectToServer bdaemon 0 [1] Supprime les initiatives de connexion de l’agent Commun
vers la zone de confiance. Les informations sont
stockées localement et récupérées à l’initiative
du Moteur (TSEND pour les fins d’exécution,
TVAL pour les modifications de ressources).
Gestion de l’historique
GLOBALES histo binaires 0 [1] Historise (valeur 1) les actions IHM et le mode Commun
serveur commande de l’agent local au serveur.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 175/183
Visual TOM Guide Administrateur
GLOBALES stats vtserver 1 [0] Enregistre les données statistiques d’exécution Commun
des applications et traitements.
BDAEMON ABM_LOGS bdaemon Répertoire contenant les traces d’exécution des Agent
traitements. Windows
Exemple : ACL=+192.90.84.0/24,-192.90.84.121
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 176/183
Visual TOM Guide Administrateur
GCOS7 CnxInfo ConnectionName bdaemon Nom de la session définie dans Amaril Agent
Windows
GCOS7 CnxInfo VisibleEmulator bdaemon 0 [1] Affichage des fenêtres de l’émulateur lors de la Agent
connexion. Windows
Serveur de backup
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 177/183
Visual TOM Guide Administrateur
GLOBALES TOM_TSEND_MAX_RETRY Mode 120 Nombre de tentatives maximum vers le serveur. Agent
commande
GLOBALES BACKUP_SYNC_TIMEOUT vtserver 900 Délai en secondes après lequel le serveur passe Serveur
en mode stand alone en cas d’erreurs de primaire
synchronisation avec le serveur de backup.
GLOBALES BACKUP_SYNC_TIMEOUT vtserver [backup_sync_ti Script exécuté lorsque le serveur passe en mode Serveur
_SCRIPT meout.bat / stand alone, depuis le répertoire TOM_BIN. Si la primaire
backup_sync_ti variable TOM_BIN n’est pas positionnée,
meout.sh]
le répertoire courant d’exécution est utilisé
(TOM_BASES).
Paramètres de connexion
VTOM_SGBD TRY_CONN_TIMEOUT vtserver 120 Délai maximum avant arrêt du processus Commun
« vtserver » en cas de perte de connexion avec
la base de données.
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 178/183
Visual TOM Guide Administrateur
Documentations et consignes
Gestion mémoire
GLOBALES MALLOC_ARENA_MAX binaires binaires Nombre de pools mémoire utilisés par GLIBC. Commun
(*****) serveur agent
UNIX
(**) Exemple de déclaration de la Ressource fichier : /repertoire/nomfichier(fileresdelay2). Le paramètre « fileresdelay » ne s’applique que sur le premier
fichier d’un masque (ex : *.csv).
(***) Rattrapage.
(****) La valeur 1 (TRACE_FILE_COUNT) désactive la rotation et ne tient pas compte de la taille maximum du fichier (TRACE_FILE_SIZE).
Remarques :
• Les paramètres liés au Moteur peuvent être spécifiques à un Environnement, en les utilisant dans la section « [TENGINE:<nom de
l’environnement>] ».
• L’édition immédiate d’un script depuis l’interface est conditionnée par la non utilisation du paramètre « fileresdelay ».
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 179/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 180/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 181/183
Visual TOM Guide Administrateur
Absyss ©
Réf : Visual TOM Guide administrateur - 651D.doc 182/183
Visual TOM Guide Administrateur
www.absyss.com
Absyss – 15/17, Boulevard du Général de Gaulle – 92120 Montrouge - Tel : 33 1 40 84 89 01 – Fax 1 40 84 88 40 – www.absyss.com
SAS au capital de 500.000 € - RCS Nanterre B 353 281 561 – APE 5829A – FR 94 353 281 561