XFB Monitor CFT Guide Exploitation 2 4 1 UNIX FRA

Guide dexploitation

XFB Monitor CFT Version 2.4 UNIX

CFT-V2.4-EXPL-UNIX-020507

Copyright Axway Software, 2007 All rights reserved. Ce document dcrit le logiciel suivant, dit par Axway : XFB Monitor CFT 2.4 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, 2007. Tous droits rservs.

Table des matires

1. Descriptif des utilitaires ........................................................................................................1-11.1. Prsentation ................................................................................................................................................... 1-1 1.2. Liste alphabtique des utilitaires ................................................................................................................... 1-1 1.3. Table de transcodage..................................................................................................................................... 1-2 1.4. Utilitaires de gestion de CFT......................................................................................................................... 1-2 1.4.1. cftinit....................................................................................................................................................1-2 1.4.2. cftstart ..................................................................................................................................................1-3 1.4.3. cftstop...................................................................................................................................................1-4 1.4.4. cftupdate...............................................................................................................................................1-6 1.4.5. cftutil....................................................................................................................................................1-6 1.4.6. secinit ...................................................................................................................................................1-7 1.4.7. secupdate..............................................................................................................................................1-7 1.5. Utilitaires de manipulation de CFT ............................................................................................................... 1-8 1.5.1. cftcata...................................................................................................................................................1-8 1.5.2. cftcatab.................................................................................................................................................1-8 1.5.3. cftcatal..................................................................................................................................................1-8 1.5.4. cftlog ....................................................................................................................................................1-9 1.5.5. cftalog ..................................................................................................................................................1-9 1.5.6. cftparm .................................................................................................................................................1-9 1.5.7. cftpart ...................................................................................................................................................1-9 1.5.8. cftdelcat..............................................................................................................................................1-10 1.5.9. xfbadmgrp..........................................................................................................................................1-10 1.5.10. xfbadmusr ........................................................................................................................................1-11 1.6. Utilitaires caractre systme......................................................................................................................1-12 1.6.1. cft2unix ..............................................................................................................................................1-12 1.6.2. cftkey .................................................................................................................................................1-12 1.6.3. cftversion ...........................................................................................................................................1-13 1.6.4. cftping ................................................................................................................................................1-14 1.6.5. x25loop ..............................................................................................................................................1-15 1.6.6. xvi ......................................................................................................................................................1-17

2. Pralable la mise en uvre de CFT ..................................................................................2-12.1. Prsentation ................................................................................................................................................... 2-1 2.2. Cl de protection logicielle............................................................................................................................ 2-1 2.2.1. Obtention de la cl de protection .........................................................................................................2-1 2.2.2. Prise en compte de la cl de protection ................................................................................................2-1 2.3. Oprations de paramtrage............................................................................................................................ 2-1

3. Premiers lancements de CFT ...............................................................................................3-13.1. Prsentation ................................................................................................................................................... 3-1 3.2. Test dinstallation de CFT en mode TCP ...................................................................................................... 3-1 3.2.1. Paramtrage du moniteur CFT .............................................................................................................3-1 3.2.2. Excution du test..................................................................................................................................3-2 3.3. Test dinstallation de CFT en mode X25 ...................................................................................................... 3-3 3.3.1. Rappel sur ladressage X25..................................................................................................................3-4 3.3.2. Paramtrage du moniteur CFT .............................................................................................................3-4 3.3.3. Excution du test..................................................................................................................................3-6

4. Mise en exploitation de CFT ................................................................................................4-14.1. Oprations de paramtrage............................................................................................................................ 4-1 4.2. Configuration du moniteur CFT.................................................................................................................... 4-1

CFT V2.4

iii

