Les connecteurs de passerelle sont de petites applications qui s'exécutent dans la passerelle GuestShell pour maintenir une connexion au Control Hub, coordonner les é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 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 menu 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 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 de serveur DNS

• Détails du proxy

• Adresse IP du connecteur

• Informations d'identification 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 du shell invité.

• Coquille d'invité

• NETCONF Yang

• Configuration de trap 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 du connecteur ne peut pas être utilisée avec les éléments suivants :

• Plateformes de routeurs à 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 éléments 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 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 plates-formes 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 appareil pour une inscription à la passerelle :

• Accès au Control Hub en tant qu'administrateur d'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.6.1a ou version ultérieure

  • Passerelles de survie : Cisco IOS XE Dublin 17.12.3 ou version ultérieure

  Pour les versions recommandées, voir Cisco Software Research. 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) connecté à la passerelle utilisé pour l'installation du connecteur doit disposer de 2 000 Mo d'espace libre. De plus, le bootflash doit disposer de 50 Mo d'espace libre. Il est utilisé pour stocker les journaux et les fichiers RPM.

    Si aucun disque dur n'est connecté à la passerelle, le bootflash est utilisé pour l'installation du connecteur. Ensuite, le 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 en cours d'exécution. Après avoir supprimé les fichiers, libérez de l’espace supplémentaire.

Suivez 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 de 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. Supprimez les fichiers journaux de trace à l'aide de.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 avoir 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 un niveau de privilège d'accès 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 répertoriées dans ce document ont été validées et sont prises en charge pour les passerelles gérées. Les configurations impliquant d'autres méthodes (par exemple, TACACS ou ISE) n'ont pas été validées et ne sont pas prises en charge actuellement.

    
    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 être dans le même réseau que celui choisi pour la connectivité externe. Il peut s'agir d'une adresse réseau privée, mais elle doit disposer d'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 de 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 sont utilisés pour 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 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 temporairement en pause.

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 de 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 change 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 change 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. Cela supprime toutes les données du conteneur Guestshell et supprime toutes les configurations liées au connecteur 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 auprès de Cisco TAC, vous pouvez joindre les journaux directement à votre demande de service à l'aide de 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 de l'appareil à l'aide de l'option de menu r: Clear Logs. Cela supprime tous les journaux existants, à l'exception des derniers journaux 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 à l’aide de 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.

Mettre à jour 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.

Mettre à jour les détails du 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 package du connecteur

En cas de problème technique, si l'ingénieur de support demande de remplacer votre clé de vérification de package, téléchargez le nouveau fichier gateway-webex-connectors.gpg sur 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. Accédez à SERVICES, cliquez sur Appels, 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.