L'inscription de vos passerelles Cisco IOS au Control Hub vous aide à simplifier la gestion des périphériques et vous permet d'accéder aux nouveaux services d'appel Webex. Les passerelles étant connectées au Control Hub, vous pouvez les gérer et les surveiller depuis n'importe où, ainsi que vos autres appareils Webex Calling. Pour inscrire une passerelle, vous devez installer une application de connecteur de gestion et vous assurer qu'il existe une connexion sécurisée avec le cloud Cisco Webex. Une fois cette connexion établie, vous pouvez enregistrer la passerelle en vous connectant au Centre de contrôle.

Ce processus ne s'applique pas aux passerelles vocales Cisco IOS, telles que la VG400, qui sont entièrement gérées comme des périphériques dans le Control Hub.

Une petite application de connexion, appelée GuestShell, est chargée d'établir et de maintenir une connexion entre la passerelle et le Control Hub. Les applications GuestShell et de connexion sont configurées et paramétrées à l'aide d'un script exécuté sur la passerelle depuis le cloud Webex lors du processus d'inscription.

Pour simplifier le processus d'installation, le script ajoute un certain nombre de configurations de passerelle nécessaires.

Les connecteurs de passerelle sont de petites applications qui s'exécutent dans l'interface GuestShell de la passerelle pour maintenir une connexion avec le Control Hub, coordonner les événements et collecter les informations d'état. Pour plus d'informations sur GuestShell, voir GuestShell.

Les connecteurs de passerelle sont installés sur le conteneur Cisco IOS XE GuestShell.

Il existe deux types de connecteurs :

• Connecteur de gestion

• connecteur de télémétrie

Un script TCL interactif piloté par menus permet de configurer GuestShell, ainsi que d'installer et de maintenir le connecteur de gestion.

Le connecteur de gestion prend en charge l'inscription de la passerelle et la gestion du cycle de vie du connecteur de télémétrie.

Une fois l'inscription terminée avec succès, le connecteur de gestion télécharge et installe le dernier connecteur de télémétrie.

Le graphique suivant illustre comment les différents composants se connectent dans une solution d'appel Webex :

Dans le cadre de l'exécution d'un script TCL, les informations suivantes sont collectées auprès de l'utilisateur :

• interface externe

• adresses de serveur DNS

• Détails du proxy

• Adresse IP du connecteur