CFT UNIX Guide dexploitation 4.2.1. Paramtrage du moniteur CFT .............................................................................................................4-1 4.2.2. Cration initiale des fichiers "Environnement CFT" et initialisation...................................................4-1 4.3. Activation et arrt de CFT............................................................................................................................. 4-2 4.3.1. Activation de CFT par la commande cftstart .......................................................................................4-2 4.3.2. Activation automatique de CFT au dmarrage de la machine .............................................................4-2 4.3.2.1. Usage du fichier /etc/inittab............................................................................................................. 4-2 4.3.2.2. Ajout dun fichier sous /etc/rc3.d .................................................................................................... 4-3 4.4. Arrt du moniteur CFT.................................................................................................................................. 4-3 4.4.1. Arrt de CFT laide de la commande cftstop ....................................................................................4-3 4.4.2. Arrt de CFT par lutilitaire CFTUTIL................................................................................................4-4 4.4.3. Arrt brutal de CFT..............................................................................................................................4-4 4.5. Excution de CFTUTIL ................................................................................................................................ 4-4 4.5.1. Activation.............................................................................................................................................4-5 4.5.2. Saisie en mode ligne ............................................................................................................................4-5 4.5.3. Paramtres dactivation........................................................................................................................4-5 4.6. Prise en compte dutilisateurs supplmentaires............................................................................................. 4-6 4.6.1. Extension du chemin de commande (PATH).......................................................................................4-6 4.6.2. Environnement daccs aux fichiers de CFT .......................................................................................4-7 4.6.2.1. Variables denvironnement utilises par CFT ................................................................................. 4-7 4.6.2.2. Positionnement des variables denvironnement .............................................................................. 4-8 4.6.3. Privilges et droits ncessaires.............................................................................................................4-9 4.7. Remarques sur les procdures de basculement.............................................................................................4-10 4.7.1. Exemple de procdure de basculement : switch.cmd.........................................................................4-11 4.7.2. Exemple de procdure : basculement du fichier des statistiques .......................................................4-12 4.8. Exploitation des fichiers statistiques ............................................................................................................4-12 4.8.1. Constitution de lexemple ..................................................................................................................4-13 4.8.2. Excution du test................................................................................................................................4-13 4.9. Gestion des suffixes .....................................................................................................................................4-13 4.9.1. Dfinition des suffixes .......................................................................................................................4-14 4.9.2. Utilisation des suffixes avec CFT ......................................................................................................4-15 4.10. CFT et les fichiers temporaires ..................................................................................................................4-15 4.10.1. Fichiers temporaires de CFT............................................................................................................4-15 4.10.2. Destruction des fichiers temporaires................................................................................................4-15 4.10.3. Exemple de procdure......................................................................................................................4-16 4.10.4. Identification de CFT .......................................................................................................................4-16 4.11. Extension au modle client/serveur............................................................................................................4-17 4.11.1. Fichier de configuration cftinq.cfg ...................................................................................................4-17 4.11.2. Variable denvironnement CFTDIRINQ .........................................................................................4-17 4.11.3. Usage en mode Client/Serveur.........................................................................................................4-18

5. Construction dapplications APIs CFT...............................................................................5-15.1. Introduction ................................................................................................................................................... 5-1 5.2. Prsentation du kit de dveloppement........................................................................................................... 5-1 5.3. Exemple avec linterface de programmation................................................................................................. 5-2 5.3.1. Constitution de lapplication................................................................................................................5-2 5.3.2. Excution du test..................................................................................................................................5-2 5.4. Exemple dexit fichier................................................................................................................................... 5-3 5.4.1. Constitution de lapplication................................................................................................................5-3 5.4.2. Excution du test..................................................................................................................................5-4 5.5. Exit annuaire ................................................................................................................................................. 5-4 5.5.1. Modifications raliser avant le test....................................................................................................5-4 5.5.2. Constitution de lapplication................................................................................................................5-6 5.5.3. Excution du test..................................................................................................................................5-6 5.6. Exit Etebac3 .................................................................................................................................................. 5-7 5.6.1. Modifications raliser avant le test....................................................................................................5-7 5.6.2. Constitution de lapplication................................................................................................................5-8 5.6.3. Excution du test..................................................................................................................................5-9 5.7. Exit account................................................................................................................................................... 5-9 5.7.1. Constitution de lapplication..............................................................................................................5-10

CFT V2.4

iv

CFT UNIX Guide dexploitation 5.7.2. Excution du test................................................................................................................................5-10

6. Utilisation de Copilot ............................................................................................................6-16.1. Prsentation ................................................................................................................................................... 6-1

7. Elments de scurit..............................................................................................................7-17.1. Les composants livrs ................................................................................................................................... 7-1 7.2. Les modifications de paramtrage................................................................................................................. 7-1

8. Mise en uvre du suivi Sentinel...........................................................................................8-18.1. Composants livrs ......................................................................................................................................... 8-1 8.2. Paramtrage de CFT pour lutilisation de Sentinel ....................................................................................... 8-1

9. Paramtrage spcifique.........................................................................................................9-19.1. Tableau des valeurs spcifiques .................................................................................................................... 9-1 9.2. Fichiers transfrables......................................................................................................................................9-1

CFT V2.4

v

