COMMUNICATION TECHNIQUE N TC0419 Ed. 01 OmniPCX 4400 Nb de pages : 7 Date : 10-02-2003 URGENTE (FLASH PRODUIT) NON URGENTE (INFO PRODUIT) TEMPORAIRE DEFINITIVE OBJET : BASE DE DONNÉES : OUTILS DE TRACE Cette communication technique est à utiliser lors de problèmes liés à la base de données OmniPCX 4400 et OmniPCX Enterprise. 1
BASE DE DONNÉES : OUTILS DE TRACES OmniPCX 4400 SOMMAIRE 1. GÉNÉRALITÉS...3 2. OUTILS...3 2.1. checkdb... 3 2.2. checkinitrem trace... 3 2.3. traced... 3 2.4. srvtrace... 4 2.5. mao... 4 2.6. multitool... 5 2.7. ps ef... 5 3. FICHIERS DE LOG...6 3.1. Translations... 6 3.2. cmisd... 6 3.3. Exceptions... 6 Ed. 01 / 10-02-2003 1 TC0419
OmniPCX 4400 BASE DE DONNÉES : OUTILS DE TRACES TC0419 2 Ed. 01 / 10-02-2003
BASE DE DONNÉES : OUTILS DE TRACES OmniPCX 4400 1. GÉNÉRALITÉS Cette communication technique est à utiliser lors de problèmes liés à la base de données OmniPCX 4400 et OmniPCX Enterprise. Ces problèmes sont de type : incidents de type 2666 (sur CPU Main ou Stand-By), incidents de type 4351 au démarrage du téléphone (phase "initrem" : placement des rémanents en mémoire), erreurs de gestion avec un "sql code", autres problèmes : contacter le Support Technique. Les informations collectées avec ces outils devront être jointes avec la base de données dans une fiche d'observation. La base de données doit être fournie dans le format des sauvegardes disponible sous swinst. Copier le fichier : mao-dat sous /usr4/backup/dayxx ou WEEKxx ou MONTHxx généré lors d une sauvegarde périodique ou, mao-acc sous /usr4/backup/immed pour une sauvegarde immédiate. Ces fichiers sont déjà compressés par swinst. Tous les outils présentés dans ce document fonctionnent sur la CPU sur laquelle ils ont été lancés. En cas de duplication, ces outils devront être aussi lancés sur la CPU Twin. 2. OUTILS Les outils présentés ci-dessous s utilisent tous sous le compte mtcl. 2.1. checkdb Cet outil édite toutes les incohérences de la base de données. Il simule "initrem" au lancement du téléphone. 2.2. checkinitrem trace Se placer dans le répertoire /usr3/mao. Idem "checkdb" mais avec des traces en plus. 2.3. traced Cet outil est le traceur qui éditera des informations d après des filtres à positionner. Il est un peu l équivalent de "mtracer" utilisé pour les traces téléphone. Il doit donc être utilisé avec d autre outils de filtres décrits ci-après. Ed. 01 / 10-02-2003 3 TC0419
OmniPCX 4400 BASE DE DONNÉES : OUTILS DE TRACES Syntaxes traced Lancé sans option, il ne rend pas la main. L arrêter par un "Suppr" sur le terminal. Les traces sortent sur le terminal qui a lancé traced. traced & L outil rend la main. L'arrêter par kill 9 xxx (xxx est son Pid). traced d 1 <file_name> -s <size> -f <files_number> -d fait passer l'outil en mode "daemon" c'est-à-dire qu il ne se "tue" pas quand le shell se termine (retour au login). 1 <file_name> : donner un nom de fichier avec son chemin complet pour obtenir des traces dans ce fichier (plus de sortie écran). s <size> : taille du fichier de traces en Ko. f <files_number> : nombre de traces que l on veut stocker. Cette syntaxe est à utiliser pour des problèmes non reproductibles/aléatoires. Il y aura un stockage de plusieurs fichiers de traces qui auront tous la taille définie par l option "-s". Pour arrêter l outil, taper kill 9 sur son Pid. Exemple Si le nom de fichier est trc et si le nombre maximum de fichiers est 35, ces fichiers prendront les noms "trc-00" jusqu à "trc-34". Les traces sont tournantes c'est-à-dire qu arrivé au dernier fichier de traces, le suivant s'appellera "trc-00" avec écrasement des données précédentes. 2.4. srvtrace Il doit être utilisé avec traced. Tous les accès à la base de données seront tracés. Les accès en mémoire sont exclus. Si des informations de type "rollback" sont affichées, alors il y a un problème : la modification demandée est refusée. Si aucune information n est affichée, alors il n y a eu que des requêtes en mémoire. Les informations sont des commandes sql envoyées au serveur de base de données via le téléphone/gestion et le process cmisd. Cet outil fonctionne en mode "flip-flop". Pour arrêter la trace, relancer l outil. Des informations de type "service trace on" ou "service trace off" seront affichées même si les traces ont été redirigées sur fichier. 2.5. mao L outil "mao" est aussi un filtre qui doit être activé avec diverses options visualisables par mao -? : Option trace +obj Option trace +gen Option -a acs all TC0419 4 Ed. 01 / 10-02-2003
BASE DE DONNÉES : OUTILS DE TRACES OmniPCX 4400 Cette option va éditer l état des tables auditées par le process d audit mao ("access en cours" et "locks"). Contacter le Support Technique pour définir celles qui doivent être activées lors d'un problème. 2.6. multitool Cet outil est capable de diagnostiquer des erreurs de base de données ou mémoire sur les touches de supervision ou MLA des usagers. Lancé sans option, il n'édite que des données. Lancé avec option, il peut détecter les erreurs et les réparer. Ce n est pas réellement un outil de trace mais plutôt de diagnostic. Option "CHECK". Choisir le menu [ 8] - Check Supervision and MLA. Cette option va effectuer la vérification des touches multilignes et de supervision de poste. Les résultats sont stockés dans le fichier /usr3/mao/superv.out. Ce fichier est un fichier texte mais l exploitation de ces résultats dépasse le cadre de ce document. Il est destiné au Support Technique et R&D. Option "REPAIR". Inhiber tout d'abord tout accès à la base de données, taper mao off. Choisir le menu [ 8] + Repairing Supervision ou [ 9] + Repairing MLA. Puis choisir le type de réparation (en mémoire ou sur disque et mémoire). Les résultats sont stockés dans le fichier /usr3/mao/repairing.out. Valider l accès à la base de données par mao on. Les supervisions sur des usagers réseau ne sont pas traitées. 2.7. ps ef Cette commande permet de vérifier si tous les process relatifs à la base de données sont présents. Jusqu en Release 5.0 Ux, les process suivants apparaissent dans l ordre de démarrage du système (une évolution est possible) : 1 process cmisd : gère les événements en format CMIP/CMISE en provenance des applications, 1 process sqlsrv : est le père de plusieurs autres, 1 process maoagent, 3 process sqlsrv : sont démarrés par maoagent (mais qui ne sont pas ses fils). Ils gèrent les écritures/lectures dans la base de données. Ce sont eux qui sont tracés par srvtrace, 1 process sqlsrv : lancé pour chaque application hôtelière, 1 process sqlsrv pour l application phonebook. Ed. 01 / 10-02-2003 5 TC0419
OmniPCX 4400 BASE DE DONNÉES : OUTILS DE TRACES 3. FICHIERS DE LOG Divers fichiers de log peuvent être exploités hormis ceux fournis par traced. 3.1. Translations Tout est visualisable par swinst/7-database tools/5-about last database operation. 3.2. cmisd Plusieurs fichiers SRVLOG.x se trouvent sous /tmpd. Ces fichiers relatent l activité du process sqlsrv (traitent les requêtes à la base de données). 3.3. Exceptions La commande excvisu édite les exceptions générées par les deux principaux process liés à la base de données : cmisd et maoagent. TC0419 6 Ed. 01 / 10-02-2003