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 non numérotée GigabitEthernet1 pas de mop activé pas de 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 personnalisé cpu 800 mémoire 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 ! ! journalisation des urgences snmp-trap journalisation des alertes snmp-trap journalisation des erreurs snmp-trap journalisation des avertissements snmp-trap journalisation des notifications snmp-trap ! ! snmp-server community Gateway-Webex-Cloud RO snmp-server enable traps syslog snmp-server manager ! ! route ip 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éez un nouveau répertoire en utilisant mkdir bootflash:/image.

2. Développez l’image binaire IOS en utilisant le package logiciel de la plateforme de demande, développez le fichier bootflash:/.bin vers bootflash:/image.

3. En mode de configuration, supprimez les options de démarrage actuelles en utilisant aucun système de démarrage.

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

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

6. Une fois le routeur redémarré, utilisez Afficher la version pour vérifier que le routeur a démarré à partir de bootflash:/image/packages.conf. Dans l’affirmative :

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

   2. Supprimer l'image binaire IOS restante.

   3. Supprimez toutes les images principales en utilisant supprimer /f /r bootflash:/core/*.

   4. Supprimez les fichiers journaux de suivi en utilisant supprimer /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

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

  • Informations d'identification de la passerelle : Informations d'authentification (nom d'utilisateur et mot de passe) avec accès de niveau de privilège 15 que le connecteur peut utiliser 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 pouvez utiliser n'importe quelle option de méthode dans la liste par défaut. 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.

     aaa nouveau modèle aaa authentification login radius local aaa autorisation exec radius par défaut local si-nom d'utilisateur authentifié test privilège 15 secret <mot de passe> 

  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.

    url d'importation de trustpool crypto pki https://www.cisco.com/security/pki/trs/ios.p7b

 =============================================================== Installation du connecteur de passerelle Webex =============================================================== Choisissez l’interface externe dans la liste ci-dessous des interfaces disponibles : =============================================================== Numéro Interface Statut de l’adresse IP ===============================================================      1 GigabitEthernet1 10.65.125.142 up =============================================================== Entrez un numéro pour choisir l'interface externe : 1 

 Ces paramètres DNS ont été détectés dans la configuration de la passerelle :  72.163.128.140 Voulez-vous utiliser ces paramètres pour le connecteur ? [O/n] : 

 Ces paramètres DNS ont été détectés dans la configuration de la passerelle : 72.163.128.140 Voulez-vous utiliser ces paramètres pour le connecteur ? [O/n] : n 

 Ces paramètres proxy ont été détectés dans la configuration de la passerelle :  Serveur proxy : Port proxy proxy-wsa.esl.cisco.com : 80 Voulez-vous utiliser ces paramètres pour le connecteur ? [O/n] : 

 Les traps SNMP pour les messages syslog sont configurés au niveau  et ils seront modifiés au niveau  afin de diffuser les notifications vers le Cloud Webex. Veuillez confirmer s’il est ok de continuer ? :  [O/n] : 

 Saisissez l’adresse IP du connecteur : 10.65.125.227 

 Saisissez le nom d'utilisateur de la passerelle : labo Saisissez le mot de passe de la passerelle : *** Confirmez le mot de passe de la passerelle : ***

 =============================================================== Connecteur de passerelle géré Webex =============================================================== *** Connecteur du Cloud est installé avec succès. *** ------------------------------------------------------- *** Statut de l’interface *** ------------------------------------------------------- Statut de l’adresse IP ------------------------------------------------------- GigabitEthernet1 10.65.125.142 up VirtualPortGroup0 10.65.125.142 up Connecteur 10.65.125.188 up ------------------------------------------------------- *** Statut de l’application *** ------------------------------------------------------- Statut du service ------------------------------------------------------- Guestshell RUNNING Management Connector RUNNING ------------------------------------------------------- =============================================================== Sélectionnez l’option h pour le menu d’accueil ou q pour quitter : 

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.

 =============================================================== Connecteur de passerelle gérée Webex =============================================================== Options s : Afficher la page de statut v : Afficher et modifier les paramètres du connecteur du Cloud e : Activer Guestshell d : Désactiver Guestshell l : Collecter les journaux r : Effacer les journaux u : Désinstaller le connecteur q : Quitter =============================================================== Sélectionnez une option dans le menu :

Statut d’affichage

Utiliser les : Option de menu Afficher la page du statut . Le système affiche l'état des différents modules de connecteur.

 =============================================================== Connecteur de passerelle géré par Webex =============================================================== ------------------------------------------------------- *** Statut de l’interface *** ------------------------------------------------------- Statut de l’adresse IP de l’interface ------------------------------------------------------- GigabitEthernet1 10.123.221.224 up Connecteur 10.123.221.223 up ------------------------------------------------------- *** Statut de l’application *** ------------------------------------------------------- Statut du service ------------------------------------------------------- Guestshell RUNNING Management Connector RUNNING ------------------------------------------------------- =============================================================== Sélectionnez l’option h pour le menu d’accueil ou q pour quitter : q 

Activer Guestshell

Activez le connecteur du Cloud en utilisant le e : Activer l'option de menu Guestshell . Ceci modifie le statut du connecteur de INACTIF à ACTIF.

Désactiver Guestshell

Désactiver le connecteur du Cloud en utilisant le d : Désactiver l'option du menu Guestshell . Ceci modifie le statut du connecteur de ACTIF à INACTIF.

Désinstaller le connecteur

Désinstallez le connecteur du Cloud en utilisant le u : option du menu Désinstaller le connecteur . 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 en utilisant le l : option de menu Collecter les journaux . Le système affiche l'emplacement où ces journaux sont stockés après la collecte des journaux.

Si vous avez un dossier d’assistance actif auprès du centre d’assistance technique Cisco, vous pouvez joindre les journaux directement à votre demande de service en utilisant la commande copier 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 du périphérique en utilisant le r : option de menu Effacer les journaux . 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 du Cloud en utilisant le v : Afficher et modifier les paramètres du connecteur du Cloud option du menu.

 =============================================================== Connecteur de passerelle géré par Webex =============================================================== Version du script : 2.0.2 Nom d’hôte/Adresse IP : 10.65.125.188 Serveur(s) DNS : 10.64.86.70 Nom d'utilisateur de la passerelle : Interface externe du labo : Nom d'hôte/adresse IP du proxy GigabitEthernet1 : proxy-wsa.esl.cisco.com:80 =============================================================== Options c :  Mettre à jour les informations d'authentification de la passerelle e :  Mise à jour de l'interface externe p :  Mise à jour des informations sur le proxy n :  Mise à jour du serveur DNS k :  Mettre à jour la clé de vérification du pack du connecteur l :  Modifier le niveau de journalisation pour le connecteur du Cloud h :  Aller au menu d’accueil q :  Quitter =============================================================== Sélectionnez une option dans le menu : c

Mettre à jour les informations d'authentification de la passerelle

Mettez à jour le nom d'utilisateur et le mot de passe de la passerelle en utilisant le c : Option de menu Mettre à jour les informations d'authentification de la passerelle .

Mise à jour de l'interface externe

Changez l'interface à laquelle le connecteur est lié et l'adresse IP du connecteur en utilisant le v : Afficher et modifier les paramètres du connecteur du Cloud option du menu.

Mise à jour des informations sur le proxy

Vous pouvez effectuer les tâches suivantes en utilisant le p : Option de menu Mise à jour des informations sur le proxy :

• i : Mise à jour du port et de l'adresse IP du proxy

• c: Mettre à jour les informations d'identification du proxy

• r : Supprimer les informations d'identification du proxy

• a : Supprimer toutes les informations sur le proxy

• h : Aller au menu d’accueil

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 fichier gateway-webex-connectors.gpg sur bootflash:/gateway_connector/ et utilisez le k : Option du menu Mettre à jour la clé de vérification du pack du connecteur pour vérifier.

Modifier le niveau de journalisation pour le connecteur de gestion

Modifiez le niveau de journalisation du connecteur en utilisant le l : Modifiez le niveau de journalisation pour l'option du menu Connecteur du Cloud , puis sélectionnez l'une des options suivantes :

 Niveau ===================================== du journal des numéros =====================================    1 débogage     2 infos     3 avertissement     4 erreur     5 critiques ====================================== 

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.