Liste des tableauxTableau 1. Tableau 2. Tableau 3. Tableau 4. Tableau 6. Tableau 6. Tableau 7. Tableau 8. Tableau 9. Liste alphabtique des utilitaires ...................................................................................................... 1-1 Chemin d'accs aux fichiers ............................................................................................................. 4-7 Liste des certificats........................................................................................................................... 7-1 Valeurs spcifiques........................................................................................................................... 9-1 Valeurs spcifiques : dfauts pour CFTUTIL .................................................................................. 9-1 Caractristiques de fichiers retrouvs automatiquement ou non l'mission................................... 9-1 Valeurs de FTYPE et valeurs de FCODE implicitement associes en mission.............................. 9-2 Combinaisons de FTYPE et FRECFM l'mission ......................................................................... 9-2 Valeurs de FTYPE et FRECFM la rception................................................................................. 9-2

CFT V2.4

vi

1. Descriptif des utilitaires

1.1. PrsentationCe 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. Pour une bonne comprhension de certains paramtres cits dans ce chapitre, il est conseill de consulter la documentation en ligne de CFT.

1.2. Liste alphabtique des utilitairesTableau 1.Utilitaire atoe cft2unix cftalog cftcata cftcatab cftcatal cftdelcat cftinit cftkey cftlog cftparm cftpart cftping cftstart cftstop cftupdate cftutil cftversion etoa secinit secupdate xfbadm xfbadmgrp xfbadmusr xvi x25loop

Liste alphabtique des utilitairesDfinition Table de transcodage ASCII ISO 8859-1 en EBCDIC Utilitaire de manipulation des variables d'environnement CFT Visualisation directe du fichier journal altern de CFT Visualisation en totalit du fichier catalogue de CFT Visualisation en rsum du fichier catalogue de CFT Utilitaire de migration et/ou dextension du fichier catalogue de CFT Utilitaire de destruction d'un lment dans le catalogue Utilitaire d'initialisation gnrale de CFT Visualisation des informations systme Visualisation directe du fichier journal de CFT Visualisation directe de la partie "paramtres" du paramtrage Visualisation directe de la partie "partenaires" du paramtrage Utilitaire d'valuation de l'tat de CFT Utilitaire de dmarrage contrl de CFT Utilitaire d'arrt contrl de CFT Utilitaire de mise jour de la configuration de CFT Visualisation simplifie des ordres classiques CFTUTIL Utilitaire de rcupration de la version de CFT Table de transcodage EBCDIC en ASCII ISO 8859-1 Utilitaire d'initialisation de l'environnement d'habilitation de CFT Utilitaire de mise jour de l'environnement d'habilitation de CFT Utilitaire de dmarrage et darrt du Serveur IUI Utilitaire de manipulation sur des groupes (ensemble dUtilisateurs accdant au serveur Copilot Utilitaire de manipulation les Utilisateurs accdant au serveur Copilot Utilitaire de manipulation des tables de transcodages Utilitaire de test en boucle des lignes X.25 ( disponible sur toutes les plates-formes supportant X25)

CFT V2.4

1-1

CFT UNIX Guide dexploitation

1.3. Table de transcodagePar 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.

1.4. Utilitaires de gestion de CFT

1.4.1. cftinitcftinit est un utilitaire d'initialisation gnrale de CFT. Syntaxe cftinit [ [...]] 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.4

1-2


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.

