Administrer les CUBE et les passerelles analogiques

À quoi cela sert

Sous Gateways, EasyUC gère des équipements Cisco IOS via SSH. Analog GWs affiche les passerelles VG issues du CUCM avec l'état d'enregistrement et le nombre d'appels actifs. CUBEs affiche les Cisco Unified Border Elements que vous saisissez vous-même dans EasyUC. EasyUC se connecte à l'équipement via SSH, lit son état avec des commandes show et exécute des commandes de configuration sur demande.

Sur les passerelles analogiques, vous voyez les voice ports avec leur signalisation et leur état, vous lisez la configuration d'un port avec les dial peers associés et vous appliquez des config sets enregistrés. Sur les deux types d'équipements, vous lisez les interfaces réseau, la version du système, les certificats et les appels actifs, et vous pouvez terminer un appel.

Pour les CUBE, il existe en outre la Debug capture. EasyUC active « debug ccsip messages » et « debug voip dialpeer inout » sur le CUBE, reçoit la sortie via syslog et l'enregistre pour le diagnostic des appels. Un watchdog surveille le CUBE et se désactive de lui-même en cas de surcharge.

Le Cisco CUBE est un équipement distinct du réseau. Il ne s'agit pas du SBC Teams intégré à EasyUC.

Prérequis

• Module de licence cucm. Le menu Gateways apparaît avec ROLE_APP_GATEWAYS et au moins un droit de section.
• Afficher les passerelles analogiques : ROLE_APP_GATEWAYS_ANALOG. Modifier, tester, commuter des ports, appliquer une configuration : en plus ROLE_APP_GATEWAYS_ANALOG_EDIT.
• Afficher les CUBE : ROLE_APP_GATEWAYS_CUBE. Modifier, tester, terminer un appel, commuter la capture de débogage : en plus ROLE_APP_GATEWAYS_CUBE_EDIT.
• Les administrateurs (ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN, ROLE_SUPER_ADMIN) disposent de tous les droits sur les passerelles. ROLE_APP_TEMPLATE seul ne suffit pas.
• Modifier les identifiants par défaut, créer un CUBE et définir l'hôte ou le port SSH d'une passerelle : droits de modification pour les deux zones (ROLE_APP_GATEWAYS_ANALOG_EDIT et ROLE_APP_GATEWAYS_CUBE_EDIT).
• La passerelle est joignable depuis l'appliance EasyUC via SSH. Le port SSH est 22 par défaut.
• Un utilisateur SSH sur la passerelle disposant des droits pour l'action souhaitée. Si l'équipement exige un mot de passe enable, il doit être enregistré.
• Les passerelles analogiques sont créées dans le CUCM. EasyUC lit la liste depuis la connexion CUCM active.
• Pour la capture de débogage : le CUBE atteint l'appliance EasyUC via syslog (UDP). La cible syslog est saisie sous Storage & syslog ou sur le CUBE.
• Les identifiants SSH pour Details (SSH) des nœuds CUCM sur la page d'accueil constituent un paramètre distinct avec les rôles ROLE_APP_CUCM_NODE_DETAILS et ROLE_APP_CUCM_NODE_DETAILS_EDIT. Ils ne s'appliquent pas aux passerelles.

Pas à pas : enregistrer les identifiants par défaut pour les passerelles

1. Ouvrez EasyUC Cisco → Gateways → Analog GWs.
2. Cliquez sur Default Credentials en haut à droite. La zone Default SSH Credentials s'ouvre. Les jeux s'appliquent à chaque passerelle sans identifiants propres, pour les passerelles analogiques et pour les CUBE.
3. Dans le premier jeu, saisissez Set (un nom), Username, Password, si nécessaire Enable Password, et le Port.
4. Pour d'autres connexions, cliquez sur Add credential set. L'icône de corbeille supprime un jeu.
5. Ordonnez les jeux de sorte que le plus courant soit en haut. Lors de la connexion, EasyUC essaie les jeux de haut en bas.
6. Cliquez sur Save.
7. Cliquez sur Test sur une passerelle. EasyUC essaie les jeux l'un après l'autre et mémorise celui qui fonctionne. Son nom apparaît dans la colonne Credentials.

Pas à pas : attribuer à une passerelle analogique son propre hôte et sa propre connexion

1. Ouvrez Gateways → Analog GWs. La liste affiche Model, Name, IP Address, Description, Status, Active Calls et Credentials.
2. Dans la ligne de la passerelle, cliquez sur Credentials. Le formulaire Credentials for <Name> s'ouvre.
3. Sous IP Address / Host, saisissez l'adresse à laquelle EasyUC atteint la passerelle via SSH. C'est nécessaire si le CUCM ne signale aucune adresse IP.
4. Saisissez les valeurs divergentes pour Username, SSH Port, Password et Enable Password. Un champ vide utilise la valeur par défaut.
5. Cliquez sur Save. La colonne Credentials affiche maintenant Custom.
6. Cliquez sur Test pour vérifier la connexion.
7. Pour supprimer à nouveau les identifiants propres à la passerelle, cliquez sur l'icône de réinitialisation dans la ligne et confirmez Are you sure?.

