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

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

Il existe deux types de connecteurs :

• Connecteur de gestion

• Connecteur de télémétrie

Un script TCL interactif piloté par un menu aide à configurer le GuestShell, ainsi qu'à l'installation et à la maintenance du connecteur de gestion.

Le connecteur de gestion s'occupe de l'inscription de la passerelle et de 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 montre comment les différents composants se connectent dans une solution Webex Calling :

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

• Interface externe

• Adresses du serveur DNS

• Informations sur le proxy

• Adresse IP du connecteur

• Informations d'authentification 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 l'interface utilisateur.

• Coquille d’or

• Yang NETCONF

• Configuration SNMP Trap : nécessaire pour les notifications de Cisco IOS XE.

• Route IP : pour acheminer le trafic lié au connecteur par le biais d'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, considérez que l'application du connecteur ne peut pas être utilisée avec les éléments suivants :

• Plateformes de routeur de services intégrés Cisco 1100
• Plateformes configurées en mode haute disponibilité (HD)
• Plates-formes 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 connecteur :

• IOS XE utilise le proxy ARP pour acheminer le trafic vers l’interface utilisateur. Ne configurez pas aucune comand IP proxy-arp pour désactiver cette fonction.

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

Préparez votre périphérique pour l’inscription d’une passerelle :

• Accéder au Control Hub en tant qu’administrateur d’organisation

• Adresse IP, nom d'utilisateur et mot de passe des périphériques que vous souhaitez configurer.

• Version Cisco IOS XE :

  • Passerelles locales—Cisco IOS XE Bengaluru 17.6.1a ou version ultérieure

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

  Pour les versions recommandées, voir Recherche de logiciels Cisco. Recherchez la plateforme et sélectionnez l’une des versions suggérées .

• Prérequis système

  • Mémoire libre minimale : 256 Mo

  • Espace disque minimum : le disque dur (SSD) attaché à la passerelle qui est utilisée pour l'installation du connecteur doit avoir 2000 Mo d'espace libre. De plus, bootflash doit avoir 50 Mo d'espace libre. Il est utilisé pour stocker les journaux et les fichiers RPM.

    Si un disque dur n'est pas attaché à la passerelle, bootflash est utilisé pour l'installation du connecteur. Ensuite, bootflash doit avoir 2000 Mo d'espace libre.

Si le bootflash de votre routeur est de 4 Go et qu'il y a moins de 2 Go de capacité disponible (la capacité minimale), supprimez toutes les images binaires IOS (.bin) à l'exception de celle qui est en cours d'exécution. Après avoir supprimé les fichiers, libérer de l'espace supplémentaire.

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

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

2. Agrandir l’image binaire IOS en utilisant request platform software package expand file bootflash:/.bin to bootflash:/image.

3. En mode de configuration, supprimez les options de démarrage actuelles en utilisant 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é, utilisez show version pour vérifier que le routeur a démarré à partir de bootflash:/image/packages.conf. Dans l’affirmative :

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

   2. Supprimer l'image binaire IOS restante.

   3. Supprimer toutes les images principales en utilisant delete /f /r bootflash:/core/*.

   4. Supprimer les fichiers journaux de suivi en utilisant delete /f /r bootflash:/tracelogs/*.

   5. S'il n'y a toujours pas assez d'espace disque, vérifiez les fichiers restants dans bootflash : et supprimez tous les autres fichiers non essentiels tels que les journaux et les CDR.

• Un routeur Cisco pris en charge, qui est connecté à un réseau avec un chemin vers Internet. La configuration de base doit comporter les éléments suivants :

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

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

  • Informations d'identification de la passerelle : Un identifiant local (nom d'utilisateur et mot de passe) avec accès au 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, vérifiez que les listes aaa par défaut sont configurées comme illustré dans l’exemple. Vous ne pouvez pas utiliser une liste aaa nommée pour contrôler l’accès NETCONF. Si les listes par défaut ne sont pas correctement configurées, vous pouvez voir un message d'erreur « liste de méthodes non valides » dans le journal du système. Vous pouvez utiliser d'autres méthodes en même temps que local pour AAA, cela peut être effectué, cependant, une mise à jour de la configuration spécifique sera nécessaire.

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

  Prérequis pour le réseau

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

    Si vous utilisez Virtual CUBE sur Amazon Web Services (AWS) comme votre passerelle locale, consultez Associer une adresse IP secondaire pour Virtual CUBE sur AWS pour savoir comment associer une adresse IP secondaire pour l’utilisation du connecteur.

  • être connecté au Control Hub et aux périphériques sur site pour terminer le processus d’inscription.

  • URL pour les services Webex :

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocoles de transport : Transport Layer Security (TLS) version 1.2

  • Importez l'ensemble des autorités de certification publiques IOS. Les certificats ajoutés au pool de confiance de la passerelle sont utilisés pour vérifier l’accès aux serveurs Webex. Utilisez la commande de configuration suivante pour importer l’ensemble.

    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: 

Le statut global du connecteur affiché dans le concentrateur de contrôle 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 Control Hub	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 qu'il est mis en pause temporairement.

Administration locale du connecteur de gestion

Vous pouvez utiliser Webex Calling avec votre passerelle après avoir installé le connecteur 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 Script :

Vous pouvez relancer le script à tout moment à l'aide de 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:

Statut d’affichage

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

===============================================================
                 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 du Cloud en utilisant l’option de menu e: Enable Guestshell . Ceci modifie le statut du connecteur de INACTIVE à ACTIVE.

Désactiver Guestshell

Désactivez le connecteur du Cloud en utilisant l’option de menu d: Disable Guestshell . Ceci modifie le statut du connecteur de ACTIVE à INACTIVE.

Désinstaller le connecteur

Désinstallez le connecteur cloud en utilisant l’option de menu u: Uninstall Connector . Cette action supprime toutes les données contenues dans le conteneur Guestshell et supprime toutes les configurations liées au connecteur du Cloud.

Collecter les journaux

Collectez 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 la collecte des journaux.

Si vous avez un cas d'assistance actif avec le CAT 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

Effacez tous les fichiers journaux du périphérique à l'aide de l'option de menu r: Clear Logs . Cette action supprime tous les journaux existants, à l'exception des derniers journaux du script TCL et des connecteurs.

Afficher et modifier les paramètres du connecteur du Cloud

Effectuez les modifications suivantes aux paramètres existants d'un connecteur sur le 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

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

Mise à jour des informations sur le proxy

Vous pouvez effectuer les tâches suivantes à l'aide de 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

Mettre à jour la clé de vérification du pack du connecteur

Dans le cas d’un problème technique si l’ingénieur d’assistance demande de remplacer votre clé de vérification du pack, téléchargez le nouveau gateway-webex-connectors.gpg fichier dans bootflash:/gateway_connector/ et utilisez l’option de menu k: Update Connector Package Verification Key pour vérifier.

Modifier le niveau de journalisation pour le connecteur de gestion

Modifiez le niveau de journalisation du connecteur en utilisant 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. Allez dans SERVICES, cliquez sur Appel, puis cliquez sur Passerelles gérées.

3. Pour l’instance de passerelle applicable, cliquez sur dans la colonne Actions et sélectionnez l’action applicable.