1.4.2. cftstartcftstart est un utilitaire de dmarrage contrl de CFT et de ses lments complmentaires. Syntaxe cftstart [ | -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.4

1-3


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 Copilot. Pour personnaliser le fonctionnement de cftstart, se reporter au chapitre "Utilisation des lments additionnels".

1.4.3. cftstopcftstop 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 Waiting for Waiting for Waiting for Waiting for Waiting for CFT stopped % CFTLOG .... stopped CFTTCPS ... stopped CFTTPRO ... stopped CFTTCOM ... stopped CFTTFIL ... stopped CFTMAIN ....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.4

1-4


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' : ### 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 msg queue 57360 Removing msg queue 98321 Removing msg queue 90130 Removing msg queue 233491 Removing shared memory 69638 Removing shared memory 36871 Removing semaphore 49167 Removing semaphore 49168 CFT stopped. % yes

CFT V2.4

1-5


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. cftstop, tel que livr par dfaut, ne procde pas larrt automatique des lments complmentaires de CFT Copilot. Pour personnaliser le fonctionnement de cftstop, se reporter au chapitre "Utilisation des lments additionnels".

1.4.4. cftupdatecftupdate est un utilitaire permettant la mise jour de la configuration. Syntaxe cftupdate [ ...] Remarques : cette mise jour n'est possible que sur les cartes de votre fichier de configuration (par exemple CFTPART, CFTxxx pour les rseaux, les cartes CFTSEND), il faut considrer cette commande comme un alias de CFTUTIL @ pour chaque nom de fichier donn en paramtre de la ligne de commande.

1.4.5. cftutilcftutil 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 Usage % cftutil listcat type=z CFTU26E LISTCAT _ Error (TYPE cftutil code 115 % Bad value for parameter)

CFT V2.4

1-6


1.4.6. secinitsecinit est un utilitaire d'initialisation de l'environnement d'habilitation de CFT. Syntaxe secinit [ [...]] 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.

1.4.7. secupdatesecupdate est un utilitaire permettant la mise jour de l'environnement d'habilitation de CFT. Syntaxe secupdate [ ...] Remarque : il faut considrer cette commande comme un alias de SECUTIL @ pour chaque nom de fichier donn en paramtre de la ligne de commande.

CFT V2.4

1-7


1.5. Utilitaires de manipulation de CFT

1.5.1. cftcatacftcata 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.

1.5.2. cftcatabcftcatab 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.

1.5.3. cftcatalcftcatal 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 vers les versions plus rcentes de CFT UNIX, la migration du fichier catalogue de l'ancien vers le nouveau format.

CFT V2.4

1-8


Syntaxe cftcatal La commande cftcatal permet : la modification de la taille du catalogue de CFT, la migration d'un catalogue (y compris pour un catalogue ancien format).

1.5.4. cftlogcftlog est en fait un raccourci pour la visualisation pagine du fichier journal de CFT. La pagination est ralise par lutilitaire more. Syntaxe cftlog

1.5.5. cftalogcftalog est en fait un raccourci pour la visualisation pagine du fichier journal altern de CFT. La pagination est ralise par lutilitaire more. Syntaxe cftalog

1.5.6. cftparmcftparm est en fait un raccourci amlior de la commande CFTUTIL LISTPARM TYPE=ALL Syntaxe cftparm

1.5.7. cftpartcftpart est en fait un raccourci amlior de la commande CFTUTIL LISTPART TYPE=ALL Syntaxe cftpart

CFT V2.4

1-9


1.5.8. cftdelcatcftdelcat 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

1.5.9. xfbadmgrpxfbadmgrp est un utilitaire de cration, destruction et modification dun groupe (dutilisateurs) permettant de se connecter au serveur Copilot ou 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 ] [-p ] [-g ] [-u ] Suppression dun groupe dutilisateurs : xfbadmgrp delete [-G ] Modification dun groupe dutilisateurs : xfbadmgrp modify [-G ] [-p ] [-g ] [-u ] Affichage des informations sur les groupes existants : xfbadmgrp print [-G ] Affichage dinformations sur un groupe donn ( si loption -G est utilise ) ou sur tous les groupes existants : Usage classique

CFT V2.4

1-10


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 -p -g : nom ASCII du groupe dutilisateurs, : mot de passe daccs ce groupe, : identifiant numrique du groupe. Si sa valeur est AUTO, le GID est gnr automatiquement,

-u : liste dutilisateurs pralablement existants, spars par une virgule.

1.5.10. xfbadmusrxfbadmusr est un utilitaire de cration, destruction et modification dun utilisateur permettant daccder au serveur Copilot ou 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 ] [-p ] [-u ] [-g ] Si le groupe nexiste pas, il est automatiquement cr et porte comme nom le login de lutilisateur. Suppression dun utilisateur : xfbadmusr delete [-l ] Lutilisateur est aussi automatiquement supprim, au niveau du fichier xfbgroup, de tous les groupes auxquels il est rattach. Modification dun utilisateur : xfbadmusr modify [-l ] [-p ] [-u ] [-g ] Si ncessaire, les modifications se rpercutent automatiquement sur le fichier xfbgroup. Affichage des informations sur les utilisateurs existants : xfbadmusr print [-l ] : Affichage dinformations sur un utilisateur ( si loption -l est utilise ) ou sur tous les utilisateurs existants.

CFT V2.4

1-11


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 > -u < UID > -g < GID > : nom de login, : identifiant de lutilisateur. Si sa valeur est AUTO, un UID est gnr automatiquement, : identifiant du groupe. Si sa valeur est AUTO, le GID est gnr automatiquement. -p < passwd > : mot de passe,

1.6. Utilitaires caractre systme

1.6.1. cft2unixcft2unix est un utilitaire permettant, au sein d'un 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 Usage % cft2unix _CFTLOG /home/tranfer/cft/fillog/cft_log %

1.6.2. cftkeycftkey est un 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

CFT V2.4

1-12