Pas à pas : ajouter un Cisco CUBE

1. Ouvrez EasyUC Cisco → Gateways → CUBEs. La page s'appelle CUBEs (SBC).
2. Cliquez sur Create. Le formulaire Add Cisco CUBE (SBC) s'ouvre.
3. Saisissez Name et IP Address. Les deux sont des champs obligatoires.
4. Vérifiez le SSH Port. La valeur par défaut est 22.
5. Saisissez Username (obligatoire), Password et, si nécessaire, le Enable Password.
6. Cliquez sur Save. Le CUBE apparaît dans la liste avec Name, IP Address, Username, SSH Port et la colonne Debug.
7. Cliquez sur Open Ports ou sur la ligne. La page de détail s'ouvre avec l'onglet Network.
8. Cliquez sur Test Connection. Le résultat apparaît sous l'en-tête.

Pas à pas : contrôler et commuter les voice ports

1. Ouvrez Gateways → Analog GWs et cliquez sur Ports sur la passerelle. Le bouton apparaît dès qu'une adresse IP est connue ou que la passerelle possède sa propre entrée.
2. La page de détail ouvre l'onglet Voice Ports. Le tableau affiche Port, Signaling, Admin, Operational, Status et Active Call.
3. Cliquez sur Show Config pour un port. EasyUC lit la configuration en cours du voice port et affiche en dessous Associated dial-peer(s).
4. Cliquez sur Shutdown pour désactiver administrativement un port, ou sur Bring Up pour le réactiver.
5. Cliquez sur Refresh pour relire la liste des ports.

Pas à pas : créer un config set et l'appliquer à un port

1. Ouvrez la page de détail d'une passerelle analogique et l'onglet Voice Ports.
2. Cliquez sur Config Sets, puis sur Add config set.
3. Attribuez un Name.
4. Sous Voice-Port commands, saisissez les commandes IOS pour le voice port. Utilisez {PORT} comme espace réservé pour le port.
5. Sous Dial-Peer commands, saisissez les commandes pour le dial peer. Vos propres espaces réservés tels que {DIALPEER} ou {DN} sont autorisés.
6. Décidez du Replace mode. Pour un nouveau jeu, il est activé.
7. Cliquez sur Save sur le jeu.
8. Sur le port cible, cliquez sur Apply Config et sélectionnez le jeu.
9. Renseignez les variables demandées. Dans la mesure du possible, EasyUC les préremplit à partir de la configuration actuelle du port. {PORT} est défini automatiquement.
10. Cliquez sur Apply. EasyUC exécute les commandes sur la passerelle et affiche la sortie sous Applied.
11. Cliquez à nouveau sur Show Config et comparez le résultat.

Pas à pas : contrôler le réseau, les certificats et les appels actifs

1. Ouvrez la page de détail d'une passerelle analogique ou d'un CUBE.
2. Sélectionnez l'onglet Network. Sous Interfaces, vous trouvez Interface, IP Address, Status et Protocol. En dessous, System / Version affiche la sortie de version de l'équipement.
3. Sélectionnez l'onglet Certificates. Pour chaque certificat, vous voyez Subject, Issuer, Serial, Valid from et Valid until. Raw CLI output affiche la sortie non modifiée.
4. Sélectionnez l'onglet Active Calls. Le tableau affiche Call-ID, Direction, Number, Codec, Duration et Remote IP.
5. Pour déconnecter un appel, cliquez sur End Call et confirmez la demande. L'appel est déconnecté immédiatement.
6. Dans la liste Analog GWs, un clic sur la cellule Active Calls met à jour le nombre pour cette passerelle.

Pas à pas : définir le stockage et syslog pour la capture de débogage du CUBE

1. Ouvrez Gateways → CUBEs et cliquez sur Storage & syslog. Le paramètre s'applique à la capture de débogage de tous les CUBE.
2. Sous Syslog targets (IP addresses of EasyUC), saisissez une adresse IPv4 par ligne à laquelle les CUBE atteignent l'appliance. La première s'applique aux CUBE sans cible propre.
3. Vérifiez le Syslog port (UDP). Il s'agit du port de réception d'EasyUC et du port de destination sur le CUBE, et il doit correspondre au port ouvert dans le cluster.
4. Définissez le Storage cap (MB). Lorsqu'il est atteint, le récepteur se met en pause. Rien n'est supprimé automatiquement.
5. Vérifiez Maximum lines per second per CUBE et décidez pour Do not store SIP OPTIONS (keepalives).
6. Cliquez sur Save. Si vous modifiez les cibles ou le port alors que des CUBE sont activés, EasyUC nomme les CUBE concernés avec les commandes. L'enregistrement n'a lieu qu'après votre confirmation.