• Identifiants de la passerelle (nom d'utilisateur et mot de passe)

Le script TCL effectue les configurations suivantes :

• Groupe de ports virtuels — Requis pour la configuration de guestshell.

• Coquille d'invité

• NETCONF Yang

• Configuration des traps SNMP — Requise pour les notifications de Cisco IOS XE.

• Route IP — Pour acheminer le trafic lié au connecteur via un groupe de ports virtuels.

Le script TCL effectue les configurations suivantes :

!
interface VirtualPortGroup 0
 ip unnumbered GigabitEthernet1
 no mop enabled
 no mop sysid
!

!
app-hosting appid guestshell
 app-vnic gateway0 virtualportgroup 0 guest-interface 0
  guest-ipaddress 10.65.125.227 netmask 255.255.255.128
 app-default-gateway 10.65.125.142 guest-interface 0
 app-resource profile custom
  cpu 800
  memory 256
  persist-disk 500
 name-server0 72.163.128.140
 name-server1 8.8.8.8
!

!
netconf-yang
netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.4.1.9.9.41.2.0.1
netconf-yang cisco-ia snmp-community-string Gateway-Webex-Cloud
!

!
logging snmp-trap emergencies
logging snmp-trap alerts
logging snmp-trap critical
logging snmp-trap errors
logging snmp-trap warnings
logging snmp-trap notifications
!

!
snmp-server community Gateway-Webex-Cloud RO
snmp-server enable traps syslog
snmp-server manager
!

!
ip route 10.65.125.227 255.255.255.255 VirtualPortGroup0
!
 

Avant l'installation, veuillez noter que l'application de connexion ne peut pas être utilisée avec les éléments suivants :

• Plateformes de routeurs de services intégrés Cisco 1100
• Plateformes configurées en mode haute disponibilité (HA)
• Plateformes configurées en mode contrôleur pour les réseaux SD-WAN

Tenez compte des points suivants lors de la configuration de votre routeur pour une utilisation avec une application de connexion :

• IOS XE utilise un proxy ARP pour acheminer le trafic vers le shell invité. Ne configurez pas la commande no ip proxy-arp pour désactiver cette fonctionnalité.

• N’utilisez pas la traduction d’adresses réseau (NAT) sur les plateformes configurées pour un Cisco Unified Border Element (CUBE). Par conséquent, configurez l'application de connexion avec une adresse IP routable. Autrement dit, il ne peut pas partager l'adresse de l'interface du routeur.

Préparez votre appareil pour l'inscription à une passerelle :

• Accès au Centre de contrôle en tant qu'administrateur de l'organisation

• Adresse IP, nom d'utilisateur et mot de passe des appareils que vous souhaitez configurer.

• Version Cisco IOS XE :

  • Passerelles locales : Cisco IOS XE Bengaluru 17.12.3 ou version ultérieure

  • Passerelles de résilience — Cisco IOS XE Dublin 17.12.3 ou version ultérieure

  Pour connaître les versions recommandées, consultez Cisco Software Research. Recherchez la plateforme et sélectionnez l'une des versions suggérées.

• Configuration système requise

  • Mémoire libre minimale : 256 Mo

  • Espace disque minimum — Le disque dur (SSD) connecté à la passerelle utilisée pour l’installation du connecteur doit disposer de 2 000 Mo d’espace libre. De plus, la mémoire flash de démarrage doit disposer de 50 Mo d'espace libre. Il sert à stocker les journaux et les fichiers RPM.

    Si aucun disque dur n'est connecté à la passerelle, la mémoire flash de démarrage est utilisée pour l'installation du connecteur. Ensuite, la mémoire flash de démarrage doit disposer de 2000 Mo d'espace libre.

Si la mémoire flash de démarrage de votre routeur fait 4 Go et qu'il reste moins de 2 Go de capacité disponible (la capacité minimale), supprimez toutes les images binaires IOS (.bin) à l'exception de celle qui est actuellement en cours d'exécution. Après avoir supprimé les fichiers, libérez de l'espace supplémentaire.

Utilisez les étapes suivantes pour développer l'image binaire et démarrer à partir des composants :

1. Créez un nouveau répertoire en utilisant.mkdir bootflash:/image

2. Développez l'image binaire iOS en utilisant.request platform software package expand file bootflash:/.bin to bootflash:/image

3. En mode configuration, supprimez les options de démarrage actuelles à l'aide de :no boot system

4. Configurer une nouvelle instruction de démarrage : boot system bootflash:/image/packages.conf.

5. Quittez le mode de configuration, enregistrez la configuration et redémarrez.

6. Une fois le routeur redémarré, utilisezshow version pour vérifier que le routeur a démarré à partir de bootflash:/image/packages.conf. Le cas échéant:

   1. Vérifiez que le répertoire bootflash:/sysboot est vide.

   2. Supprimez l'image binaire iOS restante.

   3. Supprimez toutes les images principales à l'aide de :delete /f /r bootflash:/core/*

   4. Supprimer les fichiers journaux de suivi à l'aide de.delete /f /r bootflash:/tracelogs/*

   5. Si l'espace disque est toujours insuffisant, vérifiez les fichiers restants dans la mémoire flash de démarrage : et supprimez tous les autres fichiers non essentiels tels que les journaux et les CDR.

• Un routeur Cisco compatible, connecté à un réseau ayant accès à Internet. La configuration de base doit comporter les éléments suivants :

  • Le serveur DNS est configuré pour résoudre les noms de domaine publics.

  • Pour configurer le serveur DNS, utilisez la commande suivante :

    • serveur de noms IP <IP address>

  • Serveur proxy HTTP si vous souhaitez accéder à Internet via un proxy.

  • Identifiants de passerelle : Un identifiant local (nom d'utilisateur et mot de passe) avec un niveau de privilège 15 est requis par le connecteur pour accéder à la passerelle via son interface NETCONF.

    Pour authentifier et autoriser l'accès NETCONF, assurez-vous que les listes aaa par défaut sont configurées comme illustré dans l'exemple suivant. Seules les commandes listées dans ce document ont été validées et sont prises en charge pour les passerelles gérées. Les configurations utilisant d'autres méthodes (par exemple TACACS ou ISE) n'ont pas été validées et ne sont actuellement pas prises en charge.

    
    aaa new-model
    aaa authentication login default local
    aaa authorization exec default local if-authenticated
    username test privilege 15 secret 
    

  Prérequis réseau

  • L'adresse IP du connecteur doit appartenir au même réseau que celui choisi pour la connectivité externe. Il peut s'agir d'une adresse de réseau privé, mais elle doit avoir un accès HTTPS à Internet.

    Si vous utilisez Virtual CUBE sur Amazon Web Services (AWS) comme passerelle locale, reportez-vous à Associer une adresse IP secondaire pour Virtual CUBE sur AWS pour connaître les étapes à suivre pour associer une adresse IP secondaire à l'utilisation du connecteur.

  • Connectez-vous au Control Hub et aux appareils sur site pour terminer le processus d'inscription.

  • URL des services Webex :

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocoles de transport : Sécurité de la couche transport (TLS) version 1.2

  • Importez le bundle d'autorité de certification publique iOS. Les certificats ajoutés au pool de confiance de la passerelle servent à vérifier l'accès aux serveurs Webex. Utilisez la commande de configuration suivante pour importer le bundle.

    crypto pki trustpool import url https://www.cisco.com/security/pki/trs/ios.p7b

 ===============================================================
             Webex Gateway Connector Installation
 ===============================================================


 Choose the external-interface from the below list of available interfaces:
 ===============================================================
   Number          Interface          IP-Address        Status
 ===============================================================
     1          GigabitEthernet1      10.65.125.142       up    
 ===============================================================

 Enter a number to choose the external interface: 1

These DNS settings were detected in the gateway configuration:
 72.163.128.140 
Do you want to use these settings for the connector? [Y/n]: 

These DNS settings were detected in the gateway configuration:
72.163.128.140
Do you want to use these settings for the connector? [Y/n]: n

These proxy settings were detected in the gateway configuration:
 Proxy Server : proxy-wsa.esl.cisco.com
 Proxy Port   : 80
Do you want to use these settings for the connector? [Y/n]: 

SNMP Traps for syslog messages are
configured at  level and they would be changed to 
level in order to push notifications to the Webex Cloud.
Please confirm if it is ok to proceed?:  [Y/n]: 

 Enter Connector IP address: 10.65.125.227

Enter Gateway username: lab
Enter Gateway password: ***
Confirm Gateway password: ***

===============================================================
                 Webex Managed Gateway Connector
===============================================================

  *** Cloud connector is installed successfully. ***
-------------------------------------------------------
         *** Interface Status ***
-------------------------------------------------------
   Interface               IP-Address          Status
-------------------------------------------------------
   GigabitEthernet1        10.65.125.142       up    
   VirtualPortGroup0       10.65.125.142       up    
   Connector               10.65.125.188       up
   
-------------------------------------------------------

          *** App Status ***
-------------------------------------------------------
 Service                 Status
-------------------------------------------------------
 Guestshell              RUNNING
 Management Connector    RUNNING
-------------------------------------------------------

===============================================================
 Select option h for home menu or q to quit: 

L'état global du connecteur affiché dans le Control Hub dépend de l'état des connecteurs de télémétrie et de gestion sur la passerelle gérée.

États des connecteurs dans le centre de contrôle	Description
En ligne	Indique que le connecteur est Connecté au cloud Cisco Webex.
Hors-ligne	Indique que le connecteur n'est pas connecté au cloud Cisco Webex.
Interrompu	Indique que le connecteur est connecté mais est en pause temporairement.

Administration locale du connecteur de gestion

Vous pourrez utiliser Webex Calling avec votre passerelle une fois le connecteur installé avec succès. Si nécessaire, vous pouvez mettre à jour un certain nombre de paramètres du connecteur à l'aide des options disponibles dans le menu du script :

Vous pouvez relancer le script à tout moment en utilisant la commande suivante : tclsh bootflash:/gateway_connector/gateway_onboarding.tcl.

===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
q : Quit
===============================================================
Select an option from the menu:

Afficher l'état

Utilisez l'option de menu s: Display Status Page. Le système affiche l'état des différents modules de connecteurs.

===============================================================
                 Webex Managed Gateway Connector
===============================================================
     -------------------------------------------------------
                     *** Interface Status ***
     -------------------------------------------------------
       Interface               IP-Address          Status
     -------------------------------------------------------
       GigabitEthernet1        10.123.221.224        up    
       Connector               10.123.221.223        up
     -------------------------------------------------------
                       *** App Status ***
     -------------------------------------------------------
		Service                   Status
     -------------------------------------------------------
            Guestshell                  RUNNING
            Management Connector        RUNNING
     -------------------------------------------------------
===============================================================
          Select option h for home menu or q to quit: q 

Activer Guestshell

Activez le connecteur cloud à l'aide de l'option de menu e: Enable Guestshell. Cela modifie l'état du connecteur de INACTIVE à ACTIVE.

Désactiver Guestshell

Désactivez le connecteur cloud à l'aide de l'option de menu d: Disable Guestshell. Cela modifie l'état du connecteur de ACTIVE à INACTIVE.

Désinstaller le connecteur

Désinstallez le connecteur cloud à l'aide de l'option de menu u: Uninstall Connector. Cette opération supprime toutes les données du conteneur Guestshell et toutes les configurations liées au connecteur cloud.

Collecter les journaux

Récupérez les journaux à l'aide de l'option de menu l: Collect Logs. Le système affiche l'emplacement où ces journaux sont stockés après leur collecte.

Si vous avez un dossier de support actif auprès du TAC de Cisco, vous pouvez joindre les journaux directement à votre demande de service en utilisant la commande copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

Voici un exemple de commande :

vcubeprod#copy bootflash:/guest-share/gateway_webex_cloud_logs_2022114090628.tar.gz scp://123456789:a1b2c3d4e5@cxd.cisco.com

Effacer les journaux

Effacer tous les fichiers journaux de l'appareil à l'aide de l'option de menu r: Clear Logs. Cette opération supprime tous les journaux existants, à l'exception des journaux les plus récents du script TCL et des connecteurs.

Afficher et modifier les paramètres du connecteur cloud

Apportez les modifications suivantes aux paramètres existants d'un connecteur cloud en utilisant l'option de menu v: View and Modify Cloud Connector Settings.

===============================================================
                Webex Managed Gateway Connector
===============================================================
		Script Version         : 2.0.2
		Hostname/IP Addr       : 10.65.125.188
		DNS Server(s)          : 10.64.86.70
		Gateway Username       : lab
		External Interface     : GigabitEthernet1
		Proxy Hostname/IP Addr : proxy-wsa.esl.cisco.com:80
===============================================================
             Options
               c :  Update Gateway Credentials
               e :  Update External Interface
               p :  Update Proxy Details
               n :  Update DNS Server
               k :  Update Connector Package Verification Key
               l :  Modify log level for Cloud Connector
               h :  Go to home menu
               q :  Quit

===============================================================
                        Select an option from the menu: c

Mettre à jour les informations d'identification de la passerelle

Mettez à jour le nom d'utilisateur et le mot de passe de la passerelle à l'aide de l'option de menu c: Update Gateway Credentials.

Mise à jour de l'interface externe

Modifiez l'interface à laquelle le connecteur est lié et l'adresse IP du connecteur à l'aide de l'option de menu v: View and Modify Cloud Connector Settings.

Mise à jour des informations du proxy

Vous pouvez effectuer les tâches suivantes en utilisant l'option de menu p: Update Proxy Details  :

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Clé de vérification du package de connecteur de mise à jour

En cas de problème technique, si l'ingénieur de support demande à remplacer votre clé de vérification de package, téléchargez le nouveau fichier gateway-webex-connectors.gpg à bootflash:/gateway_connector/ et utilisez l'option de menu k: Update Connector Package Verification Key pour vérifier.

Modifier le niveau de journalisation du connecteur de gestion

Modifiez le niveau de journalisation du connecteur à l'aide de l'option de menu l: Modify log level for Cloud Connector puis sélectionnez l'une des options suivantes :

=====================================
  Number      Log Level 
=====================================
   1           DEBUG 
   2           INFO 
   3           WARNING 
   4           ERROR 
   5           CRITICAL 
======================================

Pour gérer votre instance de passerelle :

1. Connectez-vous au Control Hub.

2. Aller à Services > PSTN & Routage > Configurations de la passerelle > Gérer les passerelles

3. Pour l'instance de passerelle concernée, cliquez sur et sélectionnez l'action appropriée.