Usage % cftkey Informations techniques sur votre systme -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=build model procs cpuid syst level state IBM/BULL 4C 02 >5E378C5E378C5E37< AIX 5 1

Lexemple ci-dessus illustre les informations fournies par cftkey sur une machine dorigine IBM, sous AIX 5.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).

1.6.3. cftversioncftversion 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 Informations sur CFT Version 2.4.1 20060329 CFT * * * * informations : product = CFT/V2/UAIX 51L version = 2.4.1 level = m-3-3 upgrade = none

Host informations : * model = 4C * cpuid = 5E378C5E378C5E37 XIP * * * * informations : xip-product xip-version xip-applied-patches xip-forbidden-patches

= XFB Monitor CFT = 2.4.1 = =

CFT V2.4

1-13


1.6.4. cftpingcftping 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. 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 verbose (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).

CFT V2.4

1-14


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.

1.6.5. x25loopx25loop 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), si la commande choue, il est peu 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 [-l#] [-m] [-t] ou x25loop -h

CFT V2.4

1-15


avec : : 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]: 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 UNIX". On y trouvera, par exemple le cas des plates-formes AIX, o il est possible davoir les 2 syntaxes : ./x25loop ou ./x25loop -m 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 En cas de succs, il saffiche une squence approchant le modle ci-dessous : % x25loop 32 x25loop v1.4 - Copyright (C) 2006 SOPRA Working on "gandalf", AIX 5.1 Calling 32, line 0, default sap : " X2526124". 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 Sending 4096 bytes ........................ 4096 bytes Sending 2048 bytes ........................ OK Sending 2048 bytes ........................ OK Waiting 2048 bytes ........................ 2048 bytes Waiting 2048 bytes ........................ 2048 bytes Sending CLEAR ............................. OK

rcvd. rcvd.

rcvd. rcvd.

CFT V2.4

1-16


Receiving CLEAR ........................... Sending CLEAR CF .......................... Stopping asynchronous listen .............. Stopping link #00 ......................... Stopping X25 .............................. *** Test OK *** %

OK OK OK OK 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.

1.6.6. xvixvi est un utilitaire permettant la manipulation d'une table de transcodage. Syntaxe xvi [-d | -a | -e | -l ] Usage classique xvi : Manipulation d'une existante et valide (256 caractres). Usage volu Les diffrentes options utilisables avec xvi sont les suivantes : -d : affichage l'cran et en ASCII d'une existante et valide, -a : cration d'une pour la conversion ASCII -> EBCDIC. Cette table est identique la table accde via le CFTXLATE de CFT (si existe, son contenu est perdu), -e : cration d'une pour la conversion EBCDIC->Ascii. Cette table est identique la table accde via le CFTXLATE de CFT (si existe, son contenu est perdu), -l : cration d'une partir d'un ASCII. Typiquement, le fichier utilis ici est le fichier obtenu aprs usage de l'option -d (si existe, son contenu est perdu.

CFT V2.4

1-17

2. Pralable la mise en uvre de CFT

2.1. PrsentationAvant de pouvoir tester la bonne installation de XFB Monitor CFT, 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.

2.2. Cl de protection logicielleLe 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.

2.2.1. Obtention de la cl de protectionPour 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.

2.2.2. Prise en compte de la cl de protectionLa 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).

2.3. Oprations de paramtrageCes 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 UNIX", dans la section correspondant votre machine.

CFT V2.4

2-1

3. Premiers lancements de CFT

3.1. PrsentationDans 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 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.

3.2. Test dinstallation de CFT en mode TCPPour raliser ce test, nous allons utiliser un fichier de configuration ex_conf_uk.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.

3.2.1. Paramtrage du moniteur CFTAvant 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_uk.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. CFTPARM ID = IDPARM0, KEY = 012zmuh6kjuj2356eya09i

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.

CFT V2.4

3-1


cftnet

id type call host maxcnx mode

= = = = = =

TCPIP, TCP, inout, myhost, 3, 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 host cnxin cnxout = = = = TOULOUSE, myhost, 8, 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 TYPE PROF NET SAP = = = = = PESITCFT, PESIT, CFT, TCPIP, 1761,

/* Port d'coute */

CFTPART

ID = TOULOUSE, PROT = PESITCFT, SAP = 1761,

/* Port d'coute */

6.

Sauvegarder vos modifications.

3.2.2. Excution du testLa 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_uk.tcp 3. Aprs lapparition du message "cftinit complete", activer CFT l'aide de l'utilitaire cftstart : cftstart

CFT V2.4

