3.1 LIMITES DE L’OUTIL........................................................................................................................ 2 3.2 FICHIERS TBL ET COMPATBILITE OXO ............................................................................................ 2 3.3 OUVERTURE DE SESSION OSC ...................................................................................................... 3 3.4 EXPLOITATION DE LA CONSOLE DE TRACES ................................................................................. 4 3.4.1 Ouverture de la console........................................................................................................... 4 3.4.2 Utilitaires console .................................................................................................................... 4 3.5 FERMETURE DE SESSION OSC ....................................................................................................... 5 4 OSC - EXPLOITATION DES FONCTIONS DE TRACE................................................................... 6 4.1 ISDN (RNIS) ................................................................................................................................... 6 4.1.1 Mise en œuvre des traces RNIS ................................................................................................ 6 4.1.2 Analyse des traces RNIS ........................................................................................................... 7 4.1.3 Arrêt des traces RNIS dans le système....................................................................................... 9 4.2 CLI ................................................................................................................................................. 9 4.2.1 Mise en œuvre des traces CLI................................................................................................... 9 4.2.2 Analyse des traces CLI ........................................................................................................... 10 4.2.3 Arrêt des traces CLI dans le système ....................................................................................... 10 4.3 DECT ........................................................................................................................................... 11 4.3.1 Affichage des compteurs DECT .............................................................................................. 11 4.3.2 Analyse des compteurs DECT................................................................................................. 12 4.4 VOIP STATUS ............................................................................................................................... 12 4.4.1 Affichage des informations VoIP ............................................................................................. 12 4.4.2 Analyse des informations VoIP................................................................................................ 13 5 OSC – UTILISATION AVANCEE................................................................................................ 14 5.1 SELECTION D’UN FICHIER TBL EXTERNE ...................................................................................... 14 5.2 UTILISATION DE MENU DE CONNEXION AVANCE...................................................................... 14
1 PRESENTATION GENERALE OSC (OmniPCX Office Serviceability Console) est le nouvel outil de traces d’OMC 700. C’est une évolution majeure de la version « PhD » disponible dans OMC 600/610. Note : « PhD », l’outil de traces RNIS, est décrit dans le bulletin technique N°111.
A la fonction de traces RNIS niveau 3, OSC rajoute de nouvelles facilités de maintenance pour les équipements de l'OmniPCX Office : • CLI : analyse des infos de CLI reçues sur les lignes réseau analogiques • DECT : contrôle et affichage des compteurs de trafic DECT • VoIP : contrôle des ressources et des communications VoIP
2 OUTILS DE TRACE DISPONIBLES DANS OMC 700 Deux outils sont disponibles : • PhD-relay : (voir Communication Technique N°97). PhD-Relay est disponible depuis la version OMC500. Cet outil permet à un installateur de récupérer les traces de débogage à la demande du fabricant, lorsque la connexion à distance sur le PABX n'est pas possible. • OSC : (décrit dans ce document). C’est un outil de traces avancé qui permet l’aide au diagnostic pour la maintenance ou le déploiement des équipements de l’OmniPCX office. La version OSC 3.2.x offre les fonctions suivantes : - “ISDN” : analyse au fil de l’eau des traces de protocole RNIS/QSIG niveau 3 sur les liens T0/T2 (idem application PhD avec rajout de l’horodatage des messages console). - “CLI” : affichage en clair et au fil de l’eau des infos CLI d’identité de l’appelant sur les lignes réseau analogiques (données transportées en modulation sur le signal de sonnerie). - “DECT” : contrôle direct des compteurs de trafic et maintenance associés aux terminaux et bornes DECT. Affichage immédiat des données statistiques sur l’infrastructure DECT. - “VoIP Status” : contrôle et affichage direct de l’état des ressources DSP et des communications VoIP en cours. Affichage de données statistiques d’utilisation des ressources VoIP.
3 OSC - GENERALITES & DEMARRAGE
Note : les expressions “cible”, “système cible”, “OXO cible” sont communément utilisées dans ce document pour indiquer le système OXO faisant l’objet des traces ou simplement connecté à l’application OSC.
3.1 LIMITES DE L’OUTIL
Les menus de l'outil OSC sont uniquement disponibles en anglais. L'utilisation d'OSC sur les versions antérieures à la R5.1est uniquement possible dans le cadre d'une connexion distante via modem. Cette restriction n'existe pas avec les releases ≥ R5.1. Note : avec les releases supérieures à R5.1, cette restriction s’applique malgré tout si le système était précédemment équipé d’une version R110 à R500 et que sa mise à niveau soft a été effectuée sans un reformatage LoLa.
3.2 FICHIERS TBL ET COMPATBILITE OXO
Les TBL sont des fichiers de configuration associés à chaque release. Au démarrage d’OSC, la version du PABX est contrôlée et comparée aux fichiers TBL sélectionnés dans l’outil : si la release ne correspond pas, la connexion est immédiatement arrêtée et un message d'avertissement affiché à l'utilisateur. Notes : • La gestion des TBL est transparente pour l'utilisateur : OSC démarré à partir d'OMC obtient automatiquement les informations des TBL (intégrées à OSC) à utiliser. Dans certains cas spécifiques (voir § 5.2), l'utilisateur peut être amené à choisir manuellement un fichier TBL externe à la place des fichiers intégrés dans OSC. • La version OSC 3.2.004 inclut les TBL des versions officielles des releases 110, 210, 310, 410, 500, 510, 600, 610, 700 (voir tableau ci-dessous) :
OSC v3.2.004 : TBL sélection / compatibilité
Nom des TBL dans la fenêtre de 110 210 310 410 500 510 600 610 700 connexion (champ Release) Cible OXO R110/xx R210/xx R310/xx R410/xx R500/xx R510/xx R600/xx R610/xx R700/xx compatible
3.3 OUVERTURE DE SESSION OSC Suivre les étapes suivantes : A) Démarrer OMC Expert / Session Installateur Lorsqu' OMC est connecté On-Line, l'icone OSC est visible dans le menu “Outils”. Note : en raison de la restriction 3.1, l'icone OSC n’est pas présente si OMC est connecté via LAN/WAN sur un OXO équipé d’une version antérieure à R510 ; dans ce cas-là, une connexion par modem est nécessaire.
B) Double-click sur l'icône OSC pour lancer l'application
La fenêtre de connexion s’affiche après quelques secondes (l'exemple ci-dessous correspond à une connexion via LAN sur un OXO R700).
Fig. OSC connexion LAN sur une cible OXO R700 : écran Connection to PABX Note 1 : l'ouverture de la session OMC positionne automatiquement certains paramètres d’OSC : • OXO IP address : adresse IP (LAN ou PPP) utilisée par OMC pour la connexion à l'OXO, • Login : niveau de session OSC (Installateur), • Release : version TBL intégrée (correspond à la release de l'OXO), • TBL files from : version de TBL utilisée par OSC (“Release” est la version intégrée des TBL). Remarque : à part la fenêtre de console, tous les écrans de contrôle d’OSC présentent un aspect similaire comprenant deux zones distinctes : • La fenêtre de gauche, invariable : c’est le menu général (affichage & accès) des fonctions de l’outil. Les fonctions sont regroupées dans deux sections séparées • La partie droite est la fenêtre de contrôle spécifique pour la fonction actuellement sélectionnée par l’utilisateur. C) Entrer le mot de passe de session OSC pour se connecter à la cible Le mot de passe OSC pour un système est le même que celui de la session installateur. Tapez ce mot de passe dans le champ Password. Si les champs “OXO IP address”, '”Login: installer”, “Release” et “TBL files from” sont correctement renseignés, le bouton Connect devient actif.
Un click sur le bouton “Connect” démarre la procédure de connexion à l'OXO, et lorsque celle-ci est établie, l'état de la connexion est affiché : • la release / version de la cible est affichée dans la barre des titres. • un numéro d'identifiant de la CPU [001:xxx] avec l'indication “Connected” dans la barre de status. • le bouton de droite change de fonction/nom (passe de “Connect” à “Disconnect”).
D) Sélectionner la fonction de trace souhaitée (se reporter au chapitre 4)
3.4 EXPLOITATION DE LA CONSOLE DE TRACES
Quelle que soit la fonction de trace à activer sur le système, la première opération consiste à ouvrir une fenêtre de console vers laquelle seront dirigées et affichées les informations émises par le PABX.
3.4.1 Ouverture de la console
• Sélectionner “TRace EXtraction” dans le menu principal
• Le bouton “Font” (optionnel) permet de modifier la police de caractères dans la console
• Cliquer sur le bouton “Start”, La console s'ouvre.
3.4.2 Utilitaires console
3.4.2.1 Recherche/Sur-lignage de texte
La console a une fonction très utile de recherche/sur-lignage de texte qui peut être activée pendant la capture. La recherche est possible dans les deux sens via les boutons “Next” / “Previous” (Suivant / Précédent) : A) Entrer la chaine de caractères recherchée (respecter la casse) dans le champ “Find” de la console, B) Placer le curseur dans la fenêtre, à l'endroit où la recherche doit commencer, Product: Alcatel-Lucent OmniPCX Office 4 / 14 Article 1093 Ed 01 C) Cliquer sur le bouton “Highlight” (bouton à bascule) pour surligner (ou non) la chaine de caractères recherchée, D) Cliquer sur “Next” ou “Previous” pour rechercher l'occurance suivante
Exemple : recherche sur le mot “SETUP” avec la fonction de sur-lignage activée
3.4.2.2 Edition/sauvegarde Un menu contextuel (click sur le bouton droit de la souris) permet d'accéder aux fonctions suivantes : Cut, Copy, Paste, Delete, Save Selection As ...
Suivre les étapes suivantes pour sauvegarder les traces affichées dans la console : • sélectionner la partie des traces à sauvegarder (pour tout sélectionner, utiliser “Select All” dans le menu contextuel), • cliquer sur “Save Selection As” du menu contextuel : les traces sont sauvegardées en format texte. Note : la sauvegarde “save Trace and tbls As “ est effectuée à la demande du constructeur (sauvegarde en binaire des traces et de données de débogage supplémentaires pour analyse en R&D).
3.5 FERMETURE DE SESSION OSC
Il est vivement recommandé de quitter proprement la session OSC afin de ne pas laisser inutilement des traces activées dans le PABX. Suivre les étapes suivantes : A) Stopper les traces dans le système
Si des traces ISDN ou CLI avaient été précédemment activées, retournez sur la fenêtre de contrôle appropriée et appuyez sur le bouton “Reset Traces” (voir 4.1.3 pour ISDN ou 4.2.3 pour CLI).
Note : l’appui du bouton “Reset traces” permet de commander au système l’arrêt d’émission des traces mais ne ferme pas la fenêtre de console en cours d’utilisation. B) Sauvegarde des traces (voir 3.4.2.2) C) Fermeture de la console Aller dans le menu Trace Extraction et cliquer sur le bouton “Stop”.
Note : la console se ferme.
D) Déconnexion de l'OXO et fermeture d’OSC Cliquer sur le bouton “Disconnect” dans le menu “Connection to PABX“.
Pour quitter l’application OSC, sélectionner ”File menu - Quit”.
4 OSC - EXPLOITATION DES FONCTIONS DE TRACE
4.1 ISDN (RNIS)
4.1.1 Mise en œuvre des traces RNIS
Suivre les étapes suivantes A à D : A) Démarrage de la console (voir 3.4.1)
B) Sélectionner la fonction ISDN et choisir l’interface(s) à tracer
Par défaut l'outil est configuré à la valeur “Selected interface (disabled)” : les traces sont activées sur tous les accès du PABX. Pour sélectionner un accès spécifique, cliquer sur “Selected interface” puis choisir le slot et l'accès à tracer (même identification d'accès utilisée dans OMC : emplacement carte / numéro de l'accès de la carte).
Note : “Selected interface” est une fonction à bascule qui active/désactive la sélection ”Slot-Access”.
C) Activation des traces RNIS sur l'OXO
Dans la fenêtre ISDN, cliquer sur le bouton “Set Traces” : les traces RNIS sont activées pour l'interface sélectionnée. Note: si les traces sont déjà activées et que vous voulez choisir un autre accès, il faut d'abord cliquer sur le bouton “Reset Traces” puis sélectionner un nouvel accès. D) Visualisation des traces RNIS Revenir sur la console : les traces RNIS (si trafic sur les accès) défilent automatiquement dans la console. Exemple de traces RNIS dans la console :
4.1.2 Analyse des traces RNIS
Note : ce paragraphe n'a pas pour but d'expliquer le protocole RNIS, mais juste de fournir des indications de base sur la lecture des traces fournies par l'outil.
Dans les traces affichées, le point de départ d’un message RNIS niveau 3 peut être facilement identifié car il débute toujours par la syntaxe “ISDN3_ + numéro de séquence”. Chaque message niveau 3 est détaillé sur deux sections texte consécutives : • La 1ère section (une ligne de texte débutant par “ISDN3_ + n° de séquence” et étalée suivant le cas sur une à plusieurs lignes de la console) indique : - l’horodatage du message (date/ heure) - l'origine du message (RX pour le distant, TX pour l'OXO) - l'interface de l'OXO [slot/ position] - le Time Slot de signalisation utilisé (S: T:) - le nombre total d'octets des données du message (chiffre entre parenthèses) - le message (données brutes en hexadécimal sans interprétation) Exemple de1st section ci-dessus : ISDN3_00035 02/10 10:40:20 TX slot/access: [7/1] (S:00 T:000) payload: (60) 08 02 00 10 05 04 03 80 90 A3 18 01 A3 6C 06 01 80 37 31 38 33 70 06 81 30 33 36 39 39 7D 02 91 81 7E 19 00 01 16 DE 39 4D 41 52 54 49 4E 45 5A 20 4C 75 69 73 00 77 18 30 00 C0 82
• La 2ème section (zone de texte étendue, comprenant toujours plusieurs lignes et dont la première débute par “0x”) : correspond à l'interprétation en clair du message. Exemple de 2ème section ci-dessus : 0x05 SETUP Ref: O,16 ie 0x04 Bearer capability: 80 90 A3 Coding: CCITT standardized Information transfer capability: Speech Transfer mode: Circuit mode Transfer rate: 64 Kbit/s User info layer 1: G.711 A-law ie 0x18 Channel identification: A3 Interface identifier: Implicit Interface type: Primary rate Indicated channel: Preferred D-channel identified: No Information channel selection: any channel ie 0x6C Calling party number: 01 80 37 31 38 33 Number type: Unknown Numbering plan: ISDN/Telephony(CCITT Recommendation E.164/E.163) Presentation: presentation allowed Screening: user-provided, not screened Number: 7183 ie 0x70 Called party number: 81 30 33 36 39 39 Number type: Unknown Numbering plan: ISDN/Telephony(CCITT Recommendation E.164/E.163) Number: 03699 ie 0x7D High layer compatibility: 91 81 ie 0x7E User-user: 00 01 16 DE 39 4D 41 52 54 49 4E 45 5A 20 4C 75 69 73 00 77 18 30 00 C0 82
Il est possible d'arrêter les traces à tout moment. Sélectionner “ISDN” dans le menu principal et appuyer sur le bouton “Reset Traces”.
4.2 CLI
4.2.1 Mise en œuvre des traces CLI
Suivre les étapes suivantes : A) Démarrage de la console B) Sélectionner la fonction CLI et choisir l'interface(s) à tracer Cliquer sur la fonction CLI du menu principal.
Par défaut l'outil est configuré à la valeur “Selected interface (disabled)” : les traces sont activées sur tous les accès analogiques du PABX. Pour sélectionner un accès spécifique, cliquer sur “Selected interface” puis choisir le slot et l'accès à tracer (même identification d'accès utilisée dans OMC : emplacement carte / numéro de l'accès de la carte).
Note : “Selected interface” est une fonction à bascule qui active/désactive la sélection ”Slot-Access”.
C) Activation des traces CLI sur l'OXO
Dans la fenêtre CLI, cliquer sur le bouton “Set Traces” : les traces CLI sont activées pour l'interface sélectionnée. Note: si les traces sont déjà activées et que vous voulez choisir un autre accès, il faut d'abord cliquer sur le bouton “Reset Traces” puis sélectionner un nouvel accès. D) Visualisation des traces CLI Revenir sur la console : les traces CLI (si trafic sur les accès) défilent automatiquement dans la console. Exemple de traces CLI dans la console :
4.2.2 Analyse des traces CLI Note : l'exemple ci-dessous décrit les différents paramètres des traces CLI.
CLI_00182 03/10 16:39:54 RX slot/access: [4/0] : 1er ligne, n° du message interne, date et heure de l'OXO, n° de carte/accès Message Type: 0x80: Call Setup : Code du type de message reçu dans l'info CLI Payload: (25) 02 0A 30 33 39 30 36 37 34 30 33 35 08 01 4F 01 08 31 30 30 33 31 36 33 39 : contenu du message Calling number: 0390674035 : numéro de l'appelant codé dans le CLI reçu Reason for absence of Calling Name: Unavailable Name : raison de l'absence du nom codé Date and time: 10.03 16:39 : horodatage du message codé dans le CLI reçu.
4.2.3 Arrêt des traces CLI dans le système
Il est possible d'arrêter les traces à tout moment. Sélectionner “CLI” dans le menu principal et appuyer sur le bouton “Reset Traces”.
La fonction de trace DECT de l'OSC est en fait une présentation conviviale des compteurs DECT classiques de l'OmniPCX Office. Rappel : les compteurs de DECT sont également accessibles via les adresses remarquables; les données y sont présentées en format hexadécimal sans interprétation. Suivre les étapes suivantes : A) Démarrage de la console B) Sélectionner la fonction DECT Selon que les compteurs DECT sont déjà activés ou non sur l'OXO, l'OSC affichera une fenêtre avec 2 ou 4 boutons : • Les compteurs DECT ne sont pas activés dans le PABX :
- cliquer sur le bouton “Activate” pour démarrer les compteurs de l'OXO (l'adresse remarquable Particularités Système Lecture/Ecriture Mémoire Adresse par divers libellé “DectCntOn“ est automatiquement positionnée à la valeur 01). - cliquer sur le bouton “Refresh” pour forcer OSC à relire les compteurs du système. • Les compteurs DECT sont déjà activés dans le PABX :
- cliquer sur le bouton “Deactivate” pour arrêter les compteurs dans l'OXO (l'adresse remarquable Particularités Système Lecture/Ecriture Mémoire Adresse par divers libellé “DectCntOn“ est automatiquement positionnée à la valeur 00). - cliquer sur le bouton “Refresh” pour forcer OSC à relire les compteurs du système. - cliquer sur le bouton “Reset” pour remettre réinitaliser tous les compteurs DECT du système. - cliquer sur le bouton “Display” pour afficher les compteurs DECT en clair dans la console (voir ci-dessous 4.3.2)
4.3.2 Analyse des compteurs DECT Ci-dessous un exemple d'affichage des compteurs DECT. Pour plus de détails, reportez-vous à la documentation technique de l'OmniPCX Office (chapitre OmniMobility / DECT / Compteurs de trafic DECT).
4.4 VOIP STATUS
4.4.1 Affichage des informations VoIP
Suivre les étapes suivantes : A) Démarrage de la console B) Sélectionner la fonction VoIP Status
- cliquer sur le bouton supérieur “Display” (DSP used) pour afficher dans la console le status et les statistiques des DSP VoIP dans le système (voir § 4.4.2). - cliquer sur le bouton inférieur “Display” (VoIP DSP usage) pour afficher dans la console le status et les statistiques des DSP VoIP dans le système ainsi que le détails des communications VoIP actives. (voir § 4.4.2).
5 OSC – UTILISATION AVANCEE 5.1 SELECTION D’UN FICHIER TBL EXTERNE Dans des cas particuliers (exemple : OSC ne peut pas être utilisé avec une version OXO privée, les TBL intégrés à OSC ne sont pas compatibles), le Support Technique d'Alcatel-Lucent peut fournir un fichier TBL externe à utiliser avec OSC. Pour cela il faut : - Démarrer OSC depuis l'OMC comme indiqué au paragraphe 3.3, - Cocher l'option 'File' dans le menu de connexion et cliquer sur le bouton de sélection du dossier, - Rechercher et sélectionner le fichier TBL externe ( .osctbls) puis effectuer une connexion normale comme indiqué au paragraphe 3.3.
5.2 UTILISATION DE MENU DE CONNEXION AVANCE
Dans certaines topologies de réseau, il peut être nécessaire de démarrer l'outil OSC à partir du menu de connexion avancé. Pour cela il faut : - Démarrer OSC depuis l'OMC comme indiqué au paragraphe 4.1.A. - Dans la fenêtre de ”Connection”, sélectionner le login ”Manufacturer” pour accéder au menu de connexion avancé.
Des paramètres supplémentaires sont accessibles dans la fenêtre de connexion :
• “TBL files from Folder” & “Via LAN” : réservé pour l'usage du fabricant, • Port number / use proxy : pour des OmniPCX Office releases ≥ à R510, lorsque le port https standard ne peut pas être utilisé ou si le flux https doit passer par un proxy. Après avoir configuré les paramètres avancés (n° de port et/ou proxy), sélectionner à nouveau le login “Installer” pour revenir au menu de connexion standard (bien que masqués, les paramètres avancés modifiés sont conservés). Fin du document Product: Alcatel-Lucent OmniPCX Office 14 / 14 Article 1093 Ed 01