Pas à pas : activer et évaluer la capture de débogage sur un CUBE

1. Ouvrez Gateways → CUBEs et cliquez sur Debug capture sur le CUBE. Sinon, ouvrez l'onglet Debug sur la page de détail et cliquez sur Settings.
2. Cliquez sur Preflight check. EasyUC lit le CUBE uniquement avec des commandes show et évalue les identifiants, l'accessibilité, le niveau de privilège, la journalisation, le CPU, la mémoire, l'horloge et la cible syslog. Un élément marqué Blocked empêche l'activation.
3. Activez Debug capture.
4. Vérifiez la sélection sous Debugs. Les deux débogages sont la valeur par défaut. Au moins un doit être sélectionné.
5. Sélectionnez la Retention : 1 day, 7 days, 30 days ou Unlimited.
6. Laissez Apply logging baseline actif si EasyUC doit définir lui-même les horodatages, les numéros de séquence, « no logging console », la cible syslog et « logging trap debugging ».
7. Si nécessaire, saisissez une Syslog target (IP address of EasyUC) distincte. Si elle est vide, la cible globale s'applique.
8. Lisez l'encadré Please read before switching on et l'aperçu des commandes EasyUC runs these commands:. Cochez la case I have read the effects. EasyUC may run the commands shown on the CUBE.
9. Cliquez sur Save. Sous Steps run, vous voyez quelles commandes ont réussi. EasyUC n'exécute pas « write memory ».
10. Sur la page de détail, ouvrez l'onglet Debug. Check live interroge l'état sur le CUBE. Les groupes Debugs, Logging, CUBE, Receiver et Storage affichent l'état.
11. Ouvrez l'onglet Capture. Sélectionnez la période, recherchez un numéro de téléphone ou un Call-ID et ouvrez un appel. La page Captured call affiche SIP ladder et Records. Raw text exporte les enregistrements expurgés.
12. Après le dépannage, désactivez à nouveau la capture dans les Settings. En cas d'urgence, cliquez sur Emergency stop dans l'onglet Debug et confirmez avec Pull emergency stop.

Champs et options

Vérifier le résultat et résoudre les problèmes

• Succès pour l'accès SSH : Test ou Test Connection renvoie un résultat sans erreur et les onglets de la page de détail se remplissent.
• « No VG gateways found in this CUCM. » : la connexion CUCM active ne contient aucune passerelle VG. Vérifiez la connexion sélectionnée.
• « No gateways configured yet. » : aucun CUBE n'a encore été saisi sous CUBEs.
• Le bouton Ports est absent ou grisé : aucune adresse IP n'est connue pour la passerelle ou elle n'a pas encore d'entrée propre. Un utilisateur disposant des deux droits de modification sur les passerelles doit créer l'entrée via Credentials.
• La colonne Active Calls affiche un signe d'avertissement : la requête a échoué. L'info-bulle en indique la raison ou « Query failed ». Cela ne dit rien de l'état de l'équipement.
• « No ports found. » ou « No dial-peer references this port. » : la passerelle ne signale aucun voice port, ou le port n'est inscrit dans aucun dial peer.
• « No saved config sets yet – create one under “Config Sets” above. » : enregistrez d'abord un jeu.
• Les identifiants par défaut concernent toutes les passerelles sans identifiants propres. Une modification n'affecte jamais un seul équipement.
• « The preflight check blocks switching on – nothing was changed on the CUBE. » : corrigez les éléments bloquants du contrôle préalable, par exemple « logging console » réglé sur debugging ou une cible syslog manquante.
• « No syslog target – please enter one. » : saisissez une adresse sous Storage & syslog ou sur le CUBE.
• « The CUBE cannot be reached via SSH. » ou « No credentials for the CUBE. » : vérifiez l'adresse, le port SSH et les identifiants.
• « The storage cap is reached: the receiver is paused, new lines are discarded. » : raccourcissez la durée de conservation ou augmentez la limite sous Storage & syslog.
• « Switched off automatically at … » avec une raison, par exemple « CPU load too high » : le watchdog s'est désactivé. Élucidez la cause et réactivez après un nouveau contrôle préalable.
• Après la suppression d'un CUBE avec une capture en cours, une remarque peut indiquer que les débogages sur l'équipement n'ont pas pu être arrêtés complètement. Dans ce cas, vérifiez manuellement « show debugging » et la configuration de journalisation sur le CUBE.
• Toute la sortie de débogage, numéros de téléphone compris, est enregistrée. Les en-têtes d'autorisation et les clés SRTP sont expurgés avant l'enregistrement.