3-2


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). Date = 25/05/2007, Time = 11:48:32STSA File Transfer Records Ident Ident Transmit -------- ---- ----- -------- -------PARIS RFT TXT B1820002 112 TOULOUSE SFT TXT B1820002 112 Partner Diag Diag Applic Total Protocol Ident ---------- -------112 0 CP 34% 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 ventuellement l'tat correct de CFT l'aide de l'utilitaire cftping : cftping -v qui doit, tout naturellement, indiquer : cft: not running

3.3. Test dinstallation de CFT en mode X25Pour raliser ce test, nous allons utiliser un fichier de configuration ex_conf_uk.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 d'exploitation" spcifique de votre machine pour de plus amples informations.

CFT V2.4

3-3


3.3.1. Rappel sur ladressage X25Dans 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 l'adresse X25. Par exemple : pour un numro de porte de sortie gal 00, l'adresse est la suivante : DIALNO = 0017512345654

3.3.2. Paramtrage du moniteur CFTAvant 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. 2. A l'aide de votre diteur (par exemple vi), diter le fichier ex_conf_uk.x25 situ sous le rpertoire filinst. 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 : CFTPARM ID = IDPARM0, KEY = 012zmuh6kjuj2356eya09i

CFT V2.4

3-4


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 DIALNO = TOULOUSE, = 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 d'exploitation CFT UNIX" spcifique votre machine.

CFTNET

ID TYPE LINEID

= X.25, = X25 = CIOline.0,

/* guide spcifique */

5.

Pour fonctionner en X25, CFT peut utiliser un routage de l'appel 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 TYPE PROF NET SAP ID PROT SAP = = = = = PeSITCFT, PESIT, CFT, X.25, 177, /* Exemple de SAP en */ /* sous-adresse */

CFTPART

= TOULOUSE, = PESITCFT, = 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 la documentation en ligne de CFT). CFTPROT ID TYPE PROF NET SAP ID PROT SAP = = = = = PeSITCFT, PESIT, CFT, X.25, "TEST" /* /* = TOULOUSE, = PeSITCFT, = "TEST" /* /*

Exemple de SAP sur */ donnes utilisateur */

CFTPART

Exemple de SAP sur */ donnes utilisateur */

6. Sauvegarder vos modifications.

CFT V2.4

3-5


3.3.3. Excution du testLa procdure est la suivante : 1. Se placer sous le rpertoire filinst . 2. Gnrer les bases de CFT l'aide de l'utilitaire cftinit : cftinit ex_conf_uk.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 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 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) : Date = 25/05/2007, Time = 11:48:32Partner STSA File Transfer Ident Ident TXT TXT B1820002 B1820002 Records Transmit Total 112 112 112 112 Diag Diag Applic Protocol Ident 0 CP 34% 0 CP 34%

-------- ---- ------ -------- -------- ------- --PARIS RFT TOULOUSE SFT

2 record(s) selected 2 record(s) in Catalog file 498 record(s) free (99%) CFTU00I LISTCAT _ Correct

6. Il faut maintenant arrter CFT l'aide de l'utilitaire cftstop : cftstop 7. 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.4

3-6

4. Mise en exploitation de CFT

4.1. Oprations de paramtrageQue 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 UNIX", dans la section correspondant votre machine.

4.2. Configuration du moniteur CFT4.2.1. Paramtrage du moniteur CFTL'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_uk.tcp ou ex_conf_uk.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.

4.2.2. Cration initiale des fichiers "Environnement CFT" et initialisationLa 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_uk.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.

CFT V2.4

4-1


4.3. Activation et arrt de CFT

4.3.1. Activation de CFT par la commande cftstartLe lancement de CFT est obtenu simplement par le biais de l'utilitaire cftstart, dj voqu au chapitre "Utilitaires de gestion de CFT".

4.3.2. Activation automatique de CFT au dmarrage de la machineLa 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.

4.3.2.1. Usage du fichier /etc/inittabCette 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.4

4-2


4.3.2.2. Ajout dun fichier sous /etc/rc3.dCette 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.

4.4. Arrt du moniteur CFTL'arrt de CFT peut tre obtenu de 3 faons : par le biais de l'utilitaire cftstop, par linterface graphique Copilot par 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" .

4.4.1. Arrt de CFT laide de la commande cftstopIl 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.4

4-3


4.4.2. Arrt de CFT par lutilitaire CFTUTILSi l'utilitaire CFTUTIL n'est 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.

4.4.3. Arrt brutal de CFTDans 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 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.

4.5. Excution de CFTUTILCFTUTIL 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,

CFT V2.4

4-4


