CFT UNIX Guide D Exploitation

ClT Vcrsicn 2.
3
C2-UNIX-EXPL-23-01
ClT,V2,LNlX
CuiUc U'cx|ciIaIicn

Copyright
Le Code de la proprit industrielle nautorise, aux termes de larticle L.122-5 que les copies ou
reproductions strictement rserves lusage priv du copiste et non destines une utilisation
collective.
Toute reproduction totale ou partielle, toute transmission sous quelque forme ou par quel procd que ce
soit (lectronique ou mcanique, photocopie ou enregistrement) et toutes autres fins que lusage
personnel sans autorisation crite d'Axway Software est strictement interdite. Cette reprsentation ou
reproduction constituerait donc une contrefaon sanctionne par les articles L.335-2 et suivants du Code
de la proprit intellectuelle.
Axway Software, 2003. Tous droits rservs.
CFT V2.3 iii
Table des Matires
Prsentation du Guide d'exploitation CFT/V2/UNIX............................................................... x
Remarques sur les changements ou volutions apportes CFT/V2/UNIX..........................xi
1. Besoins matriels et systmes................................................................................................1-1
1.1. Besoins matriels.......................................................................................................................... 1-1
1.2. Pr requis systmes et logiciels .................................................................................................... 1-1
1.3. Besoins matriels.......................................................................................................................... 1-1
2. Installation de CFT/V2/UNIX..............................................................................................2-1
2.1. Procdure dinstallation cft_instal ................................................................................................ 2-1
2.1.1. But de la procdure............................................................................................................... 2-1
2.1.2. Ce que permet la procdure.................................................................................................. 2-1
2.1.3. Remarques et restrictions dinstallation ............................................................................... 2-2
2.2. Restauration de la procdure partir de son support.................................................................... 2-3
2.2.1. Cas du CD ROM.................................................................................................................. 2-3
2.2.2. Cas des autres mdias de livraison ....................................................................................... 2-4
2.3. Lancement de la procdure........................................................................................................... 2-4
2.3.1. Slection de la langue dinstallation..................................................................................... 2-5
2.3.2. Installation de CFT............................................................................................................... 2-5
2.4. Structure et contenu des rpertoires de CFT................................................................................. 2-6
2.5. Installation automatique de CFT (mode "batch") ......................................................................... 2-7
2.5.1. Remarques pralables........................................................................................................... 2-7
2.5.2. Phase 1 : sauvegarde du fichier modle................................................................................ 2-7
2.5.2.1. Localisation du fichier ".cft_instal.ini" ........................................................................ 2-7
2.5.2.2. Sauvegarde du fichier ".cft_instal.ini " ........................................................................ 2-8
2.5.2.3. Analyse du contenu du fichier ".cft_instal.ini" ............................................................ 2-8
2.5.3. Phase 2 : installation du CFT/UNIX pre........................................................................... 2-11
2.5.4. Phase 3 : Constitution du scnario de duplication.............................................................. 2-12
2.5.5. Phase 4 : Lancement de la procdure en mode batch......................................................... 2-12
3. Descriptif des utilitaires ........................................................................................................3-1
3.1. Prsentation .................................................................................................................................. 3-1
3.2. Liste alphabtique des utilitaires .................................................................................................. 3-1
3.3. Table de transcodage .................................................................................................................... 3-2
Table des Matires
CFT V2.3 iv
3.4. Utilitaires de gestion de CFT........................................................................................................ 3-2
3.4.1. cftinit .................................................................................................................................... 3-2
3.4.2. cftstart ................................................................................................................................... 3-3
3.4.3. cftstop................................................................................................................................... 3-4
3.4.4. cftupdate ............................................................................................................................... 3-6
3.4.5. cftutil .................................................................................................................................... 3-6
3.4.6. secinit.................................................................................................................................... 3-7
3.4.7. secupdate .............................................................................................................................. 3-7
3.5. Utilitaires de manipulation de CFT .............................................................................................. 3-8
3.5.1. cftcata ................................................................................................................................... 3-8
3.5.2. cftcatab ................................................................................................................................. 3-8
3.5.3. cftcatal .................................................................................................................................. 3-8
3.5.4. cftlog..................................................................................................................................... 3-9
3.5.5. cftalog................................................................................................................................... 3-9
3.5.6. cftparm.................................................................................................................................. 3-9
3.5.7. cftpart.................................................................................................................................... 3-9
3.5.8. cftdelcat .............................................................................................................................. 3-10
3.5.9. xfbadm................................................................................................................................ 3-10
3.5.10. xfbadmgrp......................................................................................................................... 3-11
3.5.11. xfbadmusr ......................................................................................................................... 3-12
3.6. Utilitaires caractre systme .................................................................................................... 3-13
3.6.1. cft2unix............................................................................................................................... 3-13
3.6.2. cftkey.................................................................................................................................. 3-13
3.6.3. cftversion............................................................................................................................ 3-14
3.6.4. cftping................................................................................................................................. 3-14
3.6.5. x25loop............................................................................................................................... 3-15
3.6.6. xvi ....................................................................................................................................... 3-17
4. Pralable la mise en uvre de CFT ..................................................................................4-1
4.1. Prsentation .................................................................................................................................. 4-1
4.2. Cl de protection logicielle........................................................................................................... 4-1
4.2.1. Obtention de la cl de protection.......................................................................................... 4-1
4.2.2. Prise en compte de la cl de protection ................................................................................ 4-1
4.3. Oprations de paramtrage ........................................................................................................... 4-1
CFT/V2/UNIX Guide dexploitation
CFT V2.3 v
5. Premiers lancements de CFT................................................................................................5-1
5.1. Prsentation .................................................................................................................................. 5-1
5.2. Test dinstallation de CFT en mode TCP ..................................................................................... 5-1
5.2.1. Paramtrage du moniteur CFT ............................................................................................. 5-1
5.2.2. Excution du test .................................................................................................................. 5-2
5.3. Test dinstallation de CFT en mode X25...................................................................................... 5-3
5.3.1. Rappel sur ladressage X25.................................................................................................. 5-4
5.3.3. Excution du test .................................................................................................................. 5-6
6. Mise en exploitation de CFT.................................................................................................6-1
6.1. Oprations de paramtrage ........................................................................................................... 6-1
6.2. Configuration du moniteur CFT................................................................................................... 6-1
6.2.2. Cration initiale des fichiers "Environnement CFT" et initialisation................................... 6-1
6.3. Activation et arrt de CFT............................................................................................................ 6-2
6.3.1. Activation de CFT par la commande cftstart........................................................................ 6-2
6.3.2. Activation automatique de CFT au dmarrage de la machine.............................................. 6-2
6.3.2.1. Usage du fichier /etc/inittab ......................................................................................... 6-2
6.3.2.2. Ajout dun fichier sous /etc/rc3.d................................................................................. 6-3
6.4. Arrt du moniteur CFT................................................................................................................. 6-3
6.4.1. Arrt de CFT laide de la commande cftstop..................................................................... 6-3
6.4.2. Arrt de CFT par lutilitaire CFTUTIL................................................................................ 6-4
6.4.3. Arrt brutal de CFT.............................................................................................................. 6-4
6.5. Excution de CFTUTIL................................................................................................................ 6-5
6.5.1. Activation ............................................................................................................................. 6-5
6.5.2. Saisie en mode ligne............................................................................................................. 6-5
6.5.3. Paramtres dactivation ........................................................................................................ 6-6
6.6. Prise en compte dutilisateurs supplmentaires............................................................................ 6-6
6.6.1. Extension du chemin de commande (PATH) ....................................................................... 6-6
6.6.2. Environnement daccs aux fichiers de CFT........................................................................ 6-7
6.6.2.1. Variables denvironnement utilises par CFT.............................................................. 6-7
6.6.2.2. Positionnement des variables denvironnement ........................................................... 6-8
6.6.3. Privilges et droits ncessaires ............................................................................................. 6-9
6.7. Remarques sur les procdures de basculement............................................................................. 6-9
6.7.1. Exemple de procdure de basculement : switch.cmd......................................................... 6-10
6.7.2. Exemple de procdure : basculement du fichier des statistiques........................................ 6-11
Table des Matires
CFT V2.3 vi
6.8. Exploitation des fichiers statistiques .......................................................................................... 6-12
6.8.1. Constitution de lexemple................................................................................................... 6-12
6.8.2. Excution du test ................................................................................................................ 6-13
6.9. Gestion des suffixes.................................................................................................................... 6-13
6.9.1. Dfinition des suffixes........................................................................................................ 6-13
6.9.2. Utilisation des suffixes avec CFT....................................................................................... 6-14
6.10. CFT et les fichiers temporaires................................................................................................. 6-15
6.10.1. Fichiers temporaires de CFT ............................................................................................ 6-15
6.10.2. Destruction des fichiers temporaires ................................................................................ 6-15
6.10.3. Exemple de procdure ...................................................................................................... 6-16
6.10.4. Identification de CFT ....................................................................................................... 6-16
6.11. Extension au modle client/serveur .......................................................................................... 6-17
6.11.1. Fichier de configuration cftinq.cfg ................................................................................... 6-17
6.11.2. Variable denvironnement CFTDIRINQ.......................................................................... 6-17
6.11.3. Usage en mode Client/Serveur ......................................................................................... 6-17
7. Fonctions interactives de CFT..............................................................................................7-1
7.1. Prsentation .................................................................................................................................. 7-1
7.2. Activation des fonctions interactives de CFT............................................................................... 7-1
7.3. Configuration des fonctions interactives ...................................................................................... 7-1
7.3.1. Taille des crans ................................................................................................................... 7-1
7.3.2. Gestion des touches de fonction........................................................................................... 7-1
7.3.3. Configuration de base........................................................................................................... 7-2
7.3.4. Modification de la configuration.......................................................................................... 7-2
8. Construction dapplications APIs CFT...............................................................................8-1
8.1. Introduction .................................................................................................................................. 8-1
8.2. Prsentation du kit de dveloppement .......................................................................................... 8-1
8.3. Exemple avec linterface de programmation................................................................................ 8-2
8.3.1. Constitution de lapplication ................................................................................................ 8-2
8.3.2. Excution du test .................................................................................................................. 8-2
8.4. Exemple dexit fichier .................................................................................................................. 8-3
8.4.2. Excution du test .................................................................................................................. 8-4
8.5. Exit annuaire................................................................................................................................. 8-4
8.5.1. Modifications raliser avant le test .................................................................................... 8-4
8.5.3. Excution du test .................................................................................................................. 8-6
CFT V2.3 vii
8.6. Exit Etebac3.................................................................................................................................. 8-7
8.6.1. Modifications raliser avant le test .................................................................................... 8-7
8.6.3. Excution du test .................................................................................................................. 8-9
8.7. Exit account .................................................................................................................................. 8-9
8.7.1. Constitution de lapplication .............................................................................................. 8-10
8.7.2. Excution du test ................................................................................................................ 8-10
8.8. Migration du Catalogue.............................................................................................................. 8-11
8.8.1. Quand migrer un catalogue ?.............................................................................................. 8-11
8.8.2. Rcupration du catalogue V220........................................................................................ 8-11
8.8.3. Catalogue en V220 ............................................................................................................. 8-11
8.8.3.1. Catalogue en CFT/V2/UNUIX................................................................................... 8-12
8.8.3.2. Ralisation de la copie................................................................................................ 8-12
8.8.4. Ralisation de la migration proprement dite....................................................................... 8-12
9. Utilisation des lments additionnels ...................................................................................9-1
9.1. Les composants additionnels ........................................................................................................ 9-1
9.2. Agent de notification XNTF......................................................................................................... 9-1
9.2.1. Arborescence de lagent XNTF............................................................................................ 9-1
9.2.2. Configuration de lagent XNTF ........................................................................................... 9-2
9.2.3. Dmarrage et Arrt de lagent XNTF................................................................................... 9-3
9.2.4. Paramtrage de CFT pour utilisation de lagent XNTF ....................................................... 9-4
9.2.5. Paramtrage de lagent XNTF.............................................................................................. 9-5
9.2.5.1. Quest-ce quun profil de remise ?............................................................................... 9-5
9.2.5.2. Paramtres de profil de remise pour QLT.................................................................... 9-6
9.2.5.3. Paramtres de profil de remise pour CFT .................................................................... 9-6
9.2.5.4. Configuration du filtre sur les tats de transfert ........................................................... 9-7
9.2.5.5. Configuration du filtre sur les messages du journal ..................................................... 9-8
9.3. Serveur IUI ................................................................................................................................... 9-9
9.3.1. Constituants du serveur IUI.................................................................................................. 9-9
9.3.2. Principes gnraux de fonctionnement du serveur IUI......................................................... 9-9
9.3.3. Configuration du serveur IUI ............................................................................................. 9-10
9.3.4. Lancement et arrt manuels du serveur IUI........................................................................ 9-11
9.3.5. Lancement et arrt automatiques du serveur IUI................................................................ 9-11
9.3.6. Contrle daccs au serveur IUI ......................................................................................... 9-12
10. Elments de scurit ..........................................................................................................10-1
10.1. Les composants livrs............................................................................................................... 10-1
10.2. Les modifications de paramtrage............................................................................................ 10-1
Table des Matires
CFT V2.3 viii
11. Mise en uvre du suivi Sentinel. ......................................................................................11-1
11.1. Composants livrs..................................................................................................................... 11-1
11.2. Paramtrage de CFT pour lutilisation de Sentinel................................................................... 11-1
A. Paramtrage spcifique.......................................................................................................A-1
A.1. Tableau des valeurs spcifiques.................................................................................................. A-1
A.2. Fichiers transfrables .................................................................................................................. A-1
CFT V2.3 ix
Liste des Tableaux
Tableau 1. Contenu des rpertoires de CFT (par ordre alphabtique) .................................................................... 2-6
Tableau 2. Codes derreur signals en installation de type batch ......................................................................... 2-13
Tableau 3. Liste alphabtique des utilitaires........................................................................................................... 3-1
Tableau 4. Paramtres de trace pour xfbadm........................................................................................................ 3-10
Tableau 5. Chemin d'accs aux fichiers.................................................................................................................. 6-7
Tableau 6. Arborescence de lagent XNTF ............................................................................................................ 9-1
Tableau 7. Fichiers de configuration de lagent XNTF .......................................................................................... 9-3
Tableau 8. Variables de personnalisation QLT....................................................................................................... 9-6
Tableau 9. Identifiant des filtres de transfert .......................................................................................................... 9-7
Tableau 10. Liste des certificats ............................................................................................................................. 10-1
Tableau 11. Valeurs spcifiques ...............................................................................................................................A-1
Tableau 12. Valeurs spcifiques : dfauts pour CFTUTIL.......................................................................................A-1
Tableau 13. Caractristiques de fichiers retrouvs automatiquement ou non l'mission .......................................A-1
Tableau 14. Valeurs de FTYPE et valeurs de FCODE implicitement associes en mission ..................................A-2
Tableau 15. Combinaisons de FTYPE et FRECFM l'mission..............................................................................A-2
Tableau 16. Valeurs de FTYPE et FRECFM la rception .....................................................................................A-2
CFT V2.3 x
Prsentation du Guide d'exploitation
CFT/V2/UNIX
Le prsent "Guide dexploitation" de XFB Monitor CFT V2 sur les machines UNIX a t conu
pour tre commun un maximum de plates-formes du march.
Les informations contenues dans le prsent document ne s'appliquent quaux versions de
CFT/V2/UNIX de souche technique V2.2.3 (ou suprieure) et gnres aprs le 15 fvrier 2001.
Les principaux changements ou volutions sont rsums page suivante.
Nous utiliserons dans ce document les termes gnriques de CFT/V2/UNIX ou de CFT pour
dsigner globalement le produit XFB Monitor CFT sur les diffrentes plates-formes UNIX.
Les aspects spcifiques un produit particulier sont rassembls dans un document ddi, prsent
sous la forme dun "Guide Technique CFT/V2/UNIX".
Dans certains cas, il pourra tre ncessaire de prciser une information pour un composant logiciel
donn ou pour une version spcifique de XFB Monitor CFT V2. Dans ce cas, un en-tte particulier
suivra la remarque.
Par exemple :
AIX pour une remarque spcifique un composant donn,
CD ROM pour une remarque qui ne sapplique pas un composant donn,
A230 pour une remarque spcifique une version donne,
+A223 pour une fonctionnalit disponible aprs une version donne de CFT.
Pour une bonne comprhension de certains concepts ou de la terminologie utilise dans ce guide, il
peut tre utile de se reporter aux manuels gnraux XFB Monitor CFT suivants :
"Concepts",
"Manuel de rfrence",
"Guide d'utilisation des fonctions interactives".
ainsi qu'aux diffrents manuels de votre systme dcrivant :
le fonctionnement des commandes de base,
la configuration du systme et des rseaux.
De plus, partir de la version 230 de XFB Monitor CFT, des informations complmentaires
peuvent tre obtenues dans les documents suivants (fournis avec la documentation gnrale de
CFT) :
"Note de diffusion CFT 230",
"Note de diffusion CFT 231",
"Guide de la scurit de transport".
CFT V2.3 xi
Remarques sur les changements ou volutions
apportes CFT/V2/UNIX
Ces remarques ne sappliquent quaux versions 223 de CFT/V2/UNIX gnres avant le 15 fvrier
2001, les produits plus rcents bnficiant directement des nouvelles volutions ds leur mise sur
le march.
Mdia de livraison
La livraison des produits se fait dsormais sur CD-ROM ; ce mdia peut tre utilis
directement comme support dinstallation, vitant ainsi toute copie sur les disques
locaux.
Installation du produit
Il est maintenant possible dinstaller CFT/V2/UNIX en automatique, partir dun
fichier de configuration.
Prise en compte de lenvironnement de CFT/V2/UNIX
Dans les versions prcdentes, les modifications de lenvironnement utilisateur taient
proposes, en premier lieu, au niveau du fichier de connexion utilisateur (.profile ou
autre). Sinon, il tait propos de les placer dans un nouveau fichier ENV_CFT sous la
racine du compte utilisateur.
Linstallation prconise maintenant le recours systmatique au fichier ENV_CFT.
Intgration du produit XFB Scope
Dans les versions prcdentes qui le supportait, le produit XFB Scope tait extrait lors
de linstallation du produit CFT/V2/UNIX et devait ensuite faire lobjet dune
installation part.
Le produit XFB Scope, lorsquil est slectionn linstallation, est dsormais intgr
dans larborescence du produit CFT/V2/UNIX.
Variables denvironnement de CFT/V2/UNIX
Les variables ddies CFT/V2/UNIX, et places dans lenvironnement utilisateur, ont
t revues et augmentes ; ceci permet potentiellement dexprimer les positionnements
des diffrents composants du produit par rapport 1 seul point (CFTDIRHOME) ou, au
contraire, dadapter le positionnement des diffrents rpertoires en fonction des
contraintes dexploitation.
Evolution des guides dexploitation
Tous les guides dexploitation spcifiques aux diffrentes plates-formes sont dsormais
regroups en un seul document nomm "Guide Technique".
CFT V2.3 1-1
1. Besoins matriels et systmes
1.1. Besoins matriels
Le support de livraison par dfaut des produits CFT/V2/UNIX est le CD-ROM.
En fonction des caractristiques des machines, il peut cependant tre fourni (sur demande) sur
diffrents types de supports magntiques :
disquettes 3"1/2 (1,44 Mega-octets),
cassette 8 mm (2,3 Giga-octets),
cassette 4 mm (4 Giga-octets),
cartouche (streamer 150 Mega-octets).
Pour installer CFT/V2/UNIX, vous devez donc disposer, sur la machine destine recevoir
CFT/V2/UNIX, dun lecteur supportant l'un des mdias numrs ci-dessus. A dfaut, les versions
actuelles des produits CFT/V2/UNIX ne supportant pas une installation via le rseau, vous devrez
extraire les informations du support magntique sur une autre machine puis les rapatrier via le
rseau ou tout autre moyen votre convenance.
1.2. Pr requis systmes et logiciels
Les pr requis systmes et logiciels (systme dexploitation, logiciel de communication et
personnalisations noyau) sont dcrits, plate-forme par plate-forme, dans le "Guide Technique
CFT/V2/UNIX".
1.3. Besoins matriels
Les besoins systmes du CFT/V2/UNIX, en termes despace disque ou de ressources systmes, sur
les diffrents systmes varient lgrement en fonction :
de la version du produit (essentiellement dues aux diffrences fonctionnelles),
du systme dexploitation (taille des fichier excutables, par exemple).
A223
CFT/V2/UNIX V2.2.3 utilise les ressources systme suivantes :
2 segments de mmoire partage, l'un de 218 Kilo-octets et l'autre dune taille par dfaut
de 2 Mga-octets,
1 vecteur de 4 smaphores, et 1 vecteur de 1 smaphore,
de 7 18 files de messages.
Le logiciel CFT/V2/UNIX 2.2.3 ncessite un espace disque de 40 60 Mga-octets en fonction de
la configuration du produit).
Besoins matriels et systmes
CFT V2.3 1-2
CD ROM
Pendant la phase dinstallation, un espace supplmentaire de 40Mga-octets est ncessaire.
A230
de 2 Mga-octets pour les versions 64 transferts et de 8 Mga-octets pour les versions
256 transferts,
CD ROM
Le logiciel CFT/V2/UNIX 230 ncessite un espace disque de 40 60 Mga-octets en fonction de
la configuration du produit.
A231
de 2 Mga-octets pour les versions 64 transferts et de 8 Mga-octets pour les versions
256 transferts,
CD ROM
Le logiciel CFT/V2/UNIX 230 ncessite un espace disque de 40 60 Mga-octets en fonction de
la configuration du produit.
CFT V2.3 2-1
2. Installation de CFT/V2/UNIX
2.1. Procdure dinstallation cft_instal
2.1.1. But de la procdure
Installer le logiciel CFT/V2/UNIX et son environnement sous le compte dun utilisateur.
La procdure permet l'installation de CFT/V2/UNIX par un utilisateur quelconque (existant au
moment de l'installation) dans tout rpertoire (diffrent du rpertoire courant et lors de
l'installation) sur lequel il possde des droits d'accs suffisants.
Cette procdure peut tre utilise en mode interactif, pour raliser une installation individuelle du
produit, ou en mode batch, permettant de rpliquer sur plusieurs machines une installation type.
Dans la mesure o lutilisation du mode batch suppose une connaissance pralable de linstallation
en mode interactif, il sera dcrit la fin de ce chapitre.
2.1.2. Ce que permet la procdure
La procdure propose, ds son lancement en mode interactif, un certain nombre de choix de base :
installation initiale de CFT.
Ce mode doit tre utilis lors de la premire installation de CFT ou lors de la mise
jour d'un produit existant par un produit plus rcent,
installation dun composant de CFT.
Ce mode permet, pour un CFT dj install sur la machine, d'ajouter des composants
non slectionns lors de la phase "installation initiale". Par exemple si, lors de
l'installation initiale, les bases anglaises des fonctions interactives n'avaient pas t
retenues, il est possible de les ajouter plus tard, via ce mode d'installation.
Attention : ce mode dinstallation dun composant n'est utilisable que pour installer ou
rinstaller des composants du mme tat technique que le produit CFT/V2/UNIX dj
install. Pour une mise niveau, il est ncessaire d'avoir auparavant dj ralis une
installation initiale,
retrait dun composant de CFT.
Ce mode permet, pour un CFT dj install sur la machine, de supprimer des
composants slectionns lors de la phase "installation initiale" et qui s'avrent ensuite
inutiles. Par exemple si, lors de l'installation initiale, les communications en TCP/IP ont
t retenues et qu'on ne dispose pas de la cl d'activation logicielle de ce module, il est
possible de le supprimer, via ce mode de dsinstallation,
Installation de CFT/V2/UNIX
CFT V2.3 2-2
liste des composants installs.
Ce mode permet, avant de raliser une opration de retrait ou dajout, de vrifier les
composants de CFT effectivement installs. Les diffrents composants logiciels de
CFT, dont la disponibilit varie selon les plates-formes, sont les suivants :
- le moniteur (uniquement install via l'option "installation initiale"),
- support de TCP,
- support de X25,
- support de Lu62,
- les fonctions interactives, ce composant proposant lui-mme 2 options:
- messages dcran en langue franaise,
- messages dcran en langue anglaise,
- les interfaces de programmation et les EXITs,
- les produits complmentaires (XFB Scope ou IUI, par exemple et en fonction de la
disponibilit suivant les plates-formes).
2.1.3. Remarques et restrictions dinstallation
Vous trouverez ci-dessous un certain nombre de remarques et de restrictions qui, si elles ne sont
pas observes, peuvent crer des problmes lors de linstallation ou, plus tardivement, au moment
de lactivation du produit.
Ces remarques portent sur 3 points majeurs :
les caractristiques du compte de lutilisateur qui se servira de CFT/V2/UNIX,
les modifications apportes (ou apporter) lenvironnement de lutilisateur,
le rpertoire sous lequel les composants de CFT/V2/UNIX seront installs.
Remarques sur le compte utilisateur :
si l'installation doit tre faite sur le compte d'un nouvel utilisateur, ce compte doit tre
pralablement cr avant le lancement de la procdure,
il est impossible actuellement d'installer ou de faire fonctionner l'application
CFT/V2/UNIX sous le compte (uid) ou le groupe (gid) du super-utilisateur (root),
il est impossible dinstaller ou de faire fonctionner 2 occurrences (mme de version ou de
niveau technique diffrents) de CFT/V2/UNIX sur un mme compte utilisateur.
Remarques sur les modifications apporter lenvironnement de lutilisateur :
CFT/V2/UNIX utilise un certain nombre de variables denvironnement.
Lors de l'installation :
- la procdure vous proposera, par dfaut, de crer un fichier nomm ENV_CFT,
renfermant toutes les informations ncessaires CFT/V2/UNIX.
Il sera alors de votre responsabilit de procder lexcution de ce fichier avant
tout usage du produit. Il est noter que, si vous le souhaitez, vous pouvez activer
systmatiquement ce fichier ENV_CFT depuis votre fichier de dmarrage.
CFT V2.3 2-3
Par exemple, vous pouvez insrez dans votre fichier .profile le script suivant :
if [ -f "$HOME/ENV_CFT" ]
then
. $HOME/ENV_CFT
fi
- si vous le spcifiez, la procdure vous proposera de modifier automatiquement le
fichier de dmarrage de lutilisateur (.login, .profile, ou .cshrc),
Compte-tenu de la complexit possible du fichier .cshrc, .login, ou .profile de
lutilisateur, il est possible que l'insertion des dfinitions ncessaires
CFT/V2/UNIX soit mal positionne.
Il est donc vivement conseill, l'issue de l'installation du produit, de vrifier
le positionnement judicieux de la mise jour dans le fichier,
l'issue de l'installation et si des modifications ont t apportes au fichier .cshrc, .login,
ou .profile, il est ncessaire de revenir au login et de se reconnecter sous le compte
d'installation avant de procder au test de l'installation.
Remarques sur le rpertoire dinstallation :
si l'installation doit tre faite partir d'un rpertoire existant mais diffrent du rpertoire
de destination propos par dfaut, l'utilisateur doit disposer des droits d'accs sur ce
rpertoire,
il nest pas conseill dinstaller CFT sur un rpertoire distant, visible via NFS.
De mme, dans certains cas, des problmes ont t rapports lors de lusage de CFT sur
des partitions de types VxFS.
En effet, CFT utilise, pour fonctionner, des fichiers spciaux (de type pipe) pour
changer des informations entre tches. Ces fichiers spciaux ne sont pas toujours bien
supports par tous les systmes dexploitation lorsquils se trouvent situs sur des
partitions NFS ou VxFS. Il ne sagit donc pas dun problme CFT.
Face ce cas de figure, prendre contact avec votre Service Support Constructeur.
2.2. Restauration de la procdure partir de son support
2.2.1. Cas du CD ROM
CD ROM
Lorsque le produit est fourni sur CD-ROM, il est inutile de procder la restauration.
Linstallation peut tre ralise directement depuis son support.
Se reporter directement au chapitre "Lancement de la procdure".
CFT V2.3 2-4
2.2.2. Cas des autres mdias de livraison
L'extraction des donnes est base sur la commande systme cpio.
Remarque :
pour de plus amples informations sur cette commande, consulter la documentation de votre
systme.
La restauration des diffrents constituants de CFT/V2/UNIX sur votre systme est ralise par la
squence doprations suivante :
1. Se connecter sous le compte utilisateur sous lequel loprateur souhaite installer le
logiciel CFT (ce compte ne peut pas disposer des droits du super-utilisateur).
2. Se positionner sur un rpertoire adquat pour y placer les fichiers utiliss par la
procdure dinstallation (gnralement, on utilisera /tmp.
3. Insrer le mdia contenant CFT dans le lecteur ou, dans le cas de disquettes, le support
rfrenc 1.
4. Procder l'extraction du logiciel l'aide de la commande cpio, adapte dune part au
mdia utilis et dautre part votre systme.
Exemple pour une disquette sur une machine sous AIX :
cpio -icvdmB < /dev/rfd0 (0 pour le chiffre zro)
Attention : une attention particulire doit tre apporte lors de la saisie des paramtres
de la commande cpio. Une erreur de majuscule, de minuscule ou une option omise peut
conduire une extraction a priori correcte mais nanmoins incomplte du produit,
susceptible de gnrer des problmes lors de linstallation mais aussi ultrieurement en
fonctionnement.
Gnralement, dans le cas des disquettes 3 1/2, le systme rclamera la disquette
suivante par un message de la forme gnrale :
"Entrez le nom du priphrique ou de fichier lorsque
vous serez prt continuer l'opration"
Dans ce cas, suivez les indications fournies lcran et rpter l'opration depuis le
point 2 pour chacune des disquettes, en respectant l'ordre chronologique.
2.3. Lancement de la procdure
Si votre produit est livr sur CD-ROM, se reporter la documentation place sur le mdia.
Cette documentation vous donnera le nom et la localisation de la procdure sur le support.
CD-ROM
Si votre produit est livr sur un autre support que le CD-ROM, linstallation proprement dite de
CFT se fait par l'excution de la commande cft_instal, disponible dans le rpertoire courant ds la
fin de l'extraction des donnes du support.
CFT V2.3 2-5
2.3.1. Slection de la langue dinstallation
La procdure cft_instal permet, pendant son excution, l'affichage des messages dans les langues
franaise ou anglaise.
La slection de la langue daffichage peut tre :
manuelle, en ajoutant comme paramtre la commande cft_instal le mot-cl fr pour la
langue franaise (respectivement, uk pour la langue anglaise),
automatique, la slection tant ralise directement par cft_instal au moment de son
excution (par l'examen de la variable d'environnement LANG) :
- si LANG n'est pas dfinie, la langue utilise est langlais,
- si LANG est dfinie comme franais (en fonction des systmes, la dfinition peut
tre Fr_FR, fr_FR...), la langue utilise est le franais,
- dans tous les autres cas, la langue utilise est l'anglais.
2.3.2. Installation de CFT
La procdure dinstallation de CFT est la suivante :
1. Excuter la commande cft_instal avec son ventuel paramtre associ :
pour une installation manuelle en franais :
./cft_instal fr
pour une installation manuelle en anglais :
./cft_instal uk
pour une installation automatique :
./cft_instal
2. Suivre les indications affiches sur l'cran.
Remarques :
cette procdure permet d'installer CFT dans tout rpertoire diffrent du rpertoire courant et pour
lequel l'utilisateur dispose des droits d'criture.
Dans les exemples fournis dans ce guide, on supposera que le mdia dinstallation a t dcharg
sur /tmp et que CFT sera install sous la racine du rpertoire de l'utilisateur, dans un sous-
rpertoire par dfaut nomm cft (par exemple : /home/transfert/cft).
Attention :
l'issue de l'installation et, en fonction de loption choisie, si des modifications ont t
apportes au fichier .cshrc, .login ou .profile, il est ncessaire de revenir au login et de se
reconnecter sous le compte d'installation avant de procder au test de l'installation,
si, sur le dernier cran affich lissue de linstallation, il vous est indiqu que des
dclarations existaient dj dans votre fichier .cshrc,.login ou .profile (cas typique dune
rinstallation de CFT sur un compte existant), vous DEVEZ diter manuellement le
fichier concern pour apporter les modifications ncessaires. A dfaut, CFT risque de ne
pas pouvoir fonctionner correctement,
afin de raliser les modifications ncessaires, vous pouvez vous aider des informations
fournies dans le chapitre "Mise en exploitation de CFT ".
CFT V2.3 2-6
2.4. Structure et contenu des rpertoires de CFT
Suite linstallation de CFT, lutilisateur trouvera, partir du rpertoire dimplantation de CFT
(dans notre exemple, cft), tous les composants du produit.
Tableau 1. Contenu des rpertoires de CFT (par ordre alphabtique)
Rpertoire Contenu
filapi Rpertoire contenant les fichiers lis l'interface de programmation CFT
Ces utilitaires sont dcrits dans le chapitre "Construction dapplications APIs de CFT"
fildat Rpertoire des fichiers base de donnes de CFT
filexe Rpertoire contenant les diffrents excutables de CFT
filexit Rpertoire contenant les fichiers lis aux diffrents EXITs de CFT ainsi quun exemple de
manipulation des fichiers statistiques
Ces utilitaires sont dcrits dans le chapitre "Construction dapplications APIs de CFT" pour
les EXITs et dans le chapitre "Mise en exploitation de CFT" pour les fichiers statistiques
filinst Rpertoire contenant des exemples de paramtrage, de procdure ou de configuration
Ces fichiers peuvent tre utiliss lors des phases de validation du produit ou comme modles
pour vos propres configurations
filint Rpertoire des fichiers base de donnes des fonctions interactives
et des fichiers base de donnes utiles la scurit d'exploitation
fillib Rpertoire contenant les librairies ncessaires la constitution des programmes utilisant les
APIs et EXITs de CFT
fillog Rpertoire des fichiers journaux dactivit ou de trace de CFT
filnotes Rpertoire pouvant contenir, au format texte 7 bits :
- des notes d'application, d'usage gnral ou spcifique votre machine,
- des remarques spcifiques votre plate-forme,
- des additifs de dernire minute ce guide ou aux documents gnraux CFT
filpub Rpertoire qui contiendra les fichiers transmettre et les fichiers reus par CFT
filres Rpertoire utilis par certaines implantations de CFT/V2/UNIX ; ce rpertoire peut contenir
des objets (fichiers de configuration, d'aide ou excutable) qui n'existent que sur cette
implantation
Voir le "Manuel CFT/V2/UNIX Guide technique" pour plus d'informations
+A223 filsec Rpertoire constitu des fichiers xfbgroup et xfbpasswd contenant respectivement la liste
exhaustive des groupes dutilisateurs autoriss accder au Serveur IUI et les mots de passe
associs indispensables lauthentification des utilisateurs auprs du serveur IUI
+A230 filsec/pki Rpertoire ddi aux donnes en rapport avec la scurit de transfert
A223
A230
filxntf Rpertoire ddi au module complmentaire SCOPE (agent XNTF).
Les diffrents sous-rpertoires de cette branches seront dcrits dans la section utilisation des
lments additionnels
filusr Rpertoire contenant diffrents fichiers de commande de CFT
Ces utilitaires sont dcrits dans le chapitre "Descriptif des utilitaires"
.info Rpertoire contenant des informations d'identification de la version de CFT
La structure de ce rpertoire est dcrite dans le chapitre "Identification de CFT"
CFT V2.3 2-7
2.5. Installation automatique de CFT (mode "batch")
Dans le cadre dune installation rptitive dun mme CFT/UNIX sur un grand nombre de
machines identiques, il peut tre souhaitable dautomatiser au maximum le processus de
rplication.
Lautomatisation de ce processus de duplication se fait en 4 temps :
1. Sauvegarde du modle de fichier dinitialisation de CFT/UNIX.
2. Installation par loprateur, en mode interactif, du premier CFT/UNIX (ralisation du
pre).
3. Rcupration des informations dinstallation du pre et constitution dun scnario de
duplication.
4. Pour chacune des machines installer, lancement de la procdure en mode batch,
laide du fichier scnario.
2.5.1. Remarques pralables
Lusage du mode batch suppose un certain nombre de remarques :
nous supposerons que lutilisateur matrise parfaitement linstallation de CFT/UNIX et,
en particulier, dispose dune bonne comprhension des questions poses,
il est indispensable de respecter lusage qui est fait des majuscules, des minuscules et, en
particulier, des sparateurs (une dclaration du type VAR = YES pourra ne pas tre
reconnue si le format attendu est VAR=Yes),
il est indispensable de respecter lordre des sections et des lments qui les composent.
2.5.2. Phase 1 : sauvegarde du fichier modle
Avant de lancer linstallation de CFT/UNIX, il est ncessaire de crer une copie du fichier modle
dinitialisation nomm " .cft_instal.ini" (attention au caractre point devant cft_instal.ini).
2.5.2.1. Localisation du fichier ".cft_instal.ini"
Si vous procdez linstallation depuis un CD-ROM, ce fichier se trouve dans le sous-
rpertoire <point_de_montage>/prod/<tat_tech_CFT>/<plate-forme>/<date_de_gnration> ,
Par exemple, si vous installez un CFT/V2/USCO5 223 gnr le 25/11/00 partir dun CD-ROM
mont sous /cdrom, le rpertoire sera :
/cdrom/prod/v223/SCO5/20001125
Si vous procdez linstallation depuis un autre mdia que le CD-ROM, ce fichier se trouve
lissue de lexcution de la commande cpio- directement sous le rpertoire utilis pour lextraction.
CFT V2.3 2-8
2.5.2.2. Sauvegarde du fichier ".cft_instal.ini "
Il est conseill de sauvegarder ce fichier dune part, sous un autre nom (dans nos exemples, nous
retiendrons le nom de reference.batch) et dautre part, sous un autre rpertoire que ceux impliqus
par linstallation.
2.5.2.3. Analyse du contenu du fichier ".cft_instal.ini"
Si vous ditez, sous vi par exemple, le fichier reference.batch, vous obtiendrez le contenu repris
ci-dessous, dans lequel se distinguent 5 sections matrialises par des crochets (par exemple,
section [Networks]).
[Product] [Monitor]
MACHINE=AIX MONIT=Yes
OSLEVEL=41 CFTINT=Yes
ARCHI=IBM INTFR=Yes
VERSION=2.2.3 INTUK=No
TECH_STATE=20000908 INTLANG=FR
USED_SPACE=40
[Options] [Network]
END_USER= TCPIP=Yes
COUNTRY=francais LU62=No
CONFIG=ENV_CFT X25=No
INST_DIR=cft
INSTAL=First [Utilities]
ERASE= EXITS=No
SCOPE=No
Chaque section reprsente une des caractristiques de CFT/UNIX (par exemple, [Networks]
dcrit les types de rseaux supports).
Chaque section renferme ensuite un certain nombre dlments, chaque lment correspondant
un choix ralisable par loprateur au moment de linstallation UNIX (par exemple, dans la section
[Networks] llment TCPIP permet dinstaller loption rseau TCP).
Lensemble des sections et lments est dcrit ci-aprs.
[Product]
MACHINE=AIX
OSLEVEL=41
ARCHI=IBM
VERSION=2.2.3
TECH_STATE=20001125
USED_SPACE=40
Attention : cette section ne doit jamais tre modifie.
CFT V2.3 2-9
La section [Product] renferme toutes les informations caractristiques du CFT/UNIX en
installation (type et niveau du systme dexploitation, version et tat technique du CFT/UNIX).
[Options]
END_USER=
COUNTRY=francais
CONFIG=ENV_CFT
INST_DIR=cft
INSTAL=First
ERASE=
La section [Options]permet de mmoriser les choix dimplantation de CFT/UNIX sur la
machine considre.
END_USER
Nom de lutilisateur (au sens Unix) pour le compte duquel linstallation est ralise.
COUNTRY
Langue daffichage des messages lors de lutilisation de la procdure en mode interactif
(inutilisable en mode batch).
Les seules valeurs possibles sont "francais" et "english".
CONFIG
Nom du fichier qui renferme les dfinitions des variables denvironnement ncessaires
CFT/UNIX.
Ce fichier est, par dfaut, le fichier externe ENV_CFT. Sinon, cest le fichier de dmarrage de
lutilisateur (.profile, par exemple).
INST_DIR
Nom du rpertoire sous lequel sera installs CFT/UNIX.
Par dfaut, le rpertoire utilis est le rpertoire cft sous la racine du compte utilisateur
($HOME/cft).
INSTALL
Opration ralise sur CFT/UNIX.
En mode batch, la seule opration possible est linstallation initiale (mode First)
[Monitor]
MONIT=Yes
CFTINT=Yes
INTFR=Yes
INTUK=No
INTLANG=FR
La section [Monitor] matrialise les choix de loprateur quant linstallation des composants
de base de CFT/UNIX.
MONIT
Le cur du moniteur.
En mode batch, ce module est obligatoire ( choix unique Yes).
CFT V2.3 2-10
CFTINT
Usage des fonctions interactives de CFT/UNIX (Yes ou No).
INTFR
Messages en franais pour les fonctions interactives (Yes ou No).
INTUK
Messages en anglais pour les fonctions interactives (Yes ou No).
Attention : si CFTINT est positionn Yes, une au moins des bases de messages (INTFR ou
INTUK) doit tre Yes.
INTLANG
Si les bases franaises et anglaises sont charges, slection de la langue par dfaut ( 2 choix
possibles : FR pour la langue franaise par dfaut, UK pour la langue anglaise)
[Network]
TCPIP=Yes
LU62=No
X25=No
Complmentaire de la prcdente, la section [Network] matrialise les choix de loprateur
quant linstallation des composants rseaux de CFT/UNIX.
TCPIP
Chargement du module TCP (Yes ou No).
LU62
Chargement du module LU62 (Yes ou No).
X25
Chargement du module X25 (Yes ou No).
Attention : au moins 1 des composants rseau doit tre actif.
[Utilities]
EXITS=No
SCOPE=No
Complmentaire des 2 sections prcdentes, la section [Utilities] matrialise les choix de
loprateur quant linstallation des modules API, des procdures de type EXIT et du composant
XFBSCOPE de CFT/UNIX.
EXITS
Installation des composants EXIT et API (Yes ou No).
SCOPE
Installation du composant XFBSCOPE.
CFT V2.3 2-11
2.5.3. Phase 2 : installation du CFT/UNIX pre
Linstallation de ce CFT/UNIX se fait exactement comme dcrit dans les chapitres prcdents.
A lissue de la phase dinstallation, vous trouver dans le rpertoire dinstallation de CFT/UNIX, un
fichier nomm ".cft_instal.log".
Ce fichier ".cft_instal.log.correspond au compte-rendu de linstallation du CFT/UNIX pre, qui
doit servir de modle pour la duplication. Ce fichier, de part sa structure, est trs voisin du fichier
reference.batch dcrit plus avant.
Les seules diffrences notables sont :
lapparition dune section [Packs], qui englobe les sections [Monitor], [Network] et
[Utilities] et prsente tous les composants de CFT/UNIX (en premier lieu, les
composants installs puis les composants non slectionns par loprateur),
une section [Status] qui rend compte du rsultat de linstallation.
------------------------
DATE=25/11/00-12:24
-------------------------
[Product]
LOGIN_FILE=/u/test/.profile
MACHINE=AIX
OSLEVEL=41
ARCHI=IBM
VERSION=2.2.3
TECH_STATE=20001125
USED_SPACE=40
[Packs]
MONIT=Yes
TCPIP=Yes
EXITS=Yes
CFTINT=Yes
INTFR=Yes
INTUK=Yes
X25=No
LU62=No
SCOPE=No
[Status]
PB=OK
#Installation OK
[Options]
END_USER=test
CONFIG=/u/test/ENV_CFT
INST_DIR=/u/test/cft
INSTAL=First
ERASE=
COUNTRY=english
INTLANG=UK
Comme on peut le constater en consultant ce fichier rsultat :
(section [Monitor]) loprateur raliser linstallation dun CFT/V2/UAIX 223 (gnr
le 25 novembre 2000),
(section [Options]) pour lutilisateur test. Il sagit dune premire installation, avec des
messages en anglais, de CFT/UNIX , sous le rpertoire dinstallation $HOME/test, et
lenvironnement de CFT a t plac dans le fichier $HOME/ENV_CFT,
CFT V2.3 2-12
(section [Packs]) Ce CFT pourra utiliser le rseau TCP, les EXITs et les APIS. Les
fonctions interactives sont disponibles en franais et en anglais, langlais tant la langue
par dfaut.
2.5.4. Phase 3 : Constitution du scnario de duplication
Partant du fichier modle reference.batch sauvegard prcdemment, il suffit de crer un nouveau
script (par exemple, mon_scenario.batch) en reportant, pour chacun des mots cls, les choix faits
pendant linstallation du pre et matrialiss dans le compte-rendu ".cft_instal.log".
Si on reprend les caractristiques de linstallation donne par le fichier ".cft_instal.log", pour les
appliquer ensuite sur le contenu initial du fichier reference.batch, nous obtenons le nouveau fichier
de configuration suivant :
[Product]
MACHINE=AIX
OSLEVEL=41
ARCHI=IBM
VERSION=2.2.3
TECH_STATE=20000908
USED_SPACE=40
[Options]
END_USER=
COUNTRY=francais
CONFIG=ENV_CFT
INST_DIR=cft
INSTAL=First
ERASE=
[Monitor]
MONIT=Yes
CFTINT=Yes
INTFR=Yes
INTUK=No
INTLANG=FR
[Network]
TCPIP=Yes
LU62=No
X25=No
[Utilities]
EXITS=No
SCOPE=No
2.5.5. Phase 4 : Lancement de la procdure en mode batch
Une fois le scnario dinstallation termin, il suffit de le diffuser sur les machines cibles, en
accompagnement du produit complet installer.
Le lancement de linstallation se ralise par lancement de la procdure cft_instal avec, en
paramtre, le nom du fichier scnario.
Dans notre exemple, la commande est donc :
cft_instal mon_scenario.batch
Il est possible, par programme, de vrifier la bonne excution de linstallation automatique. En
effet, la procdure cft_instal retourne, dans ce cas, 0 si linstallation sest bien droule, 127 sinon.
De mme, on peut balayer le fichier .cft_instal.log rsultant de linstallation automatique pour y
retrouver la chane de caractres PB= . Si la rponse est OK , linstallation sest bien
droule. Sinon, la rponse est un mnmonique dont les diffrentes significations sont reprises
dans le tableau ci-aprs.
CFT V2.3 2-13
Tableau 2. Codes derreur signals en installation de type batch
Mnmonique Signification du problme
BADACC Problme daccs un fichier
Vrifier les droits
BADPAR Paramtre invalide dans le fichier de configuration
CFG Kit incomplet (fichier de configuration manquant)
CP Problme survenu lors de lexcution de lordre systme cp()
Fichier inexistant ou problme de droits
DECOM Problme pendant la dcompression
Image altre ou, plus gnralement, problme li un espace disque insuffisant
EXTR Problme pendant lextraction. Problme de droit, despace disque ou image altre
INI Kit incomplet (fichier d'initialisation manquant)
KIT Kit incomplet (un des packs attendu est manquant)
MACHINE Le kit en cours dinstallation nest pas prvu pour le systme dexploitation utilis
MV Problme survenu lors de lexcution de lordre systme mv()
Fichier inexistant ou problme de droits
NOTSUP Loption dinstallation retenue nest pas supporte en mode batch
PACK Kit incomplet (liste des packs manquant)
REP Problme lors de la cration dun rpertoire
Problme de droits daccs ou rpertoire parent inexistant
REPER Kit incomplet (liste des rpertoires manquant)
ROOT Installation sous root impossible
SHELL Problme lors de la dtermination du shell de lutilisateur
USER Problme lors de la dtermination user
CFT V2.3 3-1
3. Descriptif des utilitaires
3.1. Prsentation
Ce chapitre prsente les fonctionnalits des diffrents utilitaires de CFT qui sont placs, l'issue
de l'installation, dans le sous-rpertoire filusr de cft.
Ces utilitaires ne remplacent pas les commandes de base dcrites dans les autres manuels de CFT
mais ils ont uniquement pour but de simplifier les manipulations usuelles du produit XFB Monitor
CFT/V2/UNIX.
Pour une bonne comprhension de certains paramtres cits dans ce chapitre, il est conseill de
consulter le "Manuel de rfrence" de CFT.
3.2. Liste alphabtique des utilitaires
Tableau 3. Liste alphabtique des utilitaires
Utilitaire Dfinition
atoe Table de transcodage ASCII ISO 8859-1 en EBCDIC
cft2unix Utilitaire de manipulation des variables denvironnement CFT
cftalog Visualisation directe du fichier journal altern de CFT
cftcata Visualisation en totalit du fichier catalogue de CFT
cftcatab Visualisation en rsum du fichier catalogue de CFT
cftcatal Utilitaire de migration et/ou dextension du fichier catalogue de CFT
cftdelcat Utilitaire de destruction d'un lment dans le catalogue
cftinit Utilitaire d'initialisation gnrale de CFT
cftkey Visualisation des informations systme
cftlog Visualisation directe du fichier journal de CFT
cftparm Visualisation directe de la partie "paramtres" du paramtrage
cftpart Visualisation directe de la partie "partenaires" du paramtrage
cftping Utilitaire d'valuation de l'tat de CFT
cftstart Utilitaire de dmarrage contrl de CFT
cftstop Utilitaire d'arrt contrl de CFT
cftupdate Utilitaire de mise jour de la configuration de CFT
cftutil Visualisation simplifie des ordres classiques CFTUTIL
cftversion Utilitaire de rcupration de la version de CFT
etoa Table de transcodage EBCDIC en ASCII ISO 8859-1
secinit Utilitaire d'initialisation de l'environnement d'habilitation de CFT
secupdate Utilitaire de mise jour de l'environnement d'habilitation de CFT
+A223 xfbadm Utilitaire de dmarrage et darrt du Serveur IUI
+A223 xfbadmgrp Utilitaire de manipulation sur des groupes (ensemble dUtilisateurs accdant au serveur IUI
+A223 xfbadmusr Utilitaire de manipulation les Utilisateurs accdant au serveur IUI
xvi Utilitaire de manipulation des tables de transcodages
x25loop Utilitaire de test en boucle des lignes X.25 (non disponible sur toutes les plates-formes
supportant X25)
Descriptif des utilitaires
CFT V2.3 3-2
3.3. Table de transcodage
Par dfaut, CFT utilise des tables internes de transcodage des caractres ASCII <-> EBCDIC
bases sur le jeu de caractres ASCII tel que dfini sur les machines de type PC/DOS.
Dans certains cas, il peut tre intressant de raliser ce transcodage par rapport au jeu de caractres
ASCII de la norme ISO 8859-1. Pour cela, en s'appuyant sur la commande CFTXLATE dfinie
dans le guide "Concepts" de CFT, il est possible d'utiliser les tables de transcodage externes
suivantes :
atoe : table de transcodage ASCII ISO 8859-1 en EBCDIC,
etoa : table de transcodage EBCDIC en ASCII ISO 8859-1.
Remarque :
l'utilitaire xvi dtaill dans le paragraphe "Utilitaires caractre systmes" permet de crer des
tables de transcodage spcifiques ou de manipuler des tables existantes.
3.4. Utilitaires de gestion de CFT
3.4.1. cftinit
cftinit est un utilitaire d'initialisation gnrale de CFT.
Syntaxe
cftinit [<filename> [<filename>...]]
Usage classique
Le plus souvent, cftinit est utilis avec un seul paramtre qui est le nom du fichier qui contient la
configuration de CFT.
cftinit ma_config.cft
Usage volu
Plusieurs noms de fichiers peuvent tre donns sur la ligne de commande.
Classiquement, l'utilisateur place l'ensemble du paramtrage de CFT dans un seul fichier.
Cependant, pour des questions d'organisation, il peut tre souhaitable d'clater le paramtrage en
plusieurs fichiers (par exemple, un fichier dcrivant les cartes CFTPART et un autre fichier
contenant les cartes CFTPARM, CFTLOG, etc.).
cftinit mes_parts.cft le_reste.cft
Remarques :
si aucun nom de fichier n'est donn en paramtre, le programme demande un ou
plusieurs noms de fichiers,
si aucun nom n'est fourni, le programme s'arrte,
lors de son activation, cftinit prend en charge la cration des fichiers catalogue et
communication.
CFT V2.3 3-3
La taille par dfaut de ces fichiers est de 500 enregistrements. Il vous est possible, si
ncessaire, d'adapter ces tailles par dfaut vos besoins. Il suffit d'diter le shell cftinit
et de modifier les valeurs des champs nbreccat et nbreccom, en tte de fichier (valeurs
exprimes en nombre d'enregistrements.
3.4.2. cftstart
cftstart est un utilitaire de dmarrage contrl de CFT et de ses lments complmentaires.
Syntaxe
cftstart [<idparm> | -batch]
Usage classique
Le plus souvent, cftstart est utilis sans paramtre. Il ralise un certain nombre de vrifications sur
lenvironnement du CFT, en vue de garantir un dmarrage correct. Ensuite, il active CFT, attend le
dmarrage des processus puis affiche titre informatif le numro (PID) du processus CFTMAIN.
% cftstart
Starting CFT with IDPARM "IDPARM0"
Starting CFTMAIN ... started
Starting CFTTCOM .... started
Starting CFTTPRO ... started
Starting CFTLOG ... started
CFT started correctly.
CFTMAIN process id is 23564.
%
Usage volu
Dans le cas d'un paramtrage volu de CFT, il est possible de passer le champ IDPARM en
paramtre. Si celui-ci n'est pas fourni, c'est IDPARM0 qui sera pris par dfaut. En cas de mauvaise
valeur de l'IDPARM, cftstart affiche les valeurs possibles extraites du paramtrage de CFT :
%cftstart IDPARM1
Invalid IDPARM "IDPARM1".
Valid IDPARMs are:
CFTPARM ID = IDPARM0,
CFT not started.
%
Usage en mode batch
La commande cftstart ave loption -batch est uniquement utiliser dans le cas dun dmarrage
automatique de CFT au moment du lancement du systme. Cette option complmentaire ne
modifie que le comportement de laffichage de la commande
La mmorisation des messages derreur se produisant durant le lancement automatique sappuye
sur la commande systme logger(). Le bon fonctionnement de ce dispositif impose donc que le
dmon systme syslogd() soit effectivement actif sur votre systme.
CFT V2.3 3-4
Ladministrateur du systme pourra identifier facilement, dans ses fichiers journaux, les messages
spcifiques de CFT qui sont :
pour les erreurs, de niveau error et de facilit local0,
pour un lancement correct, de niveau information et de facilit local0.
Il est noter que lusage du paramtre -batch exclue lutilisation du paramtre IDPARM.
Remarques :
cftstart ralise une attente lors de l'activation de chacun des processus ncessaires CFT.
Mme si cette attente est gnralement d'une valeur suffisante, il peut arriver (charge
excessive de la machine, machine ancienne particulirement lente) que cftstart dclare
anormalement une erreur. Dans ce cas, il suffit d'diter le shell cftstart et d'adapter la
valeur du champ start_timeout, en tte de fichier (valeur exprime en secondes).
cftstart tel que livr par dfaut, ne procde pas lactivation automatique des lments
complmentaires de CFT comme SCOPE ou IUI.
Pour personnaliser le fonctionnement de cftstart, se reporter au chapitre "Utilisation
des lments additionnels".
3.4.3. cftstop
cftstop est un utilitaire d'arrt contrl de CFT.
Syntaxe
cftstop [-kill]
Usage classique
La commande cftstop, utilise sans paramtre, procde l'arrt de CFT en lui envoyant la
commande 'SHUT FAST=YES'. Il attend ensuite la disparition des diffrents processus de CFT :
% cftstop
Waiting for CFTLOG .... stopped
Waiting for CFTTCPS ... stopped
Waiting for CFTTPRO ... stopped
Waiting for CFTTCOM ... stopped
Waiting for CFTTFIL ... stopped
Waiting for CFTMAIN ....stopped
CFT stopped correctly.
%
Si, pendant la phase d'arrt, cftstop dtecte un comportement anomal, il le signale de la manire
suivante :
% cftstop
Invalid state of CFT.
Use cftstop -kill to force shutdown of CFT
CFT V2.3 3-5
Usage volu
En cas de problme, le programme prconise d'arrter CFT par la commande 'cftstop -kill.
Cette commande procde alors un arrt forc de CFT. Cet arrt forc se passe gnralement trs
bien mais, en fonction de l'tat du systme, des dsordres plus importants peuvent tre rencontrs.
En cas de dsordre grave au niveau de CFT, et avant de poursuivre le nettoyage, un message
d'alerte est affich, et l'utilisateur est avis des incidents que la commande ultrieure pourrait
engendrer.
Attention : en cas de dsordre grave, cette commande dtruit les files de messages (msg queues),
les segments de mmoire partage (shared memory) et les vecteurs de smaphores associs
l'utilisateur de CFT.
Ceci peut donc avoir des effets nfastes sur tout autre applicatif lanc par l'utilisateur et qui
utilisent le mme type de ressources.
% cftstop
Invalid state of CFT.
Use cftstop -kill to force shutdown of CFT
% cftstop -kill
***************
*** WARNING ***
***************
Using this action can seriously damage the IPC status of other
applications running on the same login (as X server).
If you are not sure, use the ^C command and please contact
your technical support.
If you want to continue, please enter the word yes : yes
### Process destruction ###
Killing process CFTLOG, pid 18210
Killing process CFTTCPS, pid 38966
Killing process CFTTPRO, pid 38438
Killing process CFTTCOM, pid 36388
Killing process CFTTFIL, pid 36268
### IPC destruction ###
Removing msg queue 61455
Removing shared memory 69638
Removing shared memory 36871
Removing semaphore 49167
Removing semaphore 49168
CFT stopped.
%
CFT V2.3 3-6
Remarques :
cftstop ralise une attente lors de l'arrt de chacun des processus ncessaires CFT.
Mme si cette attente est gnralement d'une valeur suffisante, il peut arriver (transferts
en cours, charge excessive de la machine, machine ancienne particulirement lente ...)
que cftstop dclare anormalement une erreur. Dans ce cas, il suffit d'diter le shell
cftstop et d'adapter la valeur du champ stop_timeout, en tte de fichier (valeur exprime
en secondes), pour qu'elle soit en rapport avec les valeurs des champs DISCTD et
DISCTS de votre paramtrage.
cftsop, tel que livr par dfaut, ne procde pas larrt automatique des lments
complmentaires de CFT comme SCOPE ou IUI.
Pour personnaliser le fonctionnement de cftstop, se reporter au chapitre "Utilisation des
lments additionnels".
3.4.4. cftupdate
cftupdate est un utilitaire permettant la mise jour de la configuration.
Syntaxe
cftupdate <filename> [<filename> ...]
Remarques :
cette mise jour n'est possible que sur les cartes CFTPART, CFTxxx pour les rseaux,
les cartes CFTSEND, etc
il faut considrer cette commande comme un alias de CFTUTIL @<filename> pour
chaque nom de fichier donn en paramtre de la ligne de commande.
3.4.5. cftutil
cftutil est une commande permettant de passer un ordre classique CFTUTIL, mais permet d'obtenir
la visualisation des rsultats sans bannire. De plus, si le code retour de la commande est non nul,
un message est affich.
Syntaxe
cftutil <command>
Usage
% cftutil listcat type=z
CFTU26E LISTCAT _ Error (TYPE Bad value for parameter)
cftutil code 115
%
CFT V2.3 3-7
3.4.6. secinit
secinit est un utilitaire dinitialisation de lenvironnement dhabilitation de CFT.
Syntaxe
secinit [<filename> [<filename>...]]
Usage classique
Le plus souvent, secinit est utilis avec un seul paramtre qui est le nom du fichier qui contient la
configuration de scurit de CFT :
secinit ma_config.cft
Usage volu
Plusieurs noms de fichiers peuvent tre donns sur la ligne de commande.
Classiquement, l'utilisateur place l'ensemble du paramtrage de scurisation de CFT dans un seul
fichier. Cependant, pour des questions d'organisation, il peut tre souhaitable d'clater le
paramtrage en plusieurs fichiers.
secinit ma_config_debut.cft le_reste.cft
Remarques :
si aucun nom de fichier n'est donn en paramtre, le programme demande un ou
plusieurs noms de fichiers,
si aucun nom n'est fourni, le programme s'arrte,
lors de son activation, secinit prend en charge la cration de la base de scurit.
3.4.7. secupdate
secupdate est un utilitaire permettant la mise jour de l'environnement d'habilitation de CFT.
Syntaxe
secupdate <filename> [<filename> ...]
Remarque :
il faut considrer cette commande comme un alias de SECUTIL @<filename> pour chaque nom
de fichier donn en paramtre de la ligne de commande.
CFT V2.3 3-8
3.5. Utilitaires de manipulation de CFT
3.5.1. cftcata
cftcata est en fait un raccourci amlior de la commande CFTUTIL LISTCAT avec les options
TYPE=ALL, CONTENT=DEBUG
Syntaxe
cftcata [IDT]
Usage classique
Cette commande est utilise sans paramtre. cftcata affiche, page par page et sans bannire, le
contenu en totalit (mode debug) du catalogue de CFT.
Usage volu
Cette commande est utilise avec, en paramtre, un identifiant de transfert (IDT). cftcata affiche,
page par page et sans bannire, le contenu en totalit (mode debug) du catalogue de CFT
concernant l'identifiant prcis.
3.5.2. cftcatab
cftcatab est en fait un raccourci amlior de la commande CFTUTIL LISTCAT avec les opitons
TYPE=ALL, CONTENT=BRIEF
Syntaxe
cftcatab [STATE]
Usage classique
Cette commande est utilise sans paramtre. cftcatab affiche, page par page et sans bannire, le
contenu condens (mode brief) du catalogue de CFT.
Usage volu
Cette commande est utilise avec, en paramtre, un tat de transfert (STATE). cftcatab affiche,
page par page et sans bannire, le contenu simplifi (mode brief) du catalogue de CFT concernant
l'tat de transfert choisi.
3.5.3. cftcatal
cftcatal est un utilitaire dont l'une des fonctions est de permettre l'augmentation dynamique de la
taille du fichier catalogue de CFT, sans perdre les informations qu'il contient.
cftcatal permet aussi, lors de la migration de CFT V2.2.0 vers les versions plus rcentes de
CFT/V2/UNIX, la migration du fichier catalogue de l'ancien vers le nouveau format.
CFT V2.3 3-9
Syntaxe
cftcatal
La commande cftcatal permet :
la modification de la taille du catalogue de CFT/V2/UNIX,
la migration dun catalogue format V220 en format CFT/V2/UNIX.
3.5.4. cftlog
cftlog est en fait un raccourci pour la visualisation pagine du fichier journal de CFT. La
pagination est ralise par lutilitaire more.
Syntaxe
cftlog
3.5.5. cftalog
cftalog est en fait un raccourci pour la visualisation pagine du fichier journal altern de CFT. La
pagination est ralise par lutilitaire more.
Syntaxe
cftalog
3.5.6. cftparm
cftparm est en fait un raccourci amlior de la commande CFTUTIL LISTPARM TYPE=ALL
Syntaxe
cftparm
3.5.7. cftpart
cftpart est en fait un raccourci amlior de la commande CFTUTIL LISTPART TYPE=ALL
Syntaxe
cftpart
CFT V2.3 3-10
3.5.8. cftdelcat
cftdelcat est en fait un raccourci amlior de la commande CFTUTIL DELETE
Syntaxe
cftdelcat [part=PART]
Usage classique
Cette commande est utilise sans paramtre. cftdelcat procde la destruction de tous les postes du
catalogue de CFT :
cftdelcat
Usage volu
Cette commande est utilise avec, en paramtre, la dfinition dun partenaire (dans notre exemple,
le partenaire TOULOUSE). cftdelcat procde la destruction de tous les postes du catalogue de
CFT pour le partenaire choisi :
cftdelcat part=TOULOUSE
3.5.9. xfbadm
xfbadm est un utilitaire de dmarrage et darrt contrl du Serveur IUI. Cet utilitaire peut tre
utilis par loprateur, seul ou en complment des actions demandes au niveau des commandes
cftstart ou cftstop.
Activation du serveur
La syntaxe gnrale de la commande de dmarrage du serveur est de la forme :
xfbadm start nom_de_serveur [options_de_trace]
Le paramtre nom_de_serveur doit correspondre un nom de serveur IUI tel que dcrit dans
le fichier de configuration xfbsrv.ini (voir le chapitre utilisation des lments additionnels ).
Les options de trace, qui sont facultatives, peuvent prendre les formes dcrites dans le tableau ci-
aprs.
Tableau 4. Paramtres de trace pour xfbadm
Paramtre Action
null Pas de traces
console Traces rediriges sur le canal /dev/console
term Traces affiches sur le terminal excutant la commande
file Traces rediriges dans des fichiers placs dans le rpertoire fillog de CFT.
Arrt du serveur
La syntaxe gnrale de la commande darrt du serveur est de la forme :
xfbadm stop nom_de_serveur
CFT V2.3 3-11
3.5.10. xfbadmgrp
+A223
xfbadmgrp est un utilitaire de cration, destruction et modification dun groupe (dutilisateurs)
accdant au serveur IUI. Il peut tre utilis en interactif associ avec un mot de commande (add,
delete) ou en mode batch en prcisant chacune des commandes ncessaires (-G group p passwd
).
Remarque :
la variable denvironnement CFTDIRSEC doit tre dfinie afin de permettre lutilitaire de
manipuler le fichier xfbgroup contenu dans cft/filsec.
Syntaxe gnrale des diffrentes commandes
Ajout dun groupe dutilisateurs :
xfbadmgrp add [-G <group>] [-p <passwd>] [-g <GID>] [-u <users>]
Suppression dun groupe dutilisateurs :
xfbadmgrp delete [-G <group>]
Modification dun groupe dutilisateurs :
xfbadmgrp modify [-G <group>] [-p <passwd>] [-g <GID>] [-u
<users>]
Affichage des informations sur les groupes existants :
xfbadmgrp print [-G <group>]
Affichage dinformations sur un groupe donn ( si loption -G est utilise ) ou sur tous les groupes
existants :
Usage classique
xfbadmgrp add | delete | modify | print | help
Usage volu
Diverses options peuvent tre utilises pour simplifier la saisie ou permettre le fonctionnement en
mode batch :
-G <group> : nom ASCII du groupe dutilisateurs,
-p <passwd> : mot de passe daccs ce groupe,
-g <GID> : identifiant numrique du groupe.
Si sa valeur est AUTO, le GID est gnr automatiquement,
-u <usr1,usr2> : liste dutilisateurs pralablement existants, spars par une virgule.
CFT V2.3 3-12
3.5.11. xfbadmusr
+A223
xfbadmusr est un utilitaire de cration, destruction et modification dun utilisateur accdant au
serveur IUI. Il peut tre utilis en interactif associ avec un mot de commande (add, delete) ou
en mode batch en prcisant chacune des commandes ncessaires (-l login p passwd ).
Remarque :
la variable denvironnement CFTDIRSEC doit tre dfinie afin de permettre lutilitaire de
manipuler le fichier xfbpasswd contenu dans cft/filsec.
Syntaxe gnrale des diffrentes commandes
Ajout dun utilisateur :
xfbadmusr add [-l <login>] [-p <passwd>] [-u <UID>] [-g <GID>]
Si le groupe nexiste pas, il est automatiquement cr et porte comme nom le login de lutilisateur.
Suppression dun utilisateur :
xfbadmusr delete [-l <login>]
Lutilisateur est aussi automatiquement supprim, au niveau du fichier xfbgroup, de tous les
groupes auxquels il est rattach.
Modification dun utilisateur :
xfbadmusr modify [-l <login>] [-p <passwd>] [-u <UID>] [-g <GID>]
Si ncessaire, les modifications se rpercutent automatiquement sur le fichier xfbgroup.
Affichage des informations sur les utilisateurs existants :
xfbadmusr print [-l <login>] :
Affichage dinformations sur un utilisateur ( si loption -l est utilise ) ou sur tous les utilisateurs
existants.
Usage classique
xfbadmusr add | delete | modify | print | help.
Usage volu
Diverses options peuvent tre utilises pour simplifier la saisie ou permettre le fonctionnement en
mode batch :
-l < login > : nom de login,
-p < passwd > : mot de passe,
-u < UID > : identifiant de lutilisateur.
Si sa valeur est AUTO, un UID est gnr automatiquement,
-g < GID > : identifiant du groupe.
Si sa valeur est AUTO, le GID est gnr automatiquement.
CFT V2.3 3-13
3.6. Utilitaires caractre systme
3.6.1. cft2unix
cft2unix est un utilitaire permettant, au sein dun shell utilisateur, de rcuprer la valeur d'une
variable d'environnement ou d'un nom de fichier logique manipul par CFT. Cette commande est
surtout utilise dans les procdures de basculement (switch) du fichier journal et du fichier
statistiques (voir le chapitre "Mise en exploitation de CFT" consacr aux procdures de
basculement).
Syntaxe
cft2unix <string>
Usage
% cft2unix _CFTLOG
/home/tranfer/cft/fillog/cft_log
%
3.6.2. cftkey
cftkey est un petit utilitaire, dont la seule vocation est de visualiser lcran lensemble des
informations qui peuvent tre demandes par le service technique d'Axway Software, en vue
dobtenir des informations sur votre machine.
Syntaxe
cftkey
Usage
% cftkey
Informations techniques sur votre systme
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
build IBM/BULL
model A0
procs 02
cpuid 8828D8828D8828D8
syst AIX
level 4
state 1
Lexemple ci-dessus illustre les informations fournies par cftkey sur une machine dorigine IBM,
sous AIX 4.1.
Il est noter que linformation procs donne :
la valeur 1+ sil nest pas possible de dterminer dynamiquement le nombre de
processeurs,
sinon, le nombre de processeurs physiquement prsents sur la machine (et non pas le
nombre de processeurs activs).
CFT V2.3 3-14
3.6.3. cftversion
cftversion permet d'obtenir l'quivalent de la commande CFTUTIL ABOUT sans les bannires
associes. Elle permet de fournir rapidement au service commercial les informations ncessaires,
par exemple, au calcul de la cl de protection logicielle ou la dtermination de l'tat technique de
CFT.
Syntaxe
cftversion
Usage
% cftversion
CFT/V2/UAIX
2.2.3 2000/12/01 <- Date de gnration
Copyright SOPRA 1989-2000
informations:
* product = CFT/V2/UAIX
* version = 223
* level = 1a-200-U0C
* Upgrade = 1404
informations: <- Informations
* model = A0 <- pour le calcul
* cpuid = 8828D8828D8828D8 <- de la cl logicielle
ABOUT _ Correct
3.6.4. cftping
cftping est un utilitaire permettant de savoir si un CFT est lanc sous le compte de l'oprateur.
Syntaxe
cftping [-h | -v | -i | -p]
Attention : les rsultats obtenus par cette commande ne garantissent pas que CFT soit 100%
oprationnel.
Ils indiquent simplement que des lments, normalement issus de l'activation de CFT (processus
CFTMAIN et segment principal de mmoire partage), sont prsents sur le systme.
Usage dans un programme script crit en shell
L'un des intrts de cftping est de permettre, en testant le code retour de la commande, de savoir si
CFT est lanc ou non sur le compte de l'oprateur. Les 2 commandes cftstart et cftstop, dcritent
plus avant, utilisent cftping.
Utilis sans option au sein d'un script shell, le programme retourne les valeurs suivantes :
0 : CFT est inactif, l'environnement (mmoire partage) est correct,
1 : CFT est actif, l'environnement (mmoire partage) est cohrent,
2 : CFT est actif mais ltat est incohrent au niveau de la mmoire partage,
3 : CFT est inactif (CFTMAIN est absent) mais tat incohrent (un au moins des
segments de mmoire partage existe),
9 : erreur au niveau de la procdure.
CFT V2.3 3-15
Il est trs facile, au niveau dun script shell, de rcuprer ces valeurs et de les traiter. Par exemple,
dans un script crit en Korn Shell, on pourrait avoir les lignes suivantes :
cftpid = cftping -p` # mmorisation pid de CFT
code = $? # code dexcution de cftping
if [ "$code" != "0" ]
then
echo "CFT est inactif"
else
....Votre code de traitement derreur....
fi
Usage en interactif
Les diffrentes options possibles sont les suivantes :
-v : mode verbeux (affiche l'tat actuel de CFT sous la forme : alive, not running ou dead),
-i : information (donne des informations sur la mmoire partage et les smaphores),
-p : PID (donne le PID du processus ayant cr la mmoire partage).
En rgle gnrale, l'utilisateur tapera la commande sous la forme simple :
cftping -v
Les 3 types de rponse possibles sont les suivantes :
si CFT est inactif et que l'tat du systme est cohrent :
% cftping -v
cft: not running,
si CFT est actif (CFTMAIN prsent et tat systme cohrent) :
% cftping -v
cft is alive,
si CFT est dans un tat incohrent (plusieurs type de messages possibles) :
% cftping -v
cft: pid 26840 is dead.
3.6.5. x25loop
x25loop est un utilitaire qui permet, pour les systmes ne fournissant pas doutils en standard, de
valider le bon tat des lignes X25 de la machine avant de mettre CFT en exploitation.
x25loop est avant tout un outil adapt aux besoins classiques de CFT ; il se borne donc effectuer
une connexion en boucle et raliser diffrents tests d'mission et de rception de donnes. Ce
nest donc pas un outil de qualification du rseau.
Attention : loutil x25loop nest pas disponible sur toutes les plates-formes.
Remarque :
la commande x25loop implique quelques remarques ou rserves :
elle ne s'applique que pour un usage de X25 en rseau (comme TRANSPAC par
exemple).
Elle n'est pas utilisable si vous ne disposez que d'un seul circuit virtuel ou que d'une
liaison point point entre 2 machines (liaison de type Ligne Spcialise),
CFT V2.3 3-16
si la commande choue, il est peut probable que CFT fonctionnera,
si cette commande est utilise alors qu'un CFT est actif, ceci peut amener un
dysfonctionnement svre de CFT,
si 2 utilisateurs lancent simultanment la commande, des rsultats imprvisibles peuvent
survenir,
il est possible que la commande x25loop ne soit pas disponible sur votre machine.
En effet, certains constructeurs proposent directement un outil de validation quivalent.
Syntaxe gnrale
x25loop <dialno> [-l#] [-m] [-t<tempo>]
ou
x25loop -h
avec :
<dialno> : le numro ou adresse X25 de votre machine,
[-l#] : paramtre optionnel ou # reprsente le numro de votre voie X25 (0 pour la 1re, 1
pour la seconde...),
[-m]: cette option ne doit tre utilise que sur les machines AIX lorsque le logiciel X25
utilis est BullX25,
[-t<tempo>]: par dfaut, les dlais dattente de loutil sont calculs pour des lignes
9600 bps.
Si vos lignes sont plus lentes (ou si le dbit ngoci est infrieur), il peut tre ncessaire
daugmenter les dlais dattente.
Syntaxe spcifique
En fonction des logiciels X25 utiliss sur les diffrentes souches UNIX, il peut tre parfois
ncessaire de prciser la commande x25loop quelle interface X25 utiliser. Cette information, si
ncessaire, est prcise dans la partie X25 spcifique votre machine du "Guide Technique
CFT/V2/UNIX".
On y trouvera, par exemple le cas des plates-formes AIX, o il est possible davoir les 2 syntaxes :
./x25loop <dialno> ou ./x25loop -m <dialno>
Usage classique
Par exemple, aprs avoir configur X25 pour fonctionner avec CFT avec la premire ligne de
votre systme, et avant de lancer CFT, utilisez la commande x25loop avec, en paramtre, votre
adresse X25 :
x25loop 195280232
CFT V2.3 3-17
En cas de succs, il saffiche une squence approchant le modle ci-dessous :
% x25loop 32
x25loop v1.4 - Copyright (C) 1998 SOPRA
Working on "gandalf", AIX 4.1
Calling 32, line 0, default sap : "X2526264".
Starting X25 .............................. OK
Starting link #00 ......................... OK
Performing asynchronous listen ............ OK
Calling 32 ................... OK
Receiving call ............................ OK
. Incoming call from .. : 32
. Facilities .......... : 010002bb
. User-data ........... : 5832353236323634
Confirming CALL ........................... OK
Receiving CALL CF ......................... OK
Sending 32 bytes ........................ 32 bytes rcvd.
Sending 4096 bytes ........................ 4096 bytes rcvd.
Sending 2048 bytes ........................ OK
Sending 2048 bytes ........................ OK
Waiting 2048 bytes ........................ 2048 bytes rcvd.
Waiting 2048 bytes ........................ 2048 bytes rcvd.
Sending CLEAR ............................. OK
Receiving CLEAR ........................... OK
Sending CLEAR CF .......................... OK
Stopping asynchronous listen .............. OK
Stopping link #00 ......................... OK
Stopping X25 .............................. OK
*** Test OK ***
%
Remarque :
si certaines des lignes affiches contiennent l'information "TEST ERROR" ou si le test s'achve
avec la mention "Test unsuccesfull", revrifiez votre configuration et relancez le test.Si votre ligne
ne dispose que dun faible dbit ou si votre commutateur est charg, essayez de relancer le test en
ayant augment les temporisations dattente laide de loption -t suivi dun dlai exprim en
secondes.
Usage volu
Les autres paramtres ne sont utiliser que sur demande spcifique du support technique.
3.6.6. xvi
xvi est un utilitaire permettant la manipulation d'une table de transcodage.
Syntaxe
xvi [-d | -a | -e | -l <fichier> ] <table>
Usage classique
xvi <table> : Manipulation d'une <table> existante et valide (256 caractres).
CFT V2.3 3-18
Usage volu
Les diffrentes options utilisables avec xvi sont les suivantes :
-d : affichage l'cran et en ASCII d'une <table> existante et valide,
-a : cration d'une <table> pour la conversion ASCII -> EBCDIC.
Cette table est identique la table accde via le CFTXLATE de CFT (si <table>
existe, son contenu est perdu),
-e : cration d'une <table> pour la conversion EBCDIC->Ascii.
Cette table est identique la table accde via le CFTXLATE de CFT (si <table>
existe, son contenu est perdu),
-l : cration d'une <table> partir d'un <fichier> ASCII.
Typiquement, le fichier utilis ici est le fichier obtenu aprs usage de l'option -d (si
<table> existe, son contenu est perdu.
CFT V2.3 4-1
4. Pralable la mise en uvre de CFT
4.1. Prsentation
Avant de pouvoir tester la bonne installation de XFB Monitor CFT/V2/UNIX, un certain nombre
d'oprations est raliser.
obtention de la cl de protection,
configuration, si ncessaire, des moyens de communication en :
- TCP,
- X25,
- LU 6.2.
4.2. Cl de protection logicielle
Le fonctionnement de CFT est soumis la dtection d'une cl de protection logicielle. Si elle ne
vous a pas t fournie lors de la livraison du produit, il est ncessaire d'en demander une au service
commercial d'Axway Software.
4.2.1. Obtention de la cl de protection
Pour obtenir cette cl de protection, utiliser la commande cftversion voque au chapitre
"Utilitaire caractre systme" et fournir les informations modle et cpuid ainsi obtenues notre
service commercial. Celui-ci, l'aide de ces informations, tablira une cl de protection prcisant :
les caractristiques de votre machine,
les options protocolaires ou rseau de CFT dont vous disposez.
4.2.2. Prise en compte de la cl de protection
La cl qui vous a t dlivre doit figurer dans tout paramtrage CFT, au niveau du champ KEY de
la commande CFTPARM (des informations complmentaires sur KEY et CFTPARM sont
disponibles dans le guide "Concepts" de CFT).
4.3. Oprations de paramtrage
Ces oprations de paramtrage ont pour but de vrifier que les logiciels rseaux utiliss prennent
en compte les ventuels besoins spcifiques de CFT.
Que ce soit pour TCP, pour X25 ou pour SNA LU6.2, cette opration est dpendante du systme
dexploitation et des logiciels utiliss ou supports.
Vous trouverez toutes les informations techniques ncessaires dans le manuel "Guide Technique
CFT/V2/UNIX", dans la section correspondant votre machine.
CFT V2.3 5-1
5. Premiers lancements de CFT
5.1. Prsentation
Dans ce chapitre, nous allons vous proposer de raliser vos premiers transferts l'aide d'un
paramtrage de test en boucle, permettant ainsi de valider l'installation de XFB Monitor
CFT/V2/UNIX sans avoir recourir un quipement distant.
Ces tests porteront sur les rseaux TCP et X25, rseaux qui permettent facilement de raliser des
transferts en boucle.
5.2. Test dinstallation de CFT en mode TCP
Pour raliser ce test, nous allons utiliser un fichier de configuration ex_conf_fr.tcp prvu cet
effet, fourni dans le rpertoire filinst de CFT.
Aprs avoir configur ce fichier pour rpondre aux besoins de votre installation, nous allons
successivement dmarrer CFT, raliser un transfert puis arrter CFT.
5.2.1. Paramtrage du moniteur CFT
Avant de lancer les programmes de test, il est ncessaire de raliser un certain nombre d'actions
dans le fichier de configuration de CFT.
Ces oprations de configuration vont porter sur :
la saisie de la cl de protection logicielle,
la dfinition des caractristiques TCP locales (nom de votre machine et port d'coute
TCP),
la dfinition des partenaires (nom de votre machine puisque les transferts seront
raliss en boucle).
Actions entreprendre
1. A l'aide de votre diteur (par exemple vi), diter le fichier ex_conf_fr.tcp situ sous le
rpertoire filinst.
2. Rechercher, dans la section CFTPARM, le paramtre KEY.
Si ce dernier n'est pas renseign, insrer la valeur de la cl de protection logicielle qui
vous a t fournie.
KEY = 046zmuhj7vvo8jikxlbeya09i
3. Rechercher, dans la section CFTNET, le paramtre HOST.
Vous devez indiquer ici le nom de votre machine telle qu'elle est connue du rseau. Ne
pas mettre localhost.
Premiers lancements de CFT
CFT V2.3 5-2
cftnet id = TCPIP,
type = TCP,
call = inout,
host = myhost,
maxcnx = 3,
mode = replace
4. De mme, rechercher dans les 2 sections CFTTCP identifiant les partenaires PARIS et
TOULOUSE, le paramtre HOST.
Vous devez indiquer ici le nom de votre machine telle qu'elle est connue du rseau. Ne
pas mettre localhost..
cfttcp id = TOULOUSE,
host = myhost,
cnxin = 8,
cnxout = 8,
5. Pour fonctionner en TCP, CFT a besoin d'un numro de port disponible. Par dfaut, la
procdure de test utilise le port 1761, premier des 8 ports rservs par Axway Software
auprs du IANA (Internet Assigned Numbers Authority) (voir ce sujet le guide
"Concepts").
Cependant, si ce numro de port est dj utilis sur votre systme (voir le fichier
systme /etc/services ou utiliser la commande systme netstat), vous devez modifier le
paramtrage de CFT. Pour cela il faut rechercher, dans les sections CFTPROT et
CFTPART, les champs SAP et remplacer la valeur actuelle de 1761 par un numro de
port disponible sur votre systme. Ce numro de port pourra tre l'un des autres ports
rservs de CFT (entre 1761 et 1768) ou tout autre port disponible sur votre systme
(gnralement suprieur 5000).
CFTPROT ID = PESITCFT,
TYPE = PESIT,
PROF = CFT,
NET = TCPIP,
SAP = 1761, /* Port d'coute */
CFTPART ID = TOULOUSE,
PROT = PESITCFT,
SAP = 1761, /* Port d'coute */
6. Sauvegarder vos modifications.
5.2.2. Excution du test
La procdure est la suivante :
1. Se placer sous le rpertoire filinst .
2. Gnrer les informations de configuration de CFT l'aide de l'utilitaire cftinit :
cftinit ex_conf_fr.tcp
3. Aprs lapparition du message "cftinit complete", activer CFT l'aide de
l'utilitaire cftstart :
cftstart
CFT V2.3 5-3
4. Aprs l'apparition du message "CFTMAIN process id is xxxxx", vrifier
ventuellement l'tat correct de CFT l'aide de l'utilitaire cftping :
cftping -v
5. Lancer un transfert de type texte destination du partenaire TOULOUSE en tapant la
commande :
cftutil send part=TOULOUSE,idf=txt
6. Aprs quelques instants, vous pouvez vrifier l'tat du transfert en tapant la
commande :
cftcatab
Vous devez obtenir un rsultat voisin de celui repris ci-dessous (si le transfert n'est pas
termin, retaper une 2me fois la commande cftcatab).
CFT/V2/UAIX
Version 223 2000/12/01
(C) Copyright SOPRA 1989-2000
Date = 01/12/2000, Time = 20:00
Partner STSA File Transfer Records Diag Diag
Applic
Ident Ident Transmit Total Protocol Ident
-------- ---- ----- -------- -------- ---------- --------
PARIS RFT TXT B1820002 112 112 0 CP 34%
TOULOUSE SFT TXT B1820002 112 112 0 CP 34%
2 record(s) selected
2 record(s) in Catalog file
498 record(s) free (99%)
CFTU00I LISTCAT _ Correct
7. Il vous faut maintenant arrter CFT l'aide de l'utilitaire cftstop :
cftstop
8. Aprs l'apparition du message "CFT stopped correctly.", vrifier
cftping -v
qui doit, tout naturellement, indiquer :
cft: not running
5.3. Test dinstallation de CFT en mode X25
Pour raliser ce test, nous allons utiliser un fichier de configuration ex_conf.x25 prvu cet effet,
fourni dans le rpertoire filinst de CFT.
Aprs avoir configur ce fichier pour rpondre aux besoins de votre installation, nous allons
successivement dmarrer CFT, raliser un transfert puis arrter CFT.
Attention : les renseignements fournir ci-aprs tant fortement dpendants du type de machine
que vous utilisez, il est fortement conseill de se rfrer au "Guide dexploitation" spcifique de
votre machine pour de plus amples informations.
CFT V2.3 5-4
5.3.1. Rappel sur ladressage X25
Dans le cas le plus gnral, une adresse X25 est compose de 8 ou 9 chiffres (par exemple :
175123456).
Ce numro vous est indiqu dans les documents accompagnant votre abonnement.
Pour intgrer cette adresse dans le paramtrage de CFT, il suffit donc de reporter cette adresse
dans le paramtre DIALNO de la carte CFTX25 :
DIALNO = 175123456
Quand on utilise un commutateur, il est souvent ncessaire de spcifier un numro de porte sur ce
commutateur. Dans le paramtrage CFT, le numro de porte doit tre ajout en fin de l'adresse
X25.
Par exemple : pour un numro de porte gal 54, l'adresse est la suivante :
DIALNO = 17512345654
Sur certains commutateurs, l'accs au rseau public doit tre fait travers une porte ddie la
sortie des appels. Dans le paramtrage CFT, ce numro de porte doit tre ajout en dbut de
ladresse X25.
Par exemple : pour un numro de porte de sortie gal 00, l'adresse est la suivante :
DIALNO = 0017512345654
Avant de lancer les programmes de test, il est ncessaire de raliser un certain nombre d'actions
dans le fichier de configuration de CFT.
Ces oprations de configuration vont porter sur :
la saisie de la cl de protection logicielle,
la dfinition des caractristiques X25 locales (adresse de rseau X25, identifiant de la
carte et/ou du port utiliser, valeur du sap exprim en sous-adresse ou en donnes
utilisateur),
la dfinition des partenaires (valeur du sap exprim en sous-adresse ou en donnes
utilisateur).
Actions entreprendre
1. A l'aide de votre diteur (par exemple vi), diter le fichier ex_conf.x25 situ sous le
rpertoire filinst.
2. Rechercher, dans la section CFTPARM, le paramtre KEY. Si ce dernier n'est pas
enseign, insrer la valeur de la cl de protection logicielle qui vous a t fournie :
KEY = 046zmuhj7vvo8jikxlbeya09i,
CFT V2.3 5-5
3. Rechercher, dans la section CFTX25, le champ DIALNO. Si ce dernier n'a pas t
renseign, insrer votre numro d'appel X25 :
CFTX25 ID = TOULOUSE,
DIALNO = 195310118, /* Numro d'appel */
4. CFT est capable de grer plusieurs cartes X25 et, par dfaut, utilise lors des tests la
premire carte X25 disponible. Si, pour diverses raisons, vous devez utiliser une autre
carte, il est ncessaire de modifier, dans la section CFTNET, le champ LINEID.
Pour des informations complmentaires sur le champ LINEID, consultez le "Guide
dexploitation UNIX" spcifique votre machine.
CFTNET ID = X.25,
TYPE = X25
LINEID = CIOline.0, /* guide spcifique */
5. Pour fonctionner en X25, CFT peut utiliser un routage de lappel sur sous-adresse ou
sur donnes utilisateur. Par dfaut, ce programme de test utilise un routage sur la
sous-adresse 177.
Si cette sous-adresse est dj utilise sur votre rseau X25, vous devez modifier le
paramtrage de CFT.
Rechercher, dans les sections CFTPROT et CFTPART, les champs SAP et remplacer
la valeur 177 par une sous-adresse disponible sur votre systme.
CFTPROT ID = PeSITCFT,
TYPE = PESIT,
PROF = CFT,
NET = X.25,
SAP = 177, /* Exemple de SAP en */
/* sous-adresse */
PROT = PESITCFT,
SAP = 177, /* Exemple de SAP en */
/* sous-adresse */
Si votre rseau ou votre logiciel X25 ne supporte pas le routage sur sous-adresse,
vous devez modifier le fichier de paramtrage pour l'adapter au routage sur donnes
utilisateur. Rechercher, dans les sections CFTPROT et CFTPART, les champs SAP et
remplacer la valeur 177 par une donne utilisateur (voir la syntaxe dans le "Manuel
de rfrence" de CFT).
CFTPROT ID = PeSITCFT,
TYPE = PESIT,
PROF = CFT,
NET = X.25,
SAP = "TEST" /* Exemple de SAP sur */
/* donnes utilisateur */
PROT = PeSITCFT,
SAP = "TEST" /* Exemple de SAP sur */
/* donnes utilisateur */
6. Sauvegarder vos modifications.
CFT V2.3 5-6
2. Gnrer les bases de CFT l'aide de l'utilitaire cftinit :
cftinit ex_conf.x25
3. Aprs l'apparition du message "cftinit complete", activer CFT l'aide de l'utilitaire
cftstart :
cftstart
4. Aprs l'apparition du message "CFTMAIN process id is xxxxx", vrifier
cftping -v
5. Lancer un transfert de type texte destination du partenaire TOULOUSE en tapant la
commande :
cftutil send part=TOULOUSE,idf=txt
6. Aprs quelques instants, vous pouvez vrifier l'tat du transfert en tapant la commande :
cftcatab
Vous devez obtenir un rsultat voisin de celui repris ci-dessous (si le transfert n'est
pas termin, retaper une 2me fois la commande cftcatab) :
CFT/V2/UAIX
Version 223 2000/12/01
Date = 01/12/2000, Time = 20:00
Partner STSA File Transfer Records Diag Diag Applic
Ident Ident Transmit Total Protocol Ident
-------- ---- ------ -------- -------- ------- ---
PARIS RFT TXT B1820002 112 112 0 CP 34%
TOULOUSE SFT TXT B1820002 112 112 0 CP 34%
2 record(s) selected
2 record(s) in Catalog file
498 record(s) free (99%)
CFTU00I LISTCAT _ Correct
7. Il faut maintenant arrter CFT l'aide de l'utilitaire cftstop :
cftstop
8. Aprs l'apparition du message "CFT stopped correctly.", vrifier l'tat correct de CFT
l'aide de l'utilitaire cftping :
cftping -v
qui doit, tout naturellement, indiquer :
cft: not running
CFT V2.3 6-1
6. Mise en exploitation de CFT
6.1. Oprations de paramtrage
Que ce soit pour TCP, pour X25 ou pour SNA LU6.2, cette opration est fortement dpendante du
systme dexploitation et des logiciels utiliss ou supports.
Vous trouverez toutes les informations techniques ncessaires dans le "Guide Technique
CFT/V2/UNIX", dans la section correspondant votre machine.
6.2. Configuration du moniteur CFT
L'action de paramtrage consiste dfinir les donnes de base ncessaires l'exploitation de CFT.
Il est souhaitable que le moniteur ne soit pas actif pendant le paramtrage, les paramtres
fondamentaux n'tant pas modifiables dynamiquement.
Les fichiers ex_conf_fr.tcp ou ex_conf_fr.x25, mentionns pendant la phase de test, peuvent tre
utiliss comme exemple de paramtrage. Ces fichiers se trouvent sous le rpertoire filinst.
Pour des informations complmentaires concernant la mise en uvre du paramtrage, consultez le
guide "Concepts" de CFT.
6.2.2. Cration initiale des fichiers "Environnement CFT" et initialisation
La commande cftinit, situe sous le rpertoire filusr, est un utilitaire qui s'appuie sur CFTUTIL et
assure la cration de "l'environnement de CFT", c'est--dire :
la cration des fichiers paramtres, partenaires, journaux, ...
le paramtrage de CFT.
Le paramtrage se fait travers le fichier de commande pass en paramtre l'utilitaire cftinit.
1. Pour excuter cette commande, taper :
cftinit filename
o filename reprsente le nom de votre fichier de paramtrage.
Exemple :
cftinit ex_conf_fr.tcp
Attention : cette commande assure la configuration initiale de CFT i.e., tous les fichiers de
configuration sont recrs ; toute configuration prcdente, ainsi que les informations contenues
dans les fichiers de type communication, catalogue ou journal sont donc perdues.
Mise en exploitation de CFT
CFT V2.3 6-2
6.3. Activation et arrt de CFT
6.3.1. Activation de CFT par la commande cftstart
Le lancement de CFT est obtenu simplement par le biais de lutilitaire cftstart, dj voqu au
chapitre "Utilitaires de gestion de CFT".
6.3.2. Activation automatique de CFT au dmarrage de la machine
La mthode utiliser, pour lancer CFT lors du dmarrage de la machine, peut varier en fonction du
type de systme que vous utilisez. Nous allons vous proposer ci-aprs les 2 grandes mthodes de
base pour raliser cette activation. Il en existe probablement beaucoup d'autres mais, parmi les 2
proposes, il y en a au moins une qui doit s'adapter facilement votre machine ainsi qu' la
philosophie d'administration de votre systme.
Attention : nous n'allons voquer dans ces procdures que l'aspect dmarrage automatique de CFT.
En effet, l'arrt de CFT tant plus ou moins rapide en fonction de l'activit en cours, un arrt
automatique de CFT risquerait de suspendre temporairement la procdure d'arrt du systme.
Dans les exemples que nous allons fournir ci-dessous, nous prendrons les conventions suivantes :
CFT a t install sous le compte de l'utilisateur mycft,
CFT a t install de faon standard sous le rpertoire cft de ce compte,
le rpertoire racine de cet utilisateur est /home/mycft,
CFT a t correctement install, configur et test manuellement avant de tenter
l'activation par une procdure automatique,
lutilitaire systme su() est situ sous le rpertoire /bin.
Attention : ces diffrentes procdures requirent des modifications dans des fichiers systmes
vitaux. Toute erreur peut conduire la non disponibilit de la machine.
Ces modifications ncessitent donc l'intervention de votre administrateur systme.
La mmorisation des messages derreur se produisant durant le lancement automatique sappuye
sur la commande systme logger(). Le bon fonctionnement de ce dispositif impose donc que le
dmon systme syslogd() soit effectivement actif sur votre systme. Ladministrateur du systme
pourra identifier facilement, dans ses fichiers journaux, les messages spcifiques de CFT qui sont :
pour les erreurs de niveau error et de facilit local0,
pour un lancement correct de niveau information et de facilit local0.
6.3.2.1. Usage du fichier /etc/inittab
Cette procdure doit, normalement, fonctionner sur toutes les machines UNIX.
A l'aide d'un diteur classique (vi par exemple), ajouter la fin du fichier /etc/inittab la ligne
suivante :
CFTV2:2:once:/bin/su - mycft -c . $HOME/ENV_CFT ;cftstart batch
Pour de plus amples informations sur le rle et la syntaxe des diffrents paramtres, consultez la
documentation de votre systme.
CFT V2.3 6-3
6.3.2.2. Ajout dun fichier sous /etc/rc3.d
Cette mthode n'est applicable que sur les systmes disposant d'un rpertoire nomm /etc/rc3.d
(Solaris par exemple).
A l'aide d'un diteur classique (vi par exemple), crer un nouveau fichier nomm, par exemple,
/etc/rc2.d/S99cftv2.
Insrer dans ce fichier le script shell de dmarrage conforme vos procdures dexploitation. Un
exemple simpliste vous est propos avec le script shell suivant :
#!bin/sh
# Dmarrage de CFT
if [ -f /home/mycft/cft/filusr/cftstart ]
then
/bin/su - mycft -c . $HOME/ENV_CFT ;cftstart batch
fi
Pour de plus amples informations sur le rle et la syntaxe de nomage de ce type de fichier,
consultez la documentation de votre systme.
6.4. Arrt du moniteur CFT
L'arrt de CFT peut tre obtenu de 3 faons :
par le biais de l'utilitaire cftstop,
par le biais des fonctions interactives (voir ce sujet le guide ddi lutilisation des
fonctions interactives),
l'aide de l'utilitaire CFTUTIL.
Mme si cela reste trs rare, il peut exister des cas de figure o CFT ne peut pas tre stopp
normalement, suite un problme systme. Nous voquerons donc plus loin un arrt "en
catastrophe" .
6.4.1. Arrt de CFT laide de la commande cftstop
Il sagit de la mthode privilgie pour arrter CFT. En effet, cette commande ralise un certain
nombre de contrles lors de larrt et assure un nettoyage complet de lenvironnement de
lutilisateur (mmoires partages, files de messages, processus et fichiers intermdiaires).
Des informations complmentaires sur cette commande sont donnes au chapitre "Utilitaires de
gestion de CFT".
CFT V2.3 6-4
6.4.2. Arrt de CFT par lutilitaire CFTUTIL
Si lutilitaire CFTUTIL nest pas actif :
1. Se placer dans le rpertoire filexe et taper la commande :
CFTUTIL
2. A l'apparition du repre "CFT>", taper la commande suivante :
SHUT
3. Enfin, pour terminer CFTUTIL, taper la commande :
/END
Des informations complmentaires sur le fonctionnement de CFTUTIL sont fournies dans le guide
"Concepts" de CFT.
6.4.3. Arrt brutal de CFT
Dans certains cas, lis des problmes systme, il nest pas possible de procder un arrt normal
de CFT. Dans ces cas de figures, mme lusage de loption kill avec la commande cftstop
reste sans effet.
Il est alors ncessaire dutiliser une mthode plus brutale, mais cependant propre, pour arrter
CFT :
1. Lister, laide de la commande systme ps, lensemble des processus du CFT
utilisateur qui ne rpond plus.
2. Noter le numro de processus (PID) dune des taches du CFT (gnralement, on
prendra CFTMAIN, CFTTPRO ou CFTTCPS).
3. Taper la commande :
kill 15 <PID du processus supprimer>
Cette action va conduire, en quelques secondes, la suppression de tout ce qui est en rapport avec
le CFT qui ne rpond plus (ensemble des processus mais aussi les mmoires partages, files de
messages et fichiers intermdiaires).
Attention : nutiliser quen dernier recours la commande kill avec le paramtre "-9" . En effet,
cette mthode nappelle pas la fonction de nettoyage de lenvironnement sur arrt brutal de CFT.
Lusage du "kill 9" impose alors la destruction manuelle et individuelle des processus mais aussi
des mmoires partages, des files de messages, des smaphores et de tous les fichiers
intermdiaires.
CFT V2.3 6-5
6.5. Excution de CFTUTIL
CFTUTIL est une interface utilisateur en mode ligne qui permet de crer manuellement
l'environnement de travail de CFT et de paramtrer le produit :
cration, suppression des fichiers paramtres, partenaire, catalogue, journal et statistiques
(account).
Attention : ces oprations ne peuvent tre effectues que lorsque CFT est arrt,
modification, ajout de certains paramtres,
visualisation des fichiers paramtres, partenaire, catalogue, journal et statistiques
(account),
envoi de commandes au moniteur.
6.5.1. Activation
L'activation est obtenue en tapant directement CFTUTIL au clavier, sous le rpertoire des
excutables de CFT ou partir d'un rpertoire quelconque, si la variable d'environnement PATH
inclut le chemin d'accs aux excutables CFT.
CFTUTIL peut aussi tre activ dans une procdure shell.
6.5.2. Saisie en mode ligne
CFTUTIL peut tre utilis comme un utilitaire acceptant des commandes en "mode ligne".
L'activation affiche un prompt "CFT >" indiquant la phase de saisie des commandes. L'oprateur
entre alors son texte en ligne et valide sa commande par la touche ENTER.
Pour sortir de CFTUTIL, taper la commande /end.
Exemple :
% CFTUTIL
CFT/V2/UAIX
Version 223 2000/12/01
CFT> send
part=siege,idf=txt,fname=/home/lisa/rapport.txt
CFTU94I SEND part=SIEGE,idf=TX _ Correct
CFT> /end
%
CFT V2.3 6-6
6.5.3. Paramtres dactivation
CFTUTIL peut galement prendre des commandes soit passes directement en paramtre, soit
passes dans un fichier regroupant les commandes :
commande passe en paramtre :
la ligne de commande est passe en paramtre de CFTUTIL sous la forme :
CFTUTIL commande paramtre=valeur, paramtre=valeur,...
Exemple :
CFTUTIL listcat part=siege, direct=send
se traduit par l'affichage l'cran de l'utilisateur du tableau des transferts prvus
(ou effectus) en mission vers le partenaire "siege",
fichiers passs en paramtre,
la commande suivante excute l'utilitaire CFTUTIL qui lira les commandes excuter
dans le fichier scen.cft et affichera les rsultats l'cran :
CFTUTIL @scen.cft
6.6. Prise en compte dutilisateurs supplmentaires
Si CFT doit tre exploit par des utilisateurs diffrents de celui sous le compte duquel CFT a t
install, il est ncessaire de procder des ajouts dans l'environnement de ces nouveaux
utilisateurs.
Remarque :
dans toutes les dfinitions qui vont suivre, l'utilisateur prendra pour hypothse que CFT est
install, par dfaut, sous le rpertoire racine ($HOME) de l'utilisateur, dans un sous-rpertoire
nomm cft.
Si vous avez choisi une autre installation, vous devrez adapter les dfinitions donnes.
6.6.1. Extension du chemin de commande (PATH)
Pour pouvoir utiliser un CFT plac sur un autre compte, il est ncessaire d'avoir dans sa variable
d'environnement PATH les chemins daccs aux diffrents rpertoires des commandes de CFT :
filexe, filusr, et filexit.
Les actions raliser sont dpendantes du type de shell utilis. On trouvera ci-dessous des
exemples pour lajout du rpertoire filexe la liste des chemins daccs :
si le shell de l'utilisateur est csh (C shell), la commande suivante est ajouter au fichier
~/.cshrc ou ~ /.login :
set path=($path ~compte_cft/cft/filexe)
si le shell de l'utilisateur est sh (BOURNE shell), ou ksh (KORN shell) la commande
suivante est ajouter au fichier $HOME/.profile :
PATH=$PATH:racine/compte_cft/cft/filexe ; export PATH
CFT V2.3 6-7
avec :
- racine : chemin d'accs aux rpertoires des utilisateurs (gnralement, /home),
- compte_cft : nom du compte d'installation de CFT.
Par exemple, l'accs CFT se trouvant sous le compte /home/transfert dans le sous-rpertoire cft
donne les commandes suivantes :
dans le cas de csh :
set path=($path ~transfert/cft/filexe)
dans le cas de sh ou ksh :
PATH=$PATH:/home/transfert/cft/filexe ; export PATH
6.6.2. Environnement daccs aux fichiers de CFT
Afin de pouvoir accder aux fichiers de configuration d'un CFT situ sur un autre compte, il est
ncessaire d'avoir dans son environnement les variables suivantes qui dfinissent les chemins
d'accs aux fichiers et rpertoires de CFT.
6.6.2.1. Variables denvironnement utilises par CFT
Le tableau ci-dessous donne la liste exhaustive, trie par ordre alphabtique, des variables
denvironnement utilises par CFT/V2/UNIX.
Pour en faciliter la lecture, lorsque nous ferons rfrence dans le reste de ce document une
variable d'environnement, nous utiliserons directement le nom de cette variable (par exemple,
l'assertion "fichier point par CFTCATA" devra tre interprte comme "le fichier dont le nom est
contenu dans la variable d'environnement CFTCATA").
Tableau 5. Chemin d'accs aux fichiers
Variable denvironnement Dfinition par dfaut
CFTDIRHOME Sommet de larborescence dinstallation de CFT
CFTDIRAPI Rpertoire filapi
CFTDIRDAT Rpertoire fildat
CFTDIREXE Rpertoire filexe
CFTDIREXI Rpertoire filexit
CFTDIRINQ Rpertoire fildat
CFTDIRINS Rpertoire filinst
CFTDIRLIB Rpertoire fillib
CFTDIRLOG Rpertoire fillog
CFTDIRNOT Rpertoire filnotes
CFTDIRPUB Rpertoire filpub
CFTDIRSEC Rpertoire filsec
CFTDIRUSR Rpertoire filusr
CFTFICNF Fichier d'initialisation des Fonctions Interactives
CFTFIDIR Rpertoire des Fonctions Interactives
CFTHADIR Rpertoire des bases pour le systme dhabilitation
CFTHICNF Fichier d'initialisation du systme d'habilitation
CFTHIDIR Fichier de mise en uvre du systme d'habilitation
CFT V2.3 6-8
Tableau 5. Chemin d'accs aux fichiers (suite)
Variable denvironnement Dfinition par dfaut
CFTHINI Fichier de mise en uvre du systme d'habilitation
CFTHPARM Fichier paramtre de mise en uvre du systme d'habilitation
CFTPKIDIR Rpertoire renfermant les informations de scurit
CFTACNT Fichier Statistiques
CFTACNTA Fichier Statistiques Altern
CFTCATA Fichier Catalogue
CFTTCOM Fichier Communication
CFTLOG Fichier Journal
CFTLOGA Fichier Journal Altern
CFTPARM Fichier Paramtres
CFTPART Fichier Partenaire
CFTPKU Fichier base PKI
CFTTRKCNF Fichier de configuration suivi Sentinel
CFTTRKEVT Fichier XML envents Sentinel
CFTTRKCYC Fichier XML link cycle Sentinel
6.6.2.2. Positionnement des variables denvironnement
En BOURNE shell (sh) ou en KORN Shell (ksh), les commandes suivantes sont, en fonction de
vos contraintes dexploitation, crer dans un fichier de mme philosophie que le fichier
ENV_CFT cr par dfaut lors de linstallation ou ajouter au fichier $HOME/.profile :
CFTDIRHOME=<chemin daccs au rpertoire dinstallation de CFT>
CFTDIRAPI=$CFTDIRHOME/filapi
CFTDIRDAT=$CFTDIRHOME/fildat
CFTDIREXE=$CFTDIRHOME/filexe
CFTDIREXI=$CFTDIRHOME/filexit
CFTDIRINQ=$CFTDIRHOME/fildat
CFTDIRINS=$CFTDIRHOME/filinst
CFTDIRLIB=$CFTDIRHOME/fillib
CFTDIRLOG=$CFTDIRHOME/fillog
CFTDIRNOT=$CFTDIRHOME/filnotes
CFTDIRPUB=$CFTDIRHOME/filpub
CFTDIRSEC=$CFTDIRHOME/filsec
CFTDIRUSR=$CFTDIRHOME/filusr
CFTFICNF=$CFTDIRHOME/filint/default.cfi
CFTFIDIR=$CFTDIRHOME/filint
CFTHADIR=$CFTDIRHOME/fildat
CFTHICNF=$CFTDIRHOME/filint/default.sei
CFTHIDIR=$CFTDIRHOME/filint
CFTHINI=$CFTDIRHOME/fildat/sec.ini
CFTHPARM=$CFTDIRHOME/fildat/secparm
CFTPKIDIR=$CFTDIRHOME/filsec/pki
CFTPKU=$CFTDIRHOME/filsec/pki/pkibase
CFTACNT=$CFTDIRHOME/fillog/cft_acnt
CFTACNTA=$CFTDIRHOME/fillog/cft_acnta
CFTCATA=$CFTDIRHOME/fildat/cft_cata
CFTCOM=$CFTDIRHOME/fildat/cft_com
CFTLOG=$CFTDIRHOME/fillog/cft_log
CFTLOGA=$CFTDIRHOME/fillog/cft_loga
CFTPARM=$CFTDIRHOME/fildat/cft_parm
CFTPART=$CFTDIRHOME/fildat/cft_part
CFT V2.3 6-9
CFTTRKCNF=$CFTDIRHOME/fildat/trkapi.cfg
CFTTRKEVT=$CFTDIRHOME/fildat/trkevent.xml
CFTTRKCYC=$CFTDIRHOME/fildat/trkevent.xml
PATH=$PATH:$CFTDIREXE:$CFTDIRUSR:$CFTDIREXI
export PATH
export CFTDIRHOME CFTDIRAPI CFTDIRDAT CFTDIREXE CFTDIREXI CFTDIRINQ CFTDIRINS
export CFTDIRLIB CFTDIRLOG CFTDIRNOT CFTDIRPUB CFTDIRSEC CFTDIRUSR CFTFICNF
export CFTFIDIR CFTHADIR CFTHICNF CFTHIDIR CFTHINI CFTHPARM CFTACNT
export CFTACNTA CFTCATA CFTCOM CFTLOG CFTLOGA CFTPARM CFTPART
export CFTPKU CFTTRKCNF CFTTRKEVT CFTTRKCYC
En C shell (csh), les commandes sont ajouter au fichier ~/.cshrc ou ~/.login , sous
la forme :
setenv <variable> <descripteur>
Par exemple, pour la variable CFTCATA, on obtiendra :
setenv CFTCATA $CFTDIRHOME/fildat/cft_cata
6.6.3. Privilges et droits ncessaires
Tout utilisateur du systme, quel que soit son numro d'utilisateur (uid) et son groupe (gid), peut
potentiellement communiquer avec un CFT lanc par un autre utilisateur.
La seule contrainte rside dans les droits dont il dispose pour accder aux fichiers de configuration
de CFT. Ces droits doivent tre au minimum :
droit d'accs en criture sur le fichier de communication point par la variable
d'environnement CFTTCOM,
droit d'accs en lecture pour l'ensemble des fichiers points par les autres variables
d'environnement de CFT,
droit d'accs en lecture pour l'ensemble des excutables de CFT,
droit d'accs en lecture et en excution pour l'ensemble des procdures crites en shell.
6.7. Remarques sur les procdures de basculement
CFT conserve des traces de son activit dans des fichiers grs l'alternat :
les vnements de transfert sont mmoriss dans 2 fichiers de type journal, points
respectivement par les variables d'environnement CFTLOG et CFTLOGA,
les donnes statistiques concernant les transferts correctement termins sont stockes
dans 2 fichiers de type statistiques (accounting), points respectivement par les variables
d'environnement CFTACNT et CFTACNTA.
Le principe du basculement est dcrit dans le guide "Concepts" de CFT.
Le basculement entre fichier et fichier altern est indiqu par l'oprateur, au niveau du paramtrage
de CFT.
CFT V2.3 6-10
Pour tre ralis, le basculement suppose la dfinition de :
l'heure laquelle, chaque jour, a lieu le basculement.
Cette heure de basculement est donne l'aide de la commande SWITCH (dcrite dans
le "Manuel de rfrence" de CFT),
la procdure de basculement, l'aide de la commande EXEC.
Cette procdure, crite en shell, ralisera les actions de basculement.
Les commandes SWITCH et EXEC devront tre insres :
pour raliser le basculement du fichier journal, dans la section CFTLOG, on utilisera
typiquement la dclaration suivante:
CFTLOG ID = log0,
FNAME = _CFTLOG, /* Fichier journal */
AFNAME = '_CFTLOGA', /* Fichier journal altern */
SWITCH = 2359, /* Heure de commutation */
EXEC = 'switch.cmd' /* Procdure de commutation */
pour raliser le basculement du fichier des statistiques, dans la section CFTACNT, on
utilisera typiquement la dclaration suivante:
CFTACCNT ID = acct0,
FNAME = _CFTACNT, /* Fichier statistiques */
AFNAME = _CFTACNTA', /* Fichier stat. altern */
EXEC = 'switch.cmd',/* Procdure de commutation*/
Attention : la fin du traitement ralis par la procdure de basculement, il est indispensable que
les fichiers utiliss (avant le basculement) soient purgs, afin d'tre rutiliss par CFT lors du
basculement suivant.
Si tel n'est pas le cas, CFT se "glera" lors du prochain dmarrage.
6.7.1. Exemple de procdure de basculement : switch.cmd
Si nous considrons par exemple le fichier journal, CFT va commencer travailler sur le fichier
point par CFTLOG. Au premier basculement, CFT va utiliser le fichier point par CFTLOGA.
Au basculement suivant, il va reprendre le fichier point par CFTLOG et ainsi de suite, utilisant
donc l'alternat les fichiers points par CFTLOG et CFTLOGA.
Cette mthode permet donc de maintenir le fichier journal en cours et le prcdent (celui de la
veille).
Si cette solution peut s'avrer suffisante pour une exploitation simple, il peut cependant tre
souhaitable d'avoir une priode d'archivage un peu plus longue.
En guise d'exemple, nous vous proposons ci-dessous une procdure simplifie qui maintient un
historique sur 4 jours au lieu de 2. Cette procdure de basculement switch.cmd se trouve dans le
rpertoire filinst et elle est utilise dans les exemples de configuration fournis ex_conf_fr.tcp et
ex_conf.x25.
Attention : cette procdure nest quun exemple de base, uniquement destin prsenter des
concepts. Elle ne prend pas en compte, par exemple, les diffrents cas derreur.
CFT V2.3 6-11
Son contenu est le suivant :
#!/bin/sh
#
# Exemple de procdure de "switch" du fichier LOG
#
filename=`cft2unix &flog`
mv ${filename} ${filename}_sav
CFTUTIL CFTFILE type=log,fname=$filename
rm $0
Examinons les effets de chacune des lignes qui la compose :
#!/bin/sh
Force systmatiquement l'usage du BOURNE Shell ; mme si ce n'est pas
indispensable dans notre exemple, c'est une bonne scurit,
filename=`cft2unix &FLOG` :
- on utilise la variable symbolique FLOG de CFT pour rcuprer le nom du fichier
journal point par la variable d'environnement CFTLOG (les variables symboliques
de CFT sont dcrites dans le guide "Concepts" de CFT),
- l'utilitaire cft2unix est fourni dans le rpertoire filusr. Il permet de rcuprer le nom
"physique" d'un fichier si le contenu de "&flog" est un nom logique CFT. Dans le
cas contraire, il rend le nom pass en paramtre.
Par exemple : la commande "cft2unix journal" rendra "journal" alors que
"cft2unix _CFTLOG" rendra la valeur contenue dans la variable d'environnement
CFTLOG.
Le nom du fichier journal est ensuite stock dans la variable filename (ex : cft_log),
Copie du fichier journal point par filename dans un nouveau fichier pourvu de
l'extension "_sav"(ex : cft_log devient cft_log_sav),
CFTUTIL CFTFILE TYPE=LOG, FNAME=$filename
Recration du fichier journal initial. Ne pas oublier que pour tre utilisable par
CFT lors du basculement, le fichier journal concern doit tre vide,
rm $0
Suppression du fichier temporaire (voir le paragraphe "CFT et les fichiers
temporaires").
6.7.2. Exemple de procdure : basculement du fichier des statistiques
Sur la base de lexemple prcdent, nous vous proposons ci-dessous une procdure simplifie de
basculement du fichier des statistiques (accounting) offrant les mmes proprits de sauvegarde.
Cette procdure de basculement switchacnt.cmd se trouve dans le rpertoire filinst et elle est
utilise dans les exemples de configuration fournis ex_conf_fr.tcp et ex_conf_fr.x25.
CFT V2.3 6-12
#!/bin/sh
#
# Exemple de procdure de "switch" du fichier ACCNT
#
filename=`cft2unix &FACCNT`
CFTUTIL CFTFILE TYPE=ACCNT, FNAME=$filename
rm $0
Attention : cette procdure nest quun exemple de base, uniquement destin prsenter des
concepts. Elle ne prend pas en compte, par exemple, les diffrents cas derreur.
6.8. Exploitation des fichiers statistiques
CFT conserve des donnes statistiques sur les transferts correctement termins dans 2 fichiers de
type statistiques (accounting). Ces 2 fichiers, grs l'alternat, sont points respectivement par les
variables d'environnement CFTACNT et CFTACNTA.
Les principes gnraux des fichiers statistiques sont dcrits dans le guide "Concepts" de CFT.
A la diffrence des fichiers de type journal, dont le contenu ASCII est visualisable directement par
le biais dun diteur ou de tout autre outil classique, les fichiers de type statistiques sont cods en
binaire. Il est donc ncessaire de disposer dun outil spcifique pour exploiter ces informations, en
fonction des critres en usage dans chaque exploitation.
Pour vous aider dans cette tche, nous vous proposons un programme exemple dont lobjet est de
balayer un fichier statistique et dafficher, pour chaque enregistrement et un peu la faon des
commandes de visualisation du catalogue, chacun des champs mmoriss.
Attention : les informations stockes dans les fichiers statistiques sont susceptibles dvoluer dans
le temps, que ce soit en nombre ou en valeur. Il est donc conseill, pour tout programme que vous
pourriez dvelopper partir des informations fournies ici, de recompiler le programme lors de
toute mise jour de CFT.
Remarque :
cet exemple, sil figure sur la bande de livraison, nest effectivement charg sur votre systme que
si, au moment de linstallation, vous avez demand le chargement du composant Interface de
programmation et EXIT .
6.8.1. Constitution de lexemple
Sous le sous-rpertoire filexit sont fournis :
un module exemple en source, nomm exacct.c, avec le ficher d'inclusion qui lui est
associ exacct.h,
une procdure de compilation mk_exacct qui, partir de l'exemple exacct.c, permet la
production de l'excutable EXACCT qui sera plac automatiquement dans le
sous-rpertoire filexe.
Pour gnrer l'exemple EXACCT :
1. Se placer sous le rpertoire filexit.
make -f mk_exacct
CFT V2.3 6-13
Remarque :
le fichier exemple fourni respecte la syntaxe du C Full ANSI . Si votre compilateur C nest pas
par dfaut dans ce mode, activer loption adquate.
Sur certaines machines (HPUX par exemple), une erreur de compilation en rapport avec la
non-dfinition du type uchar_t peut survenir. Dans ce cas, relancez la commande make avec le
paramtre supplmentaire CFLAGS=-DACCT_UCHAR, soit :
make -f mk_exacct CFLAGS=-DACCT_UCHAR
Ce test ne peut tre ralis que si vous avez dj ralis des transferts corrects avec CFT, partir
dune des configurations de test fournies (ex_conf_fr.tcp ou ex_conf_fr.x25).
1. Se placer sous le rpertoire fillog.
2. A laide de la commande ls -l applique ce rpertoire, slectionner parmi les 2
fichiers de statistique (par dfaut, le fichier cft_acnt ou le fichier altern cft_acnta) le
fichier examiner. Dans notre exemple, nous retiendrons le fichier altern.
3. Lancer lexcutable EXACCT avec, en paramtre, le nom du fichier statistique :
EXACCT cft_acnta
4. Examiner lcran les affichages des diffrents champs de vos transferts.
6.9. Gestion des suffixes
Par dfaut, lors de l'mission ou la rception de fichiers, CFT se base sur le type du fichier (champ
FTYPE dcrit dans les guides "Concepts" et "Manuel de rfrence" de CFT) pour modliser son
comportement.
Cependant, CFT/V2/UNIX dispose aussi d'un mcanisme dit de gestion des suffixes. Cette
fonctionnalit permet CFT/V2/UNIX de dterminer le type du fichier trait simplement partir
du nom de ce fichier.
6.9.1. Dfinition des suffixes
Pour CFT/V2/UNIX, un suffixe correspond la partie la plus droite du nom de fichier. Cette
zone peut comporter un maximum de 8 caractres.
L'ensemble des suffixes connus de CFT doit se trouver dans le fichier suffixes.def, situ dans le
rpertoire point par la variable d'environnement CFTDIRDAT (gnralement, le rpertoire fildat).
Le fichier de dfinition des suffixes est un fichier de type texte que l'utilisateur crera l'aide d'un
diteur de texte (par exemple vi).
Chaque dfinition de suffixe doit tre de la forme :
<suffixe>=<FTYPE>
CFT V2.3 6-14
avec :
longueur du suffixe infrieure ou gale 8 caractres,
FTYPE : un des types de fichiers reconnus par CFT/V2/UNIX.
La liste de ces types, dtaille dans le Manuel de rfrence de CFT, est reprise en
annexe.
D'autre part, les lignes constituant le fichier suffixes.def doivent respecter les rgles suivantes :
il ne peut y avoir qu'une seule dfinition de suffixe par ligne,
il est possible de dfinir des suffixes contenant des caractres "jokers".
Ces derniers sont des caractres permettant de dfinir soit un caractre quelconque (?),
soit une chane de caractres quelconques (*),
la diffrenciation minuscules/majuscules est faite sur les dfinitions de suffixes, mais pas
sur les types.
Ainsi le type t sera identique au type T, mais le suffixe .txt sera diffrent du suffixe
.TXT,
les lignes vides ou les lignes ne comportant que des espaces sont ignores,
il est possible d'insrer des commentaires dans ce fichier en utilisant le symbole #.
Tout texte se situant derrire un symbole # (jusqu' la fin de la ligne) sera considr
comme un commentaire.
Exemple de fichier de dfinition des suffixes :
#
# Fichier exemple pour la dfinition de suffixes
#
.doc=O # Fichier texte type MS-DOS (Ex: param.doc)
.txt=T # Fichier texte UNIX (Ex: cft.txt)
*.bin=B # Fichier binaire (Ex: fic.bin)
*.dat?=B # Fichier binaire (Ex:titi.dat0,toto.data)
# Etc
6.9.2. Utilisation des suffixes avec CFT
L'activation de la gestion des suffixes se fait en spcifiant, dans les sections CFTSEND ou
CFTRECV, un espace pour le champ FTYPE. Dans la syntaxe CFT, cet espace doit tre plac
entre guillemets simples.
Par exemple :
CFTSEND ID = DAT,
FTYPE = ,
MODE = REPLACE
CFT V2.3 6-15
6.10. CFT et les fichiers temporaires
En fonction des diffrentes actions qu'il ralise, CFT cre un certain nombre de fichiers
temporaires dans le rpertoire /tmp.
6.10.1. Fichiers temporaires de CFT
En fonction des actions entreprises, l'utilisateur trouve 4 types de fichiers temporaires :
les fichiers de la forme /tmp/cftlo* correspondent l'activation de la procdure de
basculement de journal,
les fichiers de la forme /tmp/cftcn* correspondent l'activation des fichiers statistiques,
les fichiers de la forme /tmp/cftsu* correspondent l'activation des procdures de fin de
transfert,
les fichiers de la forme /tmp/cftsu*.err correspondent aux rsultats des commandes
situes dans les fichiers cftsu*.
6.10.2. Destruction des fichiers temporaires
CFT ne peut pas assurer la destruction automatique de ces fichiers temporaires. En effet, il ignore,
par exemple, le moment exact o le script utilisateur achve son excution.
Pour viter la saturation du rpertoire /tmp, il est donc important, lors de l'criture d'une procdure
shell, de la terminer par la commande : rm $0.
Attention : lomission de cette commande peut conduire une saturation rapide de la partition /tmp
et lchec de la ralisation des procdures de fin de transfert.
Cette commande a pour effet de dtruire la procdure qui l'excute et s'applique donc aux fichiers
de type cftlo*, cftfcn* et cftsu*.
D'autre part, pour les fichiers de type cftsu*, il convient de dtruire les fichiers associs, de la
forme cftsu*.err. Cependant, pour viter que les erreurs ventuellement contenues dans ce fichier
soient perdue, il vaut mieux tester que ce fichier est bien vide avant sa destruction.
On pourra crire, par exemple :
if test -s $0.err
then
echo $0.err contient des informations consulter
else
rm $0.err
fi
CFT V2.3 6-16
6.10.3. Exemple de procdure
Le contenu du fichier recvm.cmd, situ sous filinst est prsent ci-dessous. Ce fichier recvm.cmd
est un exemple de procdure excute en fin de rception d'un message.
Pour que cette procdure soit excute, il faut qu'elle ait t pralablement dclare dans la section
CFTPARM de votre fichier de configuration, par le champ EXECRM.
Par exemple :
EXECRM = /home/transfert/cft/filinst/recvm.cmd
Le contenu du fichier recv.cmd est le suivant :
echo "MESSAGE RECU:" /* affichage du message reu par */
echo "** &msg **" /* CFT via la variable symbolique */
/* &msg qui contient le texte du */
/* message */
rm $0 /* destruction du fichier */
/* temporaire /tmp/cftsu* */
if test -s $0.err
then
echo $0.err contient des informations
consulter
else
rm $0.err
fi
6.10.4. Identification de CFT
Certains clients, au sein de leur entreprise, ralisent des conditionnements particuliers de
CFT/V2/UNIX. Ce conditionnement spcifique s'applique tantt au niveau du produit dans son
tat "prt installer" (tel que livr par Axway Software), tantt au niveau d'un produit
prconfigur spcifiquement pour l'entreprise.
Pour favoriser l'identification de ce type de produit, un rpertoire spcifique est propos, tant sur le
mdia de livraison que sur le produit aprs installation. Ce rpertoire est nomm .info (attention au
caractre "point" situ devant le nom).
Ce rpertoire .info est situ :
pour le produit installable, au mme niveau que les autres fichiers installables du produit,
pour le produit install, dans le sous-rpertoire sous lequel CFT/V2/UNIX a t gnr
(dans les exemples utiliss dans ce document, il s'agit du rpertoire cft).
Ce rpertoire est en fait une suite de sous-rpertoires termine par un fichier vide. Ces diffrents
niveaux fournissent successivement les informations suivantes :
version de cft (exemple : cft223),
date de gnration du produit (exemple : 20001201),
systme d'exploitation (exemple : AIX),
CFT V2.3 6-17
version du systme d'exploitation (par exemple, pour AIX : 41),
si ncessaire, le fournisseur du matriel (par exemple, pour AIX : BULL).
Avec les exemples fournis ci-dessus, l'utilisateur trouvera donc un rpertoire complet de la forme :
.info/cft223/20001201/AIX/41/BULL
Attention : ce rpertoire et les informations qu'il contient sont aussi utiliss par CFT. En effet,
certains utilitaires tant trs voisins d'une version l'autre des produits, les informations de version
sont rcupres pour affiner le comportement des utilitaires.
6.11. Extension au modle client/serveur
En vue de permettre le dialogue de Clients rcents (CFT V223 et suivants) avec des Serveurs plus
anciens (CFT V220), un certain nombre d'ajouts ont t apporte l'environnement des derniers
CFT sous Unix.
Ces ajouts portent essentiellement sur la cration :
dun fichier de configuration cftinq.cfg,
dune variable denvironnement CFTDIRINQ.
Remarque :
pour plus de dtails sur cette fonctionnalit, consulter les guides gnraux de CFT.
6.11.1. Fichier de configuration cftinq.cfg
Dans le sous-rpertoire fildat, le fichier cftinq.cfg a t ajoute. En fonctionnement normal de CFT
(donc hors mode client/serveur), ce fichier est automatiquement renseign aux valeurs adquates
pour votre CFT local.
6.11.2. Variable denvironnement CFTDIRINQ
Lors de l'installation de CFT, une nouvelle variable d'environnement nomme CFTDIRINQ est
automatiquement positionne. Par dfaut (donc hors mode client/serveur), son contenu pointe vers
le sous-rpertoire fildat de CFT, sous-rpertoire qui contient le fichier cftinq.cfg.
6.11.3. Usage en mode Client/Serveur
Dans le cas d'un fonctionnement de type client 223 et plus vers serveur 220, la variable
CFTDIRINQ devra contenir le chemin d'accs au fichier cftinq.cfg du serveur distant, tel qu'il vous
sera fourni par l'administrateur du site distant.
CFT V2.3 7-1
7. Fonctions interactives de CFT
7.1. Prsentation
CFTINT est une interface utilisateur permettant la prparation et le contrle de l'excution de CFT,
de faon trs complte, au travers de grilles d'crans.
CFTINT offre un affichage et un mode de saisie en pleine page.
Lors de l'installation, la mise en place d'un environnement de travail par dfaut a t ralise, afin
que la tche de l'utilisateur soit, le plus souvent, limite l'activation de CFTINT.
7.2. Activation des fonctions interactives de CFT
Les fonctions interactives sont actives en tapant la commande : CFTINT
La description de l'utilisation des fonctions interactives est fournie dans le "Guide dutilisation des
fonctions interactives" de CFT.
7.3. Configuration des fonctions interactives
7.3.1. Taille des crans
Pour s'activer, les fonctions interactives ncessitent un cran comportant au minimum 24 lignes de
80 colonnes.
Remarque :
sur les stations de travail autorisant le multi-fentrage, attention la taille des fentres ; un
dimensionnement infrieur 24 lignes et 80 colonnes peut donner un affichage confus.
7.3.2. Gestion des touches de fonction
En plus des commandes dcrites dans le "Guide dutilisation des fonctions interactives", certaines
touches de fonction supplmentaires sont reconnues. La liste de ces touches de fonction, qui peut
varier d'un systme UNIX un autre, vous est fournie dans le guide spcifique de votre machine.
Parfois, la gestion des touches de fonction (F1 par exemple) ou de dplacement (flche haute par
exemple) semble ne pas fonctionner correctement sous CFTINT. L'effet constat est identique
celui procur par l'appui sur la touche Escape suivi de quelques caractres. Ce phnomne est
gnralement constat lorsque l'cran utilis est sur une machine diffrente de celle qui dtient
CFTINT (accs remote). Il est normal et uniquement li la manire dont UNIX gre les touches
de fonction. Pour corriger le problme, il suffit d'augmenter la valeur (exprime en millisecondes)
de la variable d'environnement ESCDELAY. Si cette variable n'est pas dfinie dans votre
environnement, il faut la crer.
Fonctions interactives de CFT
CFT V2.3 7-2
Pour forcer le contenu de la variable d'environnement ESCDELAY, par exemple, la valeur de
2000, la commande utiliser dpendra du type de shell utilis :
si le shell de l'utilisateur est csh (C shell), les commandes suivantes sont ajouter au
fichier ~/.cshrc ou ~/. login :
setenv ESCDELAY 2000
si le shell de l'utilisateur est sh (BOURNE shell) ou ksh (KORN shell), les commandes
suivantes sont ajouter au fichier $HOME/.profile :
ESCDELAY=2000
export ESCDELAY
7.3.3. Configuration de base
La procdure d'installation de CFT permet d'installer les bases de donnes de plusieurs langues qui
pourront tre utilises avec CFTINT. Vous devez en choisir au moins une. Si vous dcidez d'en
installer plusieurs, vous devrez spcifier la langue qui sera prise par dfaut lors de la configuration
automatique.
Les fichiers ncessaires au fonctionnement des fonctions interactives de CFT sont localiss sous le
rpertoire filint du rpertoire d'installation.
Les fichiers de personnalisation associs aux utilisateurs sont situs sous le rpertoire fildat.
7.3.4. Modification de la configuration
Il vous est possible d'agir sur la configuration standard des fonctions interactives pour y modifier
la langue utilise, les formats des dates et heures, la localisation de la base ou encore la localisation
et le nom des fichiers de personnalisation associs aux utilisateurs.
Pour cela, utiliser l'utilitaire CFTINTC.
Pour dplacer la base des fonctions interactives.
Exemple :
dplacement de la base vers un rpertoire /usr/base :
1. Crer le nouveau rpertoire :
mkdir /usr/base
2. Se placer sur filexe (impratif) :
cd compte_cft/cft/filexe
3. Informer CFTINT du dplacement que l'on dsire effectuer :
CFIENVG -path /usr/base/
Remarque :
ne pas omettre le "/" la fin du chemin indiqu.
4. Dplacer les fichiers de la base :
mv $CFTFIDIR/* /usr/base
CFT V2.3 7-3
5. Mettre jour les variables d'environnement dans le shell courant ainsi que dans le
fichier de "login" (.cshrc, .login ou .profile).
Exemple en C-Shell :
setenv CFTFIDIR /usr/base
setenv CFTFICNF $CFTFIDIR/default.cfi
CFT V2.3 8-1
8. Construction dapplications APIs CFT
8.1. Introduction
CFT permet des applicatifs externes de cooprer avec lui grce deux interfaces de
programmation.
Par le biais de ces 2 interfaces, il est possible de dvelopper 2 familles d'application :
des applications de dialogue avec CFT qui permettent, par exemple, de soumettre et de
contrler des transferts CFT ou d'interroger le catalogue,
des EXITs, dispositifs qui permettent des programmes utilisateur de prendre le contrle
lors d'une transmission.
Le dtail du fonctionnement de ces interfaces est fourni dans le document "Interface de
programmation" de CFT.
CFT/V2/UNIX n'offre une interface de programmation que depuis le langage C. Cette interface de
programmation n'est utilisable que si vous disposez sur votre machine du systme de
dveloppement (compilateur C et outils associs).
8.2. Prsentation du kit de dveloppement
Le kit de dveloppement permettant l'intgration des APIs de CFT est constitu de plusieurs
rpertoires :
fillib qui contient toutes les librairies (au sens C du terme) ncessaires, savoir :
- un module objet nomm libcft.a, librairie qui doit tre charge (linke) avec toute
application devant communiquer avec CFT,
- un module libcftapi.a, librairie ncessaire toute application dsirant utiliser les
APIs de CFT,
- un module libcftexa.a, librairie ncessaire toute application dsirant utiliser les
EXITs annuaire de CFT,
- un module libcftexf.a, librairie ncessaire toute application dsirant utiliser les
EXITs fichier,
- un module libcftexe.a, librairie ncessaire toute application dsirant utiliser les
EXITs fin de transfert,
- un module libcftex3.a, librairie ncessaire toute application dsirant utiliser les
EXITs Etebac 3.
Ainsi, pour gnrer un applicatif utilisateur bas sur les APIs de CFT et raliser la
fonction EXIT fichier, l'objet final devra tre link avec les librairies libcftapi.a,
libexe.a et libcft.a ,
filapi qui contient un exemple de soumission de commande et d'interrogation catalogue,
filexit qui contient des exemples simples d'exit fichier, d'exit annuaire, dexit ETEBAC 3
et d'exit de fin de transfert.
Construction dapplications APIs CFT
CFT V2.3 8-2
8.3. Exemple avec linterface de programmation
L'exemple que nous proposons ci-aprs a t conu pour fonctionner partir des exemples de
configuration ex_conf_fr.tcp ou ex_conf_fr.x25, situ sous filinst. Dans tout ce qui suit, nous ferons
l'hypothse que vous avez dj personnalis au moins l'un de ces fichiers, suivant le principe dcrit
au chapitre "Premiers lancements avec CFT".
8.3.1. Constitution de lapplication
Sous le sous-rpertoire filapi sont fournis :
un module exemple en source, nomm apixmp1.c, qui ralise une interaction avec CFT,
ce programme ralise une lecture du catalogue de CFT puis affiche son contenu complet
ou partiel, suivant les restrictions donnes en ligne de commande,
une procdure de compilation makefile qui, partir de l'exemple apixmp1.c, permet la
production de l'excutable APIXMP1.
Sous le sous-rpertoire fillib sont fournis :
le module libcftapi.a, ncessaire pour lutilisation des APIs de CFT,
le module libcft.a, ncessaire toute application devant communiquer avec CFT.
Pour gnrer le programme d'exemple APIXMP1:
1. Se placer sous le rpertoire filapi.
make
1. Se placer sous le rpertoire filinst.
2. Gnrer les bases de CFT l'aide de l'utilitaire cftinit en utilisant l'un des 2 fichiers de
configuration proposs :
cftinit ex_conf.x25
3. Aprs l'apparition du message "cftinit complete", activer CFT en lanant la
commande :
cftstart
4. Aprs l'apparition du message "CFTMAIN process id is xxxxx", raliser un
ou plusieurs transferts :
CFTUTIL send part=TOULOUSE,idf=TXT
5. Vrifier que les transferts se sont termins :
cftcatab
CFT V2.3 8-3
6. Lancer le programme dexemple :
cd ../filapi ; ./APIXMP1
Le rsultat doit correspondre au contenu du catalogue :
PART=PARIS ,IDT=<identifiant dynamique>,IDF=TXT
PART=TOULOUSE,IDT=<identifiant dynamique>,IDF=TXT
APIXMP1 _ 2 Enregistrement(s) trouve(s)
7. Stopper CFT:
cftstop
8.4. Exemple dexit fichier
configuration ex_conf_fr.tcp ou ex_conf_fr.x25, situ sous filinst. Dans tout ce qui suit, nous ferons
l'hypothse que vous avez dj personnalis au moins l'un de ces fichiers, suivant le principe dcrit
au chapitre "Premiers lancements avec CFT".
un module exemple en source, nomm exfxmp1.c, avec son ficher d'inclusion associ
exfus.h.
Ce programme prsente les diffrentes fonctions utilisateur :
- ALLOC_TYP : ralisation par l'EXIT de l'allocation du fichier,
- OPEN_TYP : ralisation par l'EXIT de l'ouverture du fichier,
- DATA_TYP : ralisation par l'EXIT de l'criture ou de la lecture du fichier,
- etc.
une procdure de compilation mk_cftexitf qui, partir de l'exemple exfxmp2.c, permet la
production de l'excutable CFTEXITF.
le module libcftexf.a, pour permettre lusage des EXITs fichier de CFT,
le module libcft.a, librairie ncessaire toute application devant communiquer avec CFT.
Pour gnrer l'application d'exemple CFTEXITF :
make -f mk_cftexitf
CFT V2.3 8-4
1. Se placer sous le rpertoire filinst
configuration proposs :
cftinit ex_conf.x25
3. Aprs l'apparition du message "cftinit complete", activer CFT l'aide de
cftstart
4. Aprs l'apparition du message "CFTMAIN process id is xxxxx", activer un
transfert avec la commande :
CFTUTIL send part=TOULOUSE, idf=fic1
5. Aprs quelques instants, vous pouvez vrifier l'tat des transferts en tapant la
commande :
cftcatab
Remarque :
si les transferts ne sont pas termins, retaper une 2me fois la commande cftcatab .
6. Stopper CFT l'aide de l'utilitaire cftstop :
cftstop
7. Analyser le contenu du fichier cft_log.sav dans le rpertoire fillog, et reprer les
messages insrs par l'EXIT.
Remarque :
les fichiers crs sous filpub sont vides car l'exemple d'EXIT propos ne ralise qu'une
simulation.
8.5. Exit annuaire
configuration ex_conf_fr.tcp ou ex_conf_fr.x25, situ sous filinst MAIS lgrement modifis. Dans
tout ce qui suit, nous ferons l'hypothse que vous avez personnalis au moins l'un de ces fichiers,
suivant le principe dcrit au chapitre "Premiers lancements avec CFT".
8.5.1. Modifications raliser avant le test
Vous devez, pralablement au lancement du test de l'exit annuaire, raliser des modifications dans
le fichier ex_conf_fr.tcp ou dans le fichier ex_conf_fr.x25, en fonction du type de rseau utilis.
Pour cela, il convient de raliser les oprations suivantes :
1. Editez le fichier concern l'aide de votre diteur de texte (par exemple vi).
2. Rechercher, dans le fichier dit, la commande cftprot.
CFT V2.3 8-5
Vous devez observer les lignes suivantes :
cftprot id = PeSITCFT,
type = PESIT,
prof = CFT,
...
/*** exita = EXIT_A, ** Cf. Guide dexploitation **/
mode = replace
3. Supprimer les commentaires (matrialiss en dbut par la chane de caractres /* et en
fin par la chane de caractres */) de la ligne contenant le paramtre exita.
Vous devez donc, en final, obtenir la commande cftprot suivante :
cftprot id = PeSITCFT,
type = PESIT,
prof = CFT,
...
exita= EXIT_A,
mode = replace
4. Rechercher la commande cftexit mise en commentaire de la faon
suivante :
/*** Cf. Guide dexploitation ***
CFTEXIT ID = EXIT_A,
PARM = EXAPARM1,
LANGUAGE = C,
PROG = CFTEXITA,
TYPE = ACCESS,
MODE = REPLACE ***/
5. Oter de nouveau les commentaires pour obtenir la commande suivante :
CFTEXIT ID = EXIT_A,
PARM = EXAPARM1,
LANGUAGE = C,
PROG = CFTEXITA,
TYPE = ACCESS,
MODE = REPLACE
6. Rechercher, en fin de fichier, les caractristiques de communication de votre site :
si vous modifiez le fichier ex_conf.x25, vous devez rechercher aussi toutes les
occurrences de la chane DIALNO, se trouvant dans les commandes de type
CFTX25, et remplacer les squences de caractres X par votre numro d'appel
X25,
si vous modifiez le fichier ex_conf_fr.tcp, vous devez rechercher aussi toutes les
occurrences de la chane HOST, se trouvant dans les commandes de type cfttcp, et
remplacer les squences de caractres X par votre nom ou adresse de machine.
CFT V2.3 8-6
un module exemple en source, nomm exaxmpm.c, avec son fichier d'inclusion associ
exaus.h, et 2 fichiers complmentaires exaxmpp.c et exaxmpp.h .
Ce programme permet de vrifier les fonctionnalits suivantes :
- activation d'un transfert sur un partenaire inconnu de CFT, mais connu de l'EXIT
annuaire,
- activation d'un transfert sur un partenaire inconnu de CFT et de l'EXIT annuaire,
une procdure de compilation mk_cftexita qui permet la production de l'excutable
CFTEXITA.
le module libcftexa.a, ncessaires pour utiliser les EXITs annuaire de CFT,
le module libcft.a, librairie ncessaire toute application devant communiquer avec
CFT.
Pour gnrer l'application d'exemple CFTEXITA :
make -f mk_cftexita
configuration proposs et modifi pour cet exit :
cftinit ex_conf.x25
3. Aprs l'apparition du message "cftinit complete", activer CFT l'aide de
cftstart
premier transfert classique avec la commande :
CFTUTIL send part=TOULOUSE, idf=TXT
5. Activer ensuite un second transfert destination du partenaire NCFT_OK.
CFTUTIL send part=NCFT_OK,idf=TXT
6. Aprs quelques instants, vous pouvez vrifier l'tat de ce transfert en tapant la
commande :
cftcatab
Le transfert aboutit car NRPART01 est dfini pour l'EXIT ANNUAIRE comme tant le
partenaire non-cft EXTPTN01 (voir le fichier exaxmpp.c sous filexit).
CFT V2.3 8-7
7. Activer ensuite un troisime transfert destination du partenaire NCFT_OK.
CFTUTIL send part=NCFT_NOK,idf=TXT
Aprs quelques instants, vous pouvez vrifier l'tat de ce transfert en tapant la
commande :
cftcatab
Le transfert ne peut pas aboutir car le mot de passe est invalide bien que le NRPART02
soit dfini dans l'EXIT ANNUAIRE (voir le fichier exaxmpp.c sous filexit).
8. Stopper CFT:
cftstop
8.6. Exit Etebac3
configuration ex_conf_fr.tcp ou ex_conf_fr.x25, situs sous filinst mais modifis.
Dans tout ce qui suit, nous ferons l'hypothse que vous avez personnalis au moins l'un de ces
fichiers, suivant le principe dcrit au chapitre "Premiers lancements avec CFT".
8.6.1. Modifications raliser avant le test
Vous devez, pralablement au lancement du test de l'exit Etebac 3, raliser des modifications dans
le fichier ex_conf_fr.tcp ou dans le fichier ex_conf_fr.x25, en fonction du type de rseau utilis.
Pour cela, il convient de raliser les oprations suivantes :
1. ditez le fichier concern l'aide de votre diteur de texte (par exemple vi)
2. Rechercher, dans le fichier dit, la commande cftprot.
Vous devez observer les lignes suivantes :
cftprot id = Etebac,
type = ETEBAC,
...
/*** exite = EXIT_3, *** Cf. Guide dexploit. ***/
mode = replace
3. Supprimer les commentaires (matrialiss en dbut par la chane de caractres /* et en
fin par la chane de caractres */) de la ligne contenant le paramtre exit.
Vous devez, en final, obtenir la commande cftprot suivante :
cftprot id = Etebac,
type = ETEBAC,
...
exite = EXIT_3,
mode = replace
CFT V2.3 8-8
4. Rechercher la commande cftexit mise en commentaire de la faon suivante:
/*** Cf. Guide dexploitation ***
CFTEXIT ID = EXIT_3,
PARM = EX3PARM1,
LANGUAGE = C,
PROG = CFTEXIT3,
MODE = REPLACE
***/
5. Oter de nouveau les commentaires pour obtenir la commande suivante :
CFTEXIT ID = EXIT_3,
PARM = EX3PARM1,
LANGUAGE = C,
PROG = CFTEXIT3,
MODE = REPLACE
6. De plus, et uniquement dans le cas o vous modifieriez le fichier ex_conf.x25, vous
devez rechercher aussi 2 occurrences de la chane DIALNO, se trouvant dans 2
commandes de type CFTX25 et remplacer les squences de caractres X par votre
numro d'appel X25.
un module exemple en source, nomm ex3xmpm.c, avec son fichier d'inclusion associ
ex3us.h, et 2 fichiers complmentaires ex3xmpp.c et ex3xmpp.h,
Ce programme permet de vrifier les fonctionnalits suivantes :
- la cration d'une carte paramtre spcifique, ct demandeur,
- le dcodage d'une carte paramtre entrante, ct serveur, ou bien le refus d'une
connexion ETEBAC,
une procdure de compilation mk_cftexit3 qui permet la production de l'excutable
CFTEXIT3.
le module libcftex3.a, ncessaire toute application dsirant utiliser les EXITs Etebac3
de CFT,
le module libcft.a, librairie ncessaire toute application devant communiquer avec
CFT.
Pour gnrer l'application d'exemple CFTEXIT3 :
make -f mk_cftexit3
CFT V2.3 8-9
configuration proposs et modifis pour cet exit :
cftinit ex_conf.x25
3. Aprs l'apparition du message "cftinit complete", activer CFT l'aide de l'utilitaire
cftstart :
cftstart
premier transfert classique avec la commande :
CFTUTIL send part=TOULOUSE, idf=TXT
5. Activer ensuite un second transfert destination du partenaire REQPTN01 :
CFTUTIL send part=REQPTN01,idf=TXT
commande :
cftcatab
Le transfert aboutit car REQPTN01 est dfini pour l'EXIT ETEBAC3 comme tant
partenaire sachant crer une carte paramtre ETEBAC3 (voir le fichier ex3xmpp.c sous
filexit).
7. Activer ensuite un second transfert destination du partenaire ERRPTN05 :
CFTUTIL send part=ERRPTN05,idf=TXT
commande :
cftcatab
Le transfert ne peut pas aboutir car la carte paramtre reue est errone (voir le fichier
ex3xmpp.c sous filexit).
9. Stopper CFT:
cftstop
8.7. Exit account
configuration ex_conf_fr.tcp ou ex_conf_fr.x25, situ sous filinst mais lgrement modifis.
En complment aux exemples d'EXIT fournis dans le sous-rpertoire filexit, un exemple de
consultation des fichiers statistiques de CFT est fourni dans ce mme sous-rpertoire.
Dans tout ce qui suit, nous ferons l'hypothse que vous avez personnalis au moins l'un de ces
fichiers, suivant le principe dcrit au chapitre "Premiers lancements avec CFT".
CFT V2.3 8-10
Lapplication se compose des 3 modules suivants:
exacct.c : source de lexemple,
cftcnt.h : descritpif des structures ncessaires,
mk_exacct : fichier makefile de constitution de l'exemple.
Pour constituer lapplication :
1. Se placer sous le rpertoire filexit..
2. Taper la commande:
make -f mk_exacct
A l'issue de la compilation, un excutable EXACCT est cr dans le sous-rpertoire
filexe.
L'exemple attend en paramtre le nom du fichier statistique visualiser
Par exemple, on pourra utiliser, pour visualiser le contenu du fichier statistique altern, la
commande suivante:
EXACCT $CFTACNTA
Remarques :
ce programme d'exemple suppose que la compilation est ralise en mode ANSI pur :
si le mode normal de fonctionnement de votre compilateur C n'est pas le mode ANSI,
consultez la documentation du constructeur pour y trouver l'option adquate d'activation,
si votre compilateur C ne supporte pas le mode ANSI, il pourra tre ncessaire d'adapter
l'exemple.
En fonction des systmes utiliss, il se peut que des types de donnes ne soient pas disponibles.
1. Si la compilation indique des erreurs sur la dfinition de PATH_MAX, ajouter en tte
de l'exemple l'instruction :
#define ACCT_PATH_MAX
2. Si la compilation indique des erreurs sur les types uchar_t, ajouter en tte de l'exemple
l'instruction :
#define ACCT_UCHAR
3. Si la compilation indique des erreurs sur les types ssize_t ajouter en tte de l'exemple
l'instruction :
#define ACCT_SSIZE
CFT V2.3 8-11
8.8. Migration du Catalogue
8.8.1. Quand migrer un catalogue ?
La migration dun catalogue ne peut avoir lieu que lors du passage dune version CFT 220 vers
une version plus rcente de CFT/V2/UNIX
Elle ne peut tre ralise que sur un CFT rcent (223 ou plus) configur et oprationnel.
Il est donc ncessaire de respecter les tapes suivantes:
1. Le compte contenant la version CFT 220 doit tre maintenu en l'tat.
2. Le produit CFT 2xx est install sur un autre compte.
3. Le paramtrage 220 est rcupr et utilis pour configurer le nouveau CFT/V2/UNIX.
4. Le fichier catalogue 220 est mis en place dans le nouvel environnement CFT/V2/UNIX
(voir le point 2 ci dessous).
5. Depuis le nouvel environnement CFT/V2/UNIX, l'utilitaire cftcatal est excut.
8.8.2. Rcupration du catalogue V220
Le catalogue 220 migrer doit tre plac dans le rpertoire adquat du produit CFT/V2/UNIX.
Bien que l'opration se rsume, le plus souvent, a une simple copie, il peut tre utile de rappeler le
principe de localisation des rpertoires ncessaires.
8.8.3. Catalogue en V220
Pour localiser le fichier catalogue de la V220, raliser les actions suivantes:
1. Se connecter en tant qu'utilisateur pour CFT 220.
env |grep CFTCATA
Le systme doit indiquer, par exemple si CFT V220 a t installe sous le rpertoire
cft220 de l'utilisateur U1, la rponse suivante:
CFTCATA=/home/U1/cft220/fildat/cft_cata.
3. Vrifier la prsence effective du fichier catalogue 220.
4. Pour cela, rechercher l'aide de la commande ls le nom de fichier indiqu par la
variable denvironnement CFTCATA en y ajoutant la lettre r (R minuscule) :
ls -l /home/U1/cft220/fildat/cft_cata.r
CFT V2.3 8-12
8.8.3.1. Catalogue en CFT/V2/UNUIX
Pour localiser le fichier catalogue de la CFT/V2/UNIX, raliser les actions suivantes:
1. Se connecter en tant qu'utilisateur pour CFT/V2/UNIX.
2. Taper la commande.
env |grep CFTCATA
Le systme doit indiquer, par exemple si CFT V223 a t install sous le rpertoire
cft223 de l'utilisateur U2, la rponse suivante:
CFTCATA=/home/U2/cft223/fildat/cft_cata
3. Vrifier la prsence ventuelle du fichier catalogue 223.
4. Pour cela, rechercher l'aide de la commande ls le nom de fichier indique par
CFTCATA :
ls -l /home/U2/cft223/fildat/cft_cata
5. Si ce fichier existe, le dtruire laide de la commande rm.
8.8.3.2. Ralisation de la copie
Une fois les 2 fichiers catalogue identifies, il suffit de copier le catalogue 220 dans le rpertoire
contenant dj le catalogue CFT/V2/UNIX.
Pour cela, et si on reprend les exemples fournis ci dessus, excuter les actions suivantes:
1. Se connecter en tant qu'utilisateur pour CFT/V2/UNIX.
cp /home/U1/cft220/fildat/cft_cata.r /home/U2/cft223/fildat
8.8.4. Ralisation de la migration proprement dite
Une fois le catalogue 220 copi /
1. lancer, depuis l'environnement qui contient le CFT/V2/UNIX, l'utilitaire cftcataL.
2. slectionner l'option 'migration de catalogue'.
CFT V2.3 9-1
9. Utilisation des lments additionnels
9.1. Les composants additionnels
Il existe aujourdhui 2 composants additionnels CFT/V2/UNIX :
lagent de notification XNTF, A223 A230
le composant "API serveur" pour lutilisation de XFB Internet User Interface (XFB.IUI)
partir dun poste client ; ce composant est plus simplement appel "serveur IUI".
9.2. Agent de notification XNTF
9.2.1. Arborescence de lagent XNTF
Tous les modules en rapport avec lagent XNTF sont regroups dans le sous-rpertoire filxntf de
CFT. Au sein de ce rpertoire filxntf, on trouve la sous-arborescence suivante :
Tableau 6. Arborescence de lagent XNTF
Rpertoire Sous-rpertoire ou fichier Description
bin insntf Programme dinstallation de lagent
xntf Programme de dmarrage/arrt de lagent
p_xntf_qlt Dmon agent utilisant QLT
ftok Utilitaire interne
getuniq Utilitaire interne
msgget Utilitaire interne
msgget2 Utilitaire interne
nltc Compilateur des messages de log
nltgets Utilitaire de lecture des messages de log
nlt french/ntflog.msg Fichier texte des messages de log en franais
french/msg32.cat Fichier compil des messages de log en franais
english/ntflog.msg Fichier texte des messages de log en anglais
english/msg32.cat Fichier compil des messages de log en anglais
run_time data/ Rpertoire des fichiers de donnes et log de lagent
etc/ Rpertoire des fichiers de configuration de lagent
tmp/ Rpertoire temporaire pour les fichiers de traces
evt/ Rpertoire des fichiers dvnements
Utilisation des lments additionnels
CFT V2.3 9-2
9.2.2. Configuration de lagent XNTF
Pour lancez le programme de configuration de lagent :
1. Se placer dans le sous-rpertoire filxntf de CFT et la commande insntf en prcisant
"CFT" comme moniteur de transfert de fichiers utilis :
bin/insntf CFT
Le programme dinstallation pose ensuite un certain nombre de questions qui
permettent de dfinir la configuration de lagent XNTF.
2. Entrer le rpertoire dinstallation de lagent XNTF (En principe, il sagit du rpertoire
courant) :
XNTF home directory path (max: 255 chars, default: /xntf)?
Par exemple, pour un produit CFT install dans le rpertoire cft de lutilisateur test dont
le rpertorie de base est /home/test, la rponse sera :
/home/test/cft/filxntf
3. Entrer le rpertoire dexcution de lagent XNTF (il sagit, en principe, du sous-
rpertoire run_time cr lors de lextraction de larchive) :
XNTF run-time directory path (max: 255 chars, default:
/xntf/run_time)?
En partant de lexemple prcdent la rponse sera donc :
/home/test/cft/filxntf/run_time
4. Choisissez loffre produit au sein de laquelle vous souhaitez utiliser lagent XNTF (Pour
XFB Scope, il sagit de loption par dfaut) :
Which kind of product do you use with NTF (1: SCOPE, 2: A&P)
(min:1, max:2, def:1)?
5. Entrez le nombre de systmes dacheminement que vous souhaitez utiliser (dans la
plupart des cas, un seul suffit).
Il est noter que, sauf contrainte dexploitation particulire, vous allez utiliser
QueuerLess Transport (QLT) comme moyen dchange. Avec QLT, vous devrez
imprativement rpondre 1 cette question. Si vous utilisez un autre principe que QLT,
rfrez vous aux prconisations de votre fournisseur pour dfinir le nombre de chemins
dacheminement :
How many queuers do you want to use (min:1, max:2, def:1)?
6. Entrez le numro de loption correspondant QueuerLess Transport (lagent XNTF
utilisera alors son protocole propritaire QLT) :
Queuer #0 parameters:
Queuer type (1: Inter.Set, 2: MQSeries, 3:Queuerless Transport) (min:1, max:3, def:2)? 3
Paramtres QLT
7. Entrez le nom de la machine qui hberge le serveur XNTF - QLT :
TCP/IP host name of XNTF server (max: 255 chars, default:
qlt_hostname)?
8. Entrez le numro de port dcoute TCP utilis par le serveur XNTF- QLT :
IP port number used by XNTF server (min:1024, max:65535,
def:44444)?
CFT V2.3 9-3
Paramtres du fichier tampon
9. Entrez le nombre maximum de messages pouvant tre contenus dans le fichier
tampon de lagent. Plus ce nombre est lev, plus lagent pourra stocker de messages
en cas dindisponibilit du systme dacheminement (il est conseill de retenir un
nombre de messages assez consquent, comme 4000) :
Max. number of messages to be hold in the buffering file
(min:10, max:10000, def:100)?
10. Entrez la taille maximale des messages stocks dans le fichier tampon (il est conseill
de conserver la valeur par dfaut) :
Max. length of messages to be stored in the buffering file
(min:1000, max:32000, def:4000)?
Le programme dinstallation affiche ensuite un rsum de la configuration :
Here is your configuration:
Home directory: /home/test/cft/filxntf
Run-time directory: /home/test/cft/filxntf/run_time
You are using XNTF with: SCOPE
You will use 1 queuer(s).
Queuer #0 parameters:
Queuer type: QLESSTPT
Max. number of messages to be hold in the buffering file: 4000
Max. length of messages to be stored in the buffering file: 4000
Do you agree with these parameters (Y/N)? y
XNTF has been configured successfully!
A lissue de la phase de configuration, des fichiers sont crs dans le sous-rpertoire etc de
larborescence XNTF.
Tableau 7. Fichiers de configuration de lagent XNTF
Fichier Description
conffile Fichier de configuration de lagent
profile Variables denvironnement ncessaires lexcution de lagent
ntfprof.ini Cration des profils de remise utiliss par CFT pour dposer dans lagent
XNTF les vnements transfert de fichiers
9.2.3. Dmarrage et Arrt de lagent XNTF
A partir de linstant o la configuration de lagent XNTF a t ralise, les oprations de
dmarrage et darrt de lagent sont ralises automatiquement par les procdures cftstart et cftstop
de CFT/V2/UNIX.
Si, pour une raison qui vous est propre, vous souhaitez dsactiver cet automatisme, il est
ncessaire de modifier les procdures cftstart et cftstop.
Pour modifier le comportement de la procdure cftstart, il suffit dditer la procdure et de
modifier, en dbut de fichier, la variable xntf_start_mode.
CFT V2.3 9-4
xntf_start_mode
Cette variable permet de choisir dignorer ou de lancer lagent XNTF. Les 2 valeurs possibles
sont :
xntf_start_mode=null : lagent est ignor,
xntf_start_mode=all : (cas par dfaut) lagent est lanc au dmarrage de CFT.
De mme, pour modifier le comportement de la procdure cftstop, il suffit dditer la procdure et
de modifier, en dbut de fichier, la variable xntf_stop_mode.
xntf_stop_mode
Cette variable permet de choisir dignorer ou de stopper lagent XNTF. Les 2 valeurs
possibles sont :
xntf_stop_mode=null : la gestion de lagent XNTF est ignore,
xntf_stop_mode=all : (cas par dfaut) lagent est arrt en mme temps que CFT.
9.2.4. Paramtrage de CFT pour utilisation de lagent XNTF
Pour que CFT adresse des notifications lagent XNTF, il est ncessaire de lindiquer dans le
paramtrage de CFT.
Editez votre fichier de configuration CFT et insrez dans les cartes CFTLOG et CFTCAT le
paramtre :
NTF = YES
Si on reprend, par exemple, la carte CFTLOG telle quelle avait t dcrite lors de la mise en place
de la procdure de commutation des fichiers de type journal, lajout du nouveau paramtre nous
donne la carte ci-dessous :
CFTLOG ID = log0,
FNAME = _CFTLOG, /* Fichier journal */
AFNAME = '_CFTLOGA', /* Fichier journal altern */
NTF = YES, /* Notification active */
EXEC = switch.cmd' /* Procdure de commutation */
Ce paramtre indique au moniteur CFT quil doit notifier lagent les vnements de changement
dtat de transfert du catalogue et les messages du journal (par dfaut, seulement les messages de
svrit E et F).
Le nouveau paramtrage CFT doit ensuite tre pris en compte laide de la commande cftinit.
CFT V2.3 9-5
9.2.5. Paramtrage de lagent XNTF
9.2.5.1. Quest-ce quun profil de remise ?
Le fichier ntfprof.ini contient des adresses logiques appeles profils de remise. Un profil de
remise est dsign par un nom correspondant une entre dans le fichier ntfprof.ini.
Lorsque le moniteur de transfert de fichiers notifie un vnement lagent, il prcise la destination
du message qui sera gnr par ce dernier. Il utilise cet effet un nom de profil de remise.
Lagent rsout le nom du profil de remise afin den dduire ladresse relle du destinataire du
message.
Cette technique permet de masquer le type de systme dacheminement utilis et ladresse
effective des messages.
Pour modifier une destination, il suffit dditer le fichier ntfprof.ini et dadapter en consquence
les paramtres du profil de remise correspondant cette destination.
Un profil de remise est constitu :
dun identifiant de systme dacheminement (variable queuer_id),
de paramtres propres au systme dacheminement utilis et transmis celui-ci lors des
envois de messages (variables q_param1 q_param4).
Exemple de fichier des profils de remise
Ce fichier est un exemple typique dune configuration XFB Scope avec QLT.
#
# XNTF Destination profiles
#
# Profile used by Scope to post xfer notifs via QLT
[SCOPE_XFER_QLT]
queuer_id=0
q_param1=pxrs04
q_param2=44444
q_param3=1
q_param4=AEPTCS
# Profile used by Scope to post log notifs via QLT
[SCOPE_LOG_QLT]
queuer_id=0
q_param1=pxrs04
q_param2=44444
q_param3=1
q_param4=AEPELS
On remarque dans cet exemple deux profils de remise :
SCOPE_XFER_QLT,
SCOPE_LOG_QLT.
Ces deux profils utilisent le systme dacheminement didentifiant 0 dans la configuration de
lagent. En effet, plusieurs systmes dacheminement peuvent tre utiliss par un mme agent
(actuellement, jusqu 3 systmes dacheminement).
CFT V2.3 9-6
Chaque systme dacheminement se voit attribuer un identifiant dans la configuration de lagent
(lors de linstallation, ce numro est affich). La variable queuer_id donne lidentifiant du systme
dacheminement utiliser pour un profil de remise donn.
Toujours dans lexemple, on trouve dans les deux profils 4 variables dadressage dont le contenu
est propre au systme dacheminement utilis, en loccurrence QLT.
Ces paramtres sont transmis QLT en ltat et lui permettent de savoir o et comment envoyer
les messages qui lui sont passs :
q_param1 : donne le nom, au sens TCP/IP, de la machine hte hbergeant le
serveur XNTF qui recevra les messages,
q_param2 : donne le numro de port utilis par le serveur XNTF-QLT,
q_param3 : donne le dlai dattente maximum dun acquittement sur envoi de
message,
q_param4 : donne le nom de la file dattente cible.
Cest dans cette file dattente qu rception dun message, le serveur
XNTF-QLT viendra dposer ledit message.
On constate que les deux profils de remise dsignent le mme serveur XNTF. Seule la file
dattente cible diffre (AEPTCS dans un cas et AEPELS dans lautre).
9.2.5.2. Paramtres de profil de remise pour QLT
Typiquement, dans loffre XFB Scope, le profil de remise SCOPE_XFER_QLT sera utilis par le
moniteur de transfert de fichiers pour notifier les vnements transferts, tandis que le profil
SCOPE_LOG_QLT sera utilis pour notifier les vnements de type journal.
Les variables devront donc tre renseignes avec les contenus suivants.
Tableau 8. Variables de personnalisation QLT
Paramtre Contenu
q_param1 nom de la machine hte TCP/IP hbergeant le serveur XNTF - QLT
q_param2 port TCP/IP utilis par le serveur XNTF - QLT
q_param3 dlai maximum dattente dacquittement sur un envoi de message par le protocole QLT
q_param4 nom de la file dattente cible
9.2.5.3. Paramtres de profil de remise pour CFT
Les noms des profils de remise utiliser pour envoyer les notifications dtats de transfert, ainsi
que les notifications de message journal, sont configurs dans les cartes CFTLOG et CFTCAT de
votre fichier de configuration de CFT.
La syntaxe des paramtres permettant de positionner ce filtre est la suivante :
ELSNAME = identifiant
Identifiant du profil de remise utilis par l'agent (Event and Log System name).
Le profil de remise dcrit le type et la mthode d'acheminement des messages notifis (la
valeur par dfaut dpend du systme).
CFT V2.3 9-7
Les transferts en erreur seront notifis par un message d'erreur spcifique dans le systme de
journalisation "ELS" (remarque : si la valeur du paramtre ELSNAME est blanc,
ELSNAME = , ces messages ne seront pas notifis).
TCSNAME = identifiant
Identifiant du profil de remise utilis par l'agent de notification (Track and Control System
name).
Le profil de remise dcrit le type et la mthode d'acheminement des messages notifis (la
valeur par dfaut dpend du systme).
Si ces paramtres sont omis dans la configuration de CFT, des valeurs par dfaut seront
automatiquement mises en place :
le profil de remise utilis par dfaut pour les tats de transfert sera SCOPE_XFER_QLT,
le profil de remise utilis par dfaut pour les messages du journal sera
SCOPE_LOG_QLT.
9.2.5.4. Configuration du filtre sur les tats de transfert
Ce filtre permet de ne pas remonter dans le suivi un certain nombre dtats de transfert, jugs
secondaires ou sans intrt. Le filtre sur les tats de transfert peut tre configur en utilisant la
variable denvironnement n_state. Cette variable se trouve dans le fichier.
Chaque tat est identifi par la lettre S suivie dun numro dtat ; lensemble des tats est donn
dans le tableau ci-dessous.
Tableau 9. Identifiant des filtres de transfert
Identifiant Signification
S1 Pas de statut
S2 Inconnu
S3 Fichier invalide
S4 Consomm
S5 Allocation refuse
S6 En cours dmission
S7 Emis
S8 En cours de rception
S9 Reu
S10 Dpelicanis
S11 A excuter
S12 Annul
S13 Dtruit
S14 Suspendu
S15 Interrompu
S16 Cr
S17 A Supprimer
S18 Dpelicanisation en cours
S19 Reroutage manuel
S20 A dcharger sur bande
S21 Rerout
CFT V2.3 9-8
Tableau 9. Identifiant des filtres de transfert (suite)
Identifiant Signification
S22 A valider
S23 Soumis lutilisateur
S24 Erreur dexcution utilisateur
S25 En cours de cration
S26 Etat 74
n_state est un filtre soustractif sur les tats. De fait :
si la variable est vide ou absente, tous les tats de transfert seront envoys au systme de
suivi,
sinon, chaque tat mentionn dans la variable sera filtr par lagent.
Par exemple, lassertion n_state="S6 S8" permet de ne pas remonter les tats "en cours
dmission" (S6) et "en cours de rception" (S8).
9.2.5.5. Configuration du filtre sur les messages du journal
Ce filtre permet de choisir les types de messages du journal qui seront remonts dans le systme de
suivi. Il est configur dans la carte CFTLOG du fichier de configuration de CFT.
La syntaxe des paramtres permettant de positionner ce filtre est la suivante :
NTFTYP = { "IWEF" | OPERMSG | ALERT | string8}
Chane de caractres dcrivant les types de message qui seront notifis :
IEWF donne les diffrents types possibles de messages notifier (I pour information, E
pour erreur, W pour avertissement et F pour erreur fatale).
Par exemple, lassertion NTFTYP = "EF" ne notifie que les messages d'Erreur et d'erreur
Fatale pour CFT,
OPERMSG est un identifiant rserv qui indique que la valeur du champ OPERMSG de
la commande CFTLOG sera utilise pour signifier les types de messages notifier (se
rfrer au Manuel de rfrence de CFT),
ALERT est un identifiant rserv qui indique que seul les messages indiqus dans le
paramtre NTFALERT (voir ci-dessous) seront notifis.
NTFALERT = (identifier, identifier,)
Liste des identifiants des messages de CFT qui seront notifis en alerte (maximum 10
lments).
Les messages journaux de CFT (exemple : CFTC04E) appartenant cette liste, seront notifis
en "alerte" l'agent de notification.
Remarque :
un identifiant de la liste peut comporter des caractres gnriques (exemple : CFT???E notifiera en
alerte tous les messages d'erreurs de CFT).
CFT V2.3 9-9
9.3. Serveur IUI
Ce chapitre apporte quelques prcisions sur lutilisation des APIs serveur pour permettre lusage
de XFB.Internet User Interface (IUI) partir dun poste client.
On trouvera ici comment :
configurer le serveur IUI,
lancer et arrter le serveur IUI.
Lapi serveur (encore nomm Serveur IUI) dialogue avec lIUI client par le biais de messages.
Ce dialogue impose une connexion de type TCP entre lapi serveur et lIUI.
9.3.1. Constituants du serveur IUI
Les diffrents fichiers intervenant dans le bon fonctionnement du serveur IUI sont les suivants :
le fichier excutable XFBAPISV, situ sous filexe, qui assure la fonction de serveur,
le fichier de configuration xfbsrv.ini, situ sous fildat, qui caractrise le fonctionnement
du serveur sur votre machine,
le fichier script xfbadm, situ sous filusr, qui permet le dmarrage et larrt manuel du
serveur,
indirectement, les fichiers cftstart et cftstop, situs sous filusr, qui peuvent tre modifis
pour permettre au moment du lancement et de larrt de CFT - de grer
automatiquement le suivi du serveur IUI.
9.3.2. Principes gnraux de fonctionnement du serveur IUI
Avant de donner plus dinformations sur la configuration et la mise en uvre du serveur IUI, il
peut tre intressant dapprhender, dans sa globalit, le fonctionnement du serveur.
Dmarrage du serveur
Le lancement du serveur IUI peut tre ralis :
automatiquement, par le biais de la commande cftstart, lors du dmarrage de CFT,
manuellement, laide de la commande xfbadm, avec le paramtre start.
La prsence dun serveur IUI actif peut tre vrifie par la prsence dun processus
XFBADMSV lors de lexcution de la commande systme ps, mais aussi par
lexistence, sous le rpertoire fildat de CFT, dun fichier de la forme
iui_<nom_de_serveur>.pid.
Ce fichier tmoin ne contient que lidentifiant (numro de PID) du serveur IUI. Il
permet, dune part, de garantir lunicit du serveur demand et, dautre part, de
retrouver ce processus pour larrter correctement ultrieurement.
CFT V2.3 9-10
Lancement en cascade de plusieurs serveurs
A un instant donn, il peut exister plusieurs occurrences dun processus serveur. En effet, suivant
un principe classique sous Unix, il y a duplication de processus lors de chaque demande de
connexion dun utilisateur.
Nous pouvons donc avoir :
le processus serveur, toujours lcoute des demandes des utilisateurs clients IUI,
un nombre de processus variable, fonction du nombre dutilisateurs connects.
Actuellement, le nombre de connexions simultanes par serveur est limit 10.
Arrt du serveur
Larrt du serveur IUI peut tre ralis :
automatiquement, par le biais de la commande cftstop, lors de larrt de CFT,
manuellement, laide de la commande xfbadm, avec le paramtre stop.
Lutilisation dune de ces commande dtruit le fichier tmoin iui_<nom_de_serveur>.pid.
Il est noter que seul le serveur en attente de connexion est arrt ; les autres occurrences
connectes un utilisateur ne se terminent que par la clture de la connexion sur linitiative de
lutilisateur, sur une erreur rseau ou sur une fin de temporisation dinactivit.
9.3.3. Configuration du serveur IUI
La configuration du serveur IUI se ralise simplement par la personnalisation du fichier xfbsrv.ini
fourni, aprs installation, dans le sous rpertoire fildat de CFT/V2/UNIX.
Ce fichier contient un (ou plusieurs) identifiant(s) de serveur indiquant les paramtres qui seront
utiliss lors du fonctionnement du serveur IUI.
Il peut y avoir plusieurs identifiants de serveur, mais bien sr chacun doit tre unique, pour que
plusieurs serveurs soient lancs et fonctionnent simultanment les ports dcoute TCP devront tre
diffrents.
Un exemple didentifiant est repris ci-dessous :
[xfbapisv0]
Port = 13367
SendTimeOut = 120
RecvTimeOut = 600
La syntaxe des diffrents champs constituant un identifiant est la suivante :
[identifiant]
indique le nom par lequel sera appel le serveur lors de son lancement.
Il est encadr par des crochets ( [ ] ) et peut tre compos de caractres majuscules (A
Z), minuscules (a z), chiffres (0 9 ) et soulign (_).
Chaque identifiant doit, bien sr, tre unique au niveau du fichier et, de plus, ne peut
pas prendre la valeur [DEFAULT] qui est un nom rserv (voir plus bas),
Port = nnnnn
dtermine le numro de port TCP que le serveur utilisera pour se mettre en attente dune
demande de connexion dun utilisateur.
CFT V2.3 9-11
Tout identifiant de serveur doit avoir un numro de port diffrent.
SendTimeout = nnnn (facultatif)
dfinit le temps maximum, en secondes, allou au serveur pour envoyer un message.
Si le message ne peut tre envoy dans le temps imparti, la connexion est coupe.
RecvTimeout = nnnn (facultatif)
dfinit le temps maximum, en secondes, pendant lequel le serveur attend une requte de
lutilisateur.
Si le temps imparti est coul, la connexion est coupe.
Lentre spcifique de nom [DEFAULT] permet de dfinir les valeurs par dfaut. Ces valeurs
seront utilises pour valoriser les paramtres facultatifs omis dans votre configuration. Cette entre
ne peut pas tre utilise comme serveur dcoute (pas de port TCP associ).
9.3.4. Lancement et arrt manuels du serveur IUI
Comme nous lavons dj indiqu dans ce chapitre ainsi que lors de la prsentation des utilitaires
(Cf. chapitre description des utilitaires ), le serveur IUI peut tre dmarr et arrt
manuellement par loprateur laide de la commande xfbadm.
Pour mmoire, les commandes de dmarrage et darrt sont, respectivement :
xfbadm start nom_de_serveur [options_de_trace]
xfbadm stop nom_de_serveur
9.3.5. Lancement et arrt automatiques du serveur IUI
Sauf contraintes dexploitation svres ou configuration particulirement volue, il peut tre
intressant de figer le comportement suivre par CFT pour la gestion du serveur IUI.
Une fois les tests de mise en exploitation termins, et si le ou les serveurs IUI dcrits dans le
fichier de configuration xfbsrv.ini sont lancer systmatiquement avec CFT, il est possible de
demander la procdure cftstart de raliser les dmarrages ncessaires.
Pour modifier le comportement de la procdure cftstart, il suffit dditer la procdure et de
modifier, en dbut de fichier, les 2 variables iui_start_mode et iui_trace_mode.
iui_start_mode
Cette variable permet de choisir dignorer la gestion des serveurs IUI, den dmarrer un
spcifiquement ou de les dmarrer tous.
Les 3 valeurs possibles sont :
iui_start_mode=null : (cas par dfaut) La gestion des serveurs IUI est ignore,
iui_start_mode=all : tous les serveurs dcrits dans xfbsrv.ini sont lancs,
iui_start_mode=myone : seul le serveur myone, dcrit dans xfbsrv.ini, sera activ.
CFT V2.3 9-12
iui_trace_mode
Cette variable permet de dfinir le niveau de trace dsir.
Les 4 cas possibles sont :
iui_trace_mode=null : (cas par dfaut) Pas de traces,
iui_trace_mode=console : les traces sont affiches sur le canal /dev/console
(sous rserve que ce canal soit accessible en lecture),
iui_trace_mode=term : les traces sont affiches sur le terminal utilis pour
lancer la commande,
iui_trace_mode=file : les traces sont rediriges vers des fichiers sous fillog.
nomms iui_<serveur>.err pour les erreurs et
iui_<serveur>.out pour les traces de fonctionnement.
De mme, pour modifier le comportement de la procdure cftstop, il suffit dditer la procdure et
de modifier, en dbut de fichier, la variable iui_stop_mode.
iui_stop_mode
Cette variable permet de choisir dignorer la gestion des serveurs IUI, den arrter un
spcifiquement, ou de les stopper tous.
Les 3 cas possibles sont :
iui_stop_mode=null : (cas par dfaut) la gestion des serveurs IUI est ignore,
iui_stop_mode=all : tous les serveurs dcrits dans xfbsrv.ini sont arrts,
iui_stop_mode=myone : seul le serveur myone, dcrit dans xfbsrv.ini, sera stopp.
9.3.6. Contrle daccs au serveur IUI
Pour quun client soit mme de se connecter sur un serveur IUI, il doit au pralable avoir t
autoris le faire. Cette autorisation est obtenue au travers de la notion dutilisateurs applicatifs.
Cette notion dutilisateur applicatif sappuie sur des concepts identiques aux principes en vigueur
sur les systmes UNIX : utilisateur et groupe.
Un utilisateur des services du serveur IUI doit tre dclar dans le fichier xfbpasswd, situ dans le
sous-rpertoire filsec. La dclaration de cet utilisateur est assure par la commande xfbadmusr qui
permet de le caractriser par :
son nom,
son identifiant (mme principe que le paramtre UID sous UNIX),
son mot de passe,
son groupe dappartenance (mme principe que le paramtre GID sous UNIX).
De mme, lappartenance dun utilisateur un groupe dutilisateur doit tre dclare dans le fichier
xfbgroup, situ dans le sous-rpertoire filsec.
CFT V2.3 9-13
La gestion des groupes dutilisateurs est assure par la commande xfbgroupr qui permet
didentifier un groupe par :
son nom,
son identifiant (mme principe que le paramtre GID sous UNIX),
un mot de passe ventuel,
le (ou les) utilisateurs appartenant ce groupe.
A lissue de linstallation, les fichiers xfbgroup et xfbpasswd tant vides, il est ncessaire de
procder, au minimum, la cration dun groupe et dun utilisateur avant de pouvoir utiliser les
services de lIUI. Les commandes xfbadmgrp et xfbadmusr sont dcrite dans la section 3 de ce
document.
Remarque :
si le serveur IUI fonctionne sous luid root, les fichiers utilisateur et groupe utiliss seront ceux du
systme.
CFT V2.3 10-1
10. Elments de scurit
10.1. Les composants livrs
A230
Les aspects de scurisation des changes ne sappliquent quaux versions 230 et suivantes du
produit CFT/V2/UNIX.
Pour pouvoir faire fonctionner la scurisation des transferts (usage du protocole SSL), il est
ncessaire de disposer de certificats.
Un certain nombre de certificats classiques vous est propos, en guise dexemple, dans le
sous-rpertoire filsec/pki de CFT.
Tableau 10. Liste des certificats
Nom du certificat Rle
caxmp.der Certificat d'autorit locale
client.der Certificat client sign par l'autorit locale
clientk.der Cl prive associe au certificat prcdent
server.der Certificat client sign par l'autorit locale
serverk.der Cl prive associe au certificat prcdent
De mme, sous ce rpertoire filsec/pki, est fourni le fichier cftpki.ini dj configur pour prendre
en compte ces certificats.
[TrustedCAs]
CAXMP_FileName=$CFTPKIDIR/caxmp.der
[CA_CAXMP]
CLIENT_FileName=$CFTPKIDIR/client.der
CLIENT_KeyFile=$CFTPKIDIR/clientk.der
SERVER_FileName=$CFTPKIDIR/server.der
SERVER_KeyFile=$CFTPKIDIR/serverk.der
10.2. Les modifications de paramtrage
A limage de ce qui est dcrit dans le manuel de rfrence de CFT, la mise en uvre de la
scurisation des changes impose la dfinition dlments spcifiques dans le paramtrage du
produit.
Bas sur les certificats dcrits plus haut, vous trouverez dans le sous-rpertoire filinst du produit
des fichiers de test de la fonctionnalit SSL, nomms ex_conf_fr.tcp et ex_conf_fr.pki. permettant,
par des transferts en boucle, de valider la fonctionnalit.
Pour permettre le fonctionnement de SSL/TLS, certaines parties de ex_conf_fr.tcp doivent tre
dcommentes comme indiqu dans ce mme sample.
Elments de scurit
CFT V2.3 10-2
Le fichier ex_conf_fr.pki qui permet de crer la base PKI ( pointe par la variable
denvironnement CFTPKU ) doit tre interprt par PKIUTIL de la faon suivante :
PKIUTIL @ex_conf_fr.pki.
Sans reprendre les informations dj fournies dans les guides gnraux de CFT, on remarquera
rapidement les ajouts ou volutions suivantes.
Au niveau de la carte CFTPARM, dfinition du nombre de taches CFTTSSL utiliser
(sslwtask) et de la position du fichier de configuration (sslcerdb).
cftparm id = IDPARM0,
. . .
sslwtask = 1,
sslmtask = 1,
pkifname = $CFTPKU,
. . .
Au niveau de la carte CFTPROT, dfinition de deux nouveaux protocoles qui utiliseront des cartes
de type CFTSSL (ssl) :
cftprot id = PANYX1,
type = PESIT,
. . .
ssl = PANYRX1
cftprot id = PANYX2,
type = PESIT,
. . .
ssl = PANYRX2
Ajout de 2 cartes de type CFTSSL , raccroches chaque nouveau protocole, dfinissant un mode
serveur (direct = server) et un mode client (direct = client) prvus pour
fonctionner suivant la version 3 du protocole SSL.
cftssl id = PANYRX1,
usercid = server,
rootcid = caxmp,
direct = server,
verify = none,
ciphlist = (10.9.1.2),
version = SSLV3
direct = client,
verify = required,
usercid = client,
rootcid = caxmp,
ciphlist = (10.9.1.2),
version = SSLV3
usercid = server,
rootcid = caxmp,
direct = server,
verify = required,
ciphlist = (10.9.1.2),
version = SSLV3
CFT V2.3 10-3
direct = client,
verify = required,
usercid = client,
rootcid = caxmp,
ciphlist = (10.9.1.2),
version = SSLV3
Cration des partenaires LOOPAT1 et LOOPAT2, qui dialoguent en TCP, et qui utilisent les
nouveaux protocoles pour scuriser ses changes (ssl = PANYRX1 et PANYRX2) :
cftpart id = LOOPAT1,
nspart = LOOPAT1,
nrpart = LOOPAT1,
prot = PANYRT,
sap = 1766,
ssl = PANYRX1
cfttcp id = LOOPAT1,
host = xxxxxxxxx,
cnxin = 8,
cnxout = 8,
cnxinout = 8
cftpart id = LOOPAT2,
nspart = LOOPAT2,
nrpart = LOOPAT2,
prot = PANYRX2,
sap = 1767,
ssl = PANYRT
cfttcp id = LOOPAT2,
host = xxxxxxxxx,
cnxin = 8,
cnxout = 8,
cnxinout = 8
CFT V2.3 11-1
11. Mise en uvre du suivi Sentinel.
11.1. Composants livrs
Le module de suivi Sentinel est compos des lments suivants :
la tche de notification CFTTRK,
le fichier de configuration Sentinel trkapi.cfg,
les fichiers de description xml Sentinel trkevent.xml et trklinkcycle.xml.
11.2. Paramtrage de CFT pour lutilisation de Sentinel
Pour que CFT adresse des notifications lagent de suivi Sentinel, il est ncessaire de modifier le
paramtrage de CFT comme indiqu dans la "Note de diffusion CFT 231".
Un fichier de configuration trkapi.cfg est disponible sous fildat, un exemple de mise en uvre est
intgr aux samples de paramtrage CFT fournis sous filinst.
CFT V2.3 A-1
A. Paramtrage spcifique
Cette annexe rsume les caractristiques de CFT/V2/UNIX qui le diffre des implantations sur les
autres systmes dexploitation (valeurs spcifiques, paramtres par dfaut).
A.1. Tableau des valeurs spcifiques
Tableau 11. Valeurs spcifiques
Notation Objet Valeur spcifique
char_file Prfixe des noms logiques _ (soulign)
char_mask Caractre joker (wild card) ?
char_unit Caractre sparateur (volume) aucun
char_symb Prfixe des variables symboliques &
char_directory Caractre partir duquel la cration de rpertoire est
autorise lors de la rception dun fichier
+
file_symb Caractre introduisant un nom de fichier pass en
paramtre CFTUTIL
@
Tableau 12. Valeurs spcifiques : dfauts pour CFTUTIL
Objet Nom par dfaut
Fichier Paramtres _CFTPARM
Fichier Partenaires _CFTPART
Fichier catalogue _CFTCATA
Fichier journal _CFTLOG
Fichier communication _CFTCOM
Fichier statistiques _CFTACNT
Mdia prfrentiel Fichier
A.2. Fichiers transfrables
Tableau 13. Caractristiques de fichiers retrouvs automatiquement ou non l'mission
Paramtre Retrouvs automatiquement l'mission
FSPACE OUI
FLRECL OUI (par dfaut)
FBLKSIZE NON
FRECFM OUI (par dfaut)
FTYPE OUI
Paramtrage spcifique
CFT V2.3 A-2
Tableau 14. Valeurs de FTYPE et valeurs de FCODE implicitement associes en mission
FTYPE FCODE
BINARY
T ASCII
B BINARY
V BINARY
O ASCII
X ASCII
Tableau 15. Combinaisons de FTYPE et FRECFM l'mission
Nature du fichier mettre Valeur implicite FTYPE Valeur possible FRECFM
Fichier texte (*) O V
Fichier texte (*) O F
Fichier texte (*) X V
Fichier texte (*) X F
Fichier texte (*) T V
Fichier texte (*) T F
Fichier binaire B F
Fichier binaire B U
Fichier variable (compress) V V
(*) en mission, le fichier peut contenir des terminateurs du type LF (Unix) ou CRLF (MS-DOS).
Pour les fichiers variables, les valeurs indiques doivent tre donnes de manire explicite. Pour
les autres, ces valeurs sont dduites des caractristiques du fichier ou donnes de manire
explicite.
Tableau 16. Valeurs de FTYPE et FRECFM la rception
FTYPE FRECFM Nature du fichier rception
F T Fichier squentiel fixe de type Unix (LF)
V T Fichier squentiel variable, type texte Unix (LF)
F B Fichier squentiel fixe de type binaire
U B Fichier squentiel indfini de type binaire
V V Fichier squentiel variable de type variable
V O Fichier squentiel variable de type texte pour systmes DOS/OS2,
WinNT (CRLF)
V X Fichier squentiel variable de type texte pour systmes Unix (LF)
Ces valeurs sont soit explicites dans CFTRECV soit dduites des valeurs protocolaires reues.
CFT/V2/UNIX effectue (sur demande) un contrle daccs aux fichiers transfrs. Il dtermine,
par exemple, si linitiateur de la demande dmission a les droits en lecture sur le fichier mettre.
En rception, CFT crera le fichier, sil nexiste pas.
Remarque :
dans tous les cas, lorganisation (FORG) des fichiers mis ou reus par CFT/V2/UNIX est de type
squentielle.

CFT UNIX Guide D Exploitation

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

CFT UNIX Guide D Exploitation

Transféré par

Droits d'auteur :

Formats disponibles

ClT Vcrsicn 2.

Vous aimerez peut-être aussi