modification, ajout de certains paramtres, visualisation des fichiers paramtres, partenaire, catalogue, journal et statistiques (account), envoi de commandes au moniteur.

4.5.1. ActivationL'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.

4.5.2. Saisie en mode ligneCFTUTIL 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 CFTU20I CFTU20I CFT/V2/UAIX 51L CFTU20I Version 2.4.1 20060329 CFTU20I (C) Copyright AXWAY 1989-2003 CFTU20I ====> Starting Session on 15/05/2007 Time is 12:00:50 CFTU20I CFT> send part=siege,idf=txt,fname=/home/lisa/rapport.txt CFTU94I SEND part=SIEGE,idf=TX _ Correct CFT> /end %

4.5.3. Paramtres dactivationCFTUTIL 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

CFT V2.4

4-5


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

4.6. Prise en compte dutilisateurs supplmentairesSi 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.

4.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 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

CFT V2.4

4-6


4.6.2. Environnement daccs aux fichiers de CFTAfin 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.

4.6.2.1. Variables denvironnement utilises par CFTLe tableau ci-dessous donne la liste exhaustive, trie par ordre alphabtique, des variables denvironnement utilises par CFT. 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 2. Chemin d'accs aux fichiersDfinition par dfaut Sommet de larborescence dinstallation de CFT Rpertoire filapi Rpertoire fildat Rpertoire filexe Rpertoire filexit Rpertoire fildat Rpertoire filinst Rpertoire fillib Rpertoire fillog Rpertoire filnotes Rpertoire filpub Rpertoire filsec Rpertoire filusr Fichier d'initialisation des Fonctions Interactives Rpertoire des Fonctions Interactives Rpertoire des bases pour le systme dhabilitation Fichier d'initialisation du systme d'habilitation Fichier de mise en uvre du systme d'habilitation Fichier de mise en uvre du systme d'habilitation Fichier paramtre de mise en uvre du systme d'habilitation Rpertoire renfermant les informations de scurit Fichier Statistiques Fichier Statistiques Altern Fichier Catalogue Fichier Communication

Variable denvironnement CFTDIRHOME CFTDIRAPI CFTDIRDAT CFTDIREXE CFTDIREXI CFTDIRINQ CFTDIRINS CFTDIRLIB CFTDIRLOG CFTDIRNOT CFTDIRPUB CFTDIRSEC CFTDIRUSR CFTFICNF CFTFIDIR CFTHADIR CFTHICNF CFTHIDIR CFTHINI CFTHPARM CFTPKIDIR CFTACNT CFTACNTA CFTCATA CFTTCOM

CFT V2.4

4-7

CFT UNIX Guide dexploitation Variable denvironnement CFTLOG CFTLOGA CFTPARM CFTPART CFTPKU CFTTRKCNF CFTTRKEVT CFTTRKCYC CFTDIRCOPILOT CFTDIRADX CFTXIP_COMPONENT_PROPERTIES Dfinition par dfaut Fichier Journal Fichier Journal Altern Fichier Paramtres Fichier Partenaire Fichier base PKI Fichier de configuration suivi Sentinel Fichier XML envents Sentinel Fichier XML link cycle Sentinel Rpertoire filcopilot Rpertoire filadx Rfrence au fichier de proprit XIP

4.6.2.2. Positionnement des variables denvironnementEn 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 :#-------------------------------------------# CFT configuration #-------------------------------------------if [ -z "$CFTDIRDAT" ]; then export ENV_CFT_PATH=$PATH export ENV_CFT_LD_LIBRARY_PATH=$LD_LIBRARY_PATH fi if [ -z "$ENV_CFT_PATH" ]; then dirty=1 echo "Dirty CFT environnement!" ENV_CFT_PATH=$PATH ENV_CFT_LD_LIBRARY_PATH=$LD_LIBRARY_PATH fi CFTDIRHOME= 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 CFTHADIR=$CFTDIRHOME/fildat CFTHICNF=$CFTDIRHOME/filint/default.sei CFTHIDIR=$CFTDIRHOME/filint CFTHINI=$CFTDIRHOME/fildat/sec.ini CFTHPARM=$CFTDIRHOME/fildat/secparm CFTPKIDIR=$CFTDIRHOME/filsec/pki

CFT V2.4

4-8

CFT UNIX Guide dexploitation 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 CFTTRKCNF=$CFTDIRHOME/fildat/trkapi.cfg CFTDIRADX=$CFTDIRHOME/filadx CFTDSPCNF=$CFTDIRHOME/fildat/dspcnf.xml CFTDIRCOPILOT=$CFTDIRHOME/filcopilot cop_home_dir=$CFTDIRCOPILOT p_cs_config_file=$CFTDIRDAT/xfbsrv_coms.cfg PATH=$PATH:$CFTDIREXE:$CFTDIRUSR:$CFTDIREXI:$CFTDIRAPI:$CFTDIRCOPILOT export PATH LIBPATH=${LIBPATH-}:$CFTDIRLIB export LIBPATH export export export export export export export CFTDIRHOME CFTDIRAPI CFTDIRDAT CFTDIREXE CFTDIREXI CFTDIRINQ CFTDIRINS CFTDIRLIB CFTDIRLOG CFTDIRNOT CFTDIRPUB CFTDIRSEC CFTDIRUSR CFTFICNF CFTFIDIR CFTHADIR CFTHICNF CFTHIDIR CFTHINI CFTHPARM CFTPKIDIR CFTPKU CFTACNT CFTACNTA CFTCATA CFTCOM CFTLOG CFTLOGA CFTPARM CFTPART CFTTRKCNF CFTDIRADX CFTDIRCOPILOT CFTDSPCNF cop_home_dir p_cs_config_file CFTXIP_COMPONENT_PROPERTIES=$CFTDIRHOME/XIP/component.properties

# Call to the customizable script if [ -f $HOME/ENV_CFT_CUSTOM ] then . $HOME/ENV_CFT_CUSTOM fi if [ ! -z "$dirty" ]; then unset ENV_CFT_PATH unset ENV_CFT_LD_LIBRARY_PATH unset dirty fi #-------------------------------------# End of CFT configuration #--------------------------------------

En C shell (csh), les commandes sont ajouter au fichier ~/.cshrc ou ~/.login , sous la forme : setenv Par exemple, pour la variable CFTCATA, on obtiendra : setenv CFTCATA $CFTDIRHOME/fildat/cft_cata

4.6.3. Privilges et droits ncessairesTout 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.

CFT V2.4

4-9


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.

4.7. Remarques sur les procdures de basculementCFT 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. 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 FNAME AFNAME SWITCH EXEC = = = = = log0, '_CFTLOG', '_CFTLOGA', 2359, 'switch.cmd' /* /* /* /* Fichier journal Fichier journal altern Heure de commutation Procdure de commutation */ */ */ */

pour raliser le basculement du fichier des statistiques, dans la section CFTACNT, on utilisera typiquement la dclaration suivante: CFTACCNT ID FNAME AFNAME SWITCH EXEC = = = = = acct0, '_CFTACNT', /* '_CFTACNTA', /* 2359, /* 'switch.cmd',/* Fichier statistiques */ Fichier stat. altern */ Heure de commutation */ Procdure de commutation*/

CFT V2.4

4-10


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.

4.7.1. Exemple de procdure de basculement : switch.cmdSi 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_uk.tcp et ex_conf_uk.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. 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),

-

CFT V2.4

4-11


mv ${filename} ${filename}_sav 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").

4.7.2. Exemple de procdure : basculement du fichier des statistiquesSur 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_uk.tcp et ex_conf_uk.x25. #!/bin/sh # # Exemple de procdure de "switch" du fichier ACCNT # filename=`cft2unix &FACCNT` mv ${filename} ${filename}_sav 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.

4.8. Exploitation des fichiers statistiquesCFT 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 le CD, nest effectivement charg sur votre systme que si, au moment de linstallation, vous avez demand le chargement du composant Interface de programmation et EXIT .

CFT V2.4

4-12


4.8.1. Constitution de lexempleSous 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. 2. Taper la commande : make -f mk_exacct 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

4.8.2. Excution du testCe 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_uk.tcp ou ex_conf_uk.x25). La procdure est la suivante : 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.

4.9. Gestion des suffixesPar dfaut, lors de l'mission ou la rception de fichiers, CFT se base sur le type du fichier (champ FTYPE dcrit dans le guide "Concepts" et dans la documentation en ligne de CFT) pour modliser son comportement. Cependant, CFT dispose aussi d'un mcanisme dit de gestion des suffixes. Cette fonctionnalit permet CFT de dterminer le type du fichier trait simplement partir du nom de ce fichier.

CFT V2.4

4-13


4.9.1. Dfinition des suffixesPour CFT, 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 : = avec : longueur du suffixe infrieure ou gale 8 caractres, FTYPE : un des types de fichiers reconnus par CFT. La liste de ces types, dtaille dans la documentation en ligne 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

Documents

XFB Monitor CFT Guide Exploitation 2 4 1 UNIX FRA