Configuration et dépannage de la gestion des licences Expressway Smart

Introduction

Ce document décrit comment configurer Expressway avec Cisco Software Smart Licensing (CSSM).

Conditions préalables

Exigences

Cisco recommande de posséder des connaissances sur ces sujets :

• Expressway et CSSM.

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Cisco Expressway x14.0.1
• Cisco Expressway x14.3.1
• CSSM cloud

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Fond

Cisco Smart Licensing rend la gestion des licences plus flexible et simplifie la gestion dans toute l'entreprise.  Les périphériques qui utilisent Smart Licensing signalent la consommation de licences, ce qui élimine le besoin d'utiliser des clés d'option (clés d'activation de produit). Les droits de licence sont regroupés dans un compte unique qui peut être utilisé sur Expressways ou sur différents clusters d’Expressways. Expressway a commencé à utiliser Cisco Smart Licensing dans la version x12.6.  À cette époque, les déploiements pouvaient utiliser des licences traditionnelles ou des licences Smart. Avec les versions x14.1 et ultérieures, Expressway prend uniquement en charge les licences Smart.  Les mises à niveau à partir de déploiements utilisant des licences traditionnelles vers n'importe quelle version x14.1 ou ultérieure activent automatiquement les licences Smart et démarrent un délai de grâce de 90 jours.  La version x14.2 d’Expressway a introduit les réservations de licences spécifiques (SLR).

Voici quelques-uns des avantages des licences Smart :

• Ajoute de la flexibilité aux licences et les simplifie dans toute l'entreprise.
• Facilité d'approvisionnement, de déploiement et de gestion des licences lorsque les périphériques s'enregistrent automatiquement et signalent la consommation des licences, ce qui élimine le besoin de clés d'activation de produit (PAK).
• utiliser sur site Cisco Smart Software Manager ou Cloud Smart Software Manager pour allouer facilement des licences là où elles sont nécessaires (CSSM).

Types de licences Smart

Il existe 4 types de réservation de licences disponibles pour les licences Smart sur Expressways.  Ils sont utilisés pour créer un pool de licences que chaque Expressway du déploiement peut utiliser.   

• Licence de session multimédia Cisco Expressway (session multimédia)
• Licence UC Manager Enhanced (Desktop/User Device)
• Licence de salle de téléprésence UC Manager (salle de téléprésence)
• Réservation de licence permanente (PLR) (utilisation interne Cisco uniquement)

Ces licences ne sont pas disponibles sur les licences Smart. Par conséquent, si vous les utilisez, les déploiements ne peuvent pas être mis à niveau après 14.0.x

• Sécurité de compte avancée - 116341J00
• Module de sécurité matériel (HSM) - 116341H00
• Interopérabilité Microsoft - 116341 COO

Conversion des licences traditionnelles en licences logicielles Smart

Si vous ne disposez pas encore de licences Smart dans votre compte virtuel, vous pouvez convertir vos licences existantes en licences Smart dans le portail de licences logicielles Smart (https://software.cisco.com). Si vous n'avez pas encore de références admissibles (seules les licences RMS et les licences de périphérique sont éligibles pour les licences Smart), vous devez disposer de votre numéro PAK pour les licences que vous souhaitez convertir et les associer à votre compte Smart avant de les convertir.  Vous devez effectuer cette association dans le Portail d'enregistrement des licences de produits. Si vous ne disposez pas de vos numéros PAK, contactez Cisco Licensing et fournissez-leur votre numéro de commande afin qu'ils puissent vous aider à effectuer la conversion.

1. Accédez à Cisco Software Central > Smart Software Licensing > Convert to Smart Licensing et sélectionnez soit Convert PAKs soit Convert Licenses, selon vos besoins.

Conversion de licence

2. Sélectionnez les licences à convertir (A-FLEX-EXP-RMS, A-FLEX-EXP-DESK, A-FLEX-EXP-ROOM), puis cliquez sur Convertir les licences.

3. Dans le menu contextuel Convertir en licences logicielles Smart :

r : sélectionnez les licences que vous souhaitez convertir, puis cliquez sur suivant

b : vérifiez votre sélection et cliquez sur Convertir les licences

Paramètres de transport

Lors de la configuration de Smart Licensing sur Expressway, les paramètres de transport doivent être configurés dans la page Maintenance > Smart Licensing. Cette section explique à Expressway comment accéder à Smart Licensing.

Paramètres de transport Expressway

Direct : Expressway se connecte à Internet directement au récepteur intelligent.  L’Expressway nécessite un accès HTTPS à Internet pour cette méthode.

Cisco Smart Software Manager On-Prem : Expressway communique avec un serveur satellite qui s’exécute localement sur votre réseau. (Configurez l'URL du serveur satellite avec /SmartTransport à la fin de l'URL satellite).

Serveur proxy : Expressway doit se connecter via un serveur proxy pour accéder à Internet.  Les déploiements qui ne permettent pas aux périphériques d'accéder directement à Internet via HTTPS nécessitent un serveur proxy pour que ce trafic circule.

Ne pas partager mon nom d'hôte ou mon adresse IP avec Cisco : lorsque cette case n'est pas cochée, le nom d'hôte est visible dans la page Licence Smart > Instance de produit.  Cela se produit uniquement lors de l'utilisation de jetons.  Si vous utilisez License Reservation, la page d’instance du produit affiche Expressway et le numéro de série du périphérique.  Dans cet exemple, e1 et e2 sont affichés comme nom, car le déploiement utilise des jetons et la case n'est pas cochée.

Page Product Instance - CSSM

Licences Smart utilisant des jetons

La licence Smart utilisant des jetons était la seule méthode pour se connecter à la licence Smart entre les versions x12.6 et x14.0.11 et nécessitait que l’Expressway puisse atteindre le CSSM (cloud ou sur site) afin d’accéder aux licences disponibles, ou pour mettre à jour l’utilisation de la licence. L’inclusion de licences Smart simplifie la gestion des licences Expressway, ce qui élimine le besoin de licences PAK. Avant x14.1, la licence Smart doit être activée dans Maintenance > Smart Licensing, mais à partir de x14.1, la licence Smart est activée par défaut.

Les jetons permettent à l’Expressway(s) d’accéder à toutes les licences disponibles dans le compte virtuel (VA) sur CSSM.

Configurer 

1. Connectez-vous à software.cisco.com et accédez à l'onglet General dans le compte virtuel et sélectionnez New Token.
2. Complétez l'enregistrement du jeton avec une description, Expire après (nombre de jours pendant lesquels le jeton est valide avant d'être appliqué aux serveurs, en jours) et Max. Nombre d'utilisateurs, puis cliquez sur Créer un jeton.

Création de jeton CSSM

3. Copiez le jeton et sur chaque Expressway dans le déploiement, ouvrez Maintenance > Smart Licensing.  Si vous utilisez Expressway version x12.6 - x14.0.x, vous devez activer manuellement la licence Smart.  Une invite s'affiche indiquant que l'activation de Smart Licensing est irréversible et qu'une réinitialisation en usine est requise si vous souhaitez revenir à l'utilisation de licences traditionnelles.  
4. Collez le jeton dans le champ Registration au bas de la page et cliquez sur Register.

Champ de jeton Expressway

L’utilisation de la licence de déploiement est automatiquement mise à jour toutes les 6 heures d’Expressway vers CSSM, mais si vous souhaitez mettre à jour l’utilisation à tout moment, vous pouvez le faire dans Maintenance Expressway > Smart Licensing, et en sélectionnant Update Usage Details.

Licences Smart avec réservation de licences spécifiques (SLR)

Introduite dans Expressway x14.2, la méthode de licence SLR est nécessaire pour les déploiements à répartition d’air, où Expressway ne peut pas accéder à Internet, mais est adaptée à tout déploiement utilisant le CSSM cloud. Seul le CSSM cloud peut avoir une réservation de licence. Par conséquent, si vous avez un CSSM sur site, vous devez utiliser des jetons de licence Smart ou faire appel à l’équipe de gestion des licences Cisco pour vous aider à créer un nouveau compte virtuel dans votre CSSM cloud qui peut avoir une réservation de licence.  La réservation de licences Smart doit être activée et configurée sur chaque noeud d'un cluster.

Avant de commencer, les déploiements déjà mis en grappe ne doivent pas comporter d'alarmes. Reportez-vous à la documentation de création de cluster de Cisco Expressway pour plus de détails concernant le clustering.

Configurer

Étapes d'activation du reflex :

1. Dans l'interface de ligne de commande, exécutez la commande xconfiguration license Smart reservationEnable : on.
2. Dans CLI, exécutez la commande xcommand license Smart reservation request.
3. Copiez le code de demande de réservation et connectez-vous au compte Smart sur Cisco Software Smart Licensing.
4. Dans le compte virtuel, cliquez sur License Reservation et collez le code de demande de réservation.

Réservation de licence CSSM

5. Sélectionnez le nombre de licences à réserver pour cette demande. 

Réservation de licence CSSM

6. Après avoir vérifié, cliquez sur Generate Authorization Code.

Vérifier et confirmer CSSM

7. Copiez le code d'autorisation ou téléchargez-le en tant que fichier, puis fermez cette fenêtre.

Code d'authentification SLR CSSM

8. Dans l’interface de ligne de commande d’Expressway, entrez la commande xcommand License Smart Reservation Install <jeton d’authentification copié> (le jeton d’authentification SLR DOIT comporter des guillemets en fin et en début). Il n'est pas nécessaire d'entrer le code de confirmation dans CSSM.

Installation du reflex Expressway

Expressway enregistré avec SLR

Renvoi des licences réservées

À un moment donné, vous souhaiterez peut-être ou devrez peut-être renvoyer vos licences réservées. Cela peut être dû à la mise hors service d’une Expressway et à la mise en service d’une autre ou d’une autre raison. Si vous devez mettre à jour la réservation pour ajouter d'autres licences, consultez la section Mise à jour de la licence. Il n'est pas nécessaire de renvoyer la licence et de recommencer pour la mise à jour.

1. Dans l’interface de ligne de commande d’Expressway, exécutez la commande xcommand license Smart reservation return.

2. Copiez le code (si vous le perdez, demandez à Cisco Licensing de supprimer l'instance du produit).

CLI Expressway - Code de retour de licence

3. Dans le compte virtuel sur la licence Smart, allez au menu Product Instances > Actions pour l’Expressway en question, cliquez sur Remove, et entrez le code de retour de réservation copié à partir de CLI.

CSSM - Retour de licence

Mise à jour des licences réservées

Si vous devez ajouter des licences supplémentaires à leur réservation de reflex, vous pouvez le faire en procédant d’abord à la modification dans le CSSM cloud, puis en mettant à jour les Expressways eux-mêmes, et enfin en entrant le code de confirmation d’Expressway dans le CSSM cloud.

1. Dans CSSM, recherchez la réservation Expressway dans Compte virtuel > Instances de produit.

2. Sélectionnez Actions > Mettre à jour les licences de réservation.

Mise à jour d'instance de produit CSSM

3. Sélectionnez Réserver une licence spécifique et saisissez de nouveaux montants.

4. Cliquez sur Next > Generate Authorization Code.

Code d'authentification de génération CSSM

5. Copiez le nouveau code d'autorisation.
6. Laissez cette fenêtre ouverte pour saisir le code de confirmation généré par Expressway, mais si elle est fermée, le code de confirmation peut être saisi ultérieurement.
7. Dans l’interface de ligne de commande d’Expressway, exécutez la commande xcommand license Smart reservation install <auth code> et copiez le code de confirmation.
8. Revenez à CSSM pour saisir le code de confirmation.  La réservation de licence n'est pas terminée tant que cette opération n'est pas effectuée.

CLI Expressway - mise à jour

9. Si la fenêtre de réservation dans CSSM a été fermée, accédez à Product Instances et recherchez l’Expressway. 
10. Sélectionnez Actions > Saisir un code de confirmation et collez le code pour terminer le processus.

Mise à jour d'instance de produit CSSM

Migration des licences PAK (clés d'option) vers les licences Smart

Si le déploiement utilise actuellement des clés d'option mais que vous souhaitez effectuer une mise à niveau vers x14.1 ou version ultérieure, où seul Smart est disponible, ou que vous souhaitez simplement activer Smart maintenant, sauf si vous utilisez un CSSM satellite, la seule option est d'effectuer une mise à niveau vers x14.2.5 ou version ultérieure (x14.0.11 et version ultérieure ont également le correctif).  Cela est dû au fait que Smart Licensing a modifié ses certificats racine en janvier 2023. Référez-vous à l'ID de bogue Cisco CSCwe09378

Si vous essayez d’enregistrer un logiciel Expressway avant la version fixe, l’enregistrement échoue et affiche le message d’erreur suivant :

"Problème de certificat SSL : certificat auto-signé dans la chaîne de certificats"

Si vous utilisez un serveur CSSM satellite, vous pouvez activer Smart Licensing à tout moment, mais assurez-vous que leur compte virtuel contient suffisamment de licences pour couvrir le nombre d'enregistrements et de licences RMS nécessaires.

Une fois Expressways mis à niveau vers X14.1 ou une version plus récente, le serveur fonctionne avec un délai de grâce de 90 jours pour l’obtention de licences, à moins qu’il n’ait été préalablement configuré pour utiliser Smart Licensing.

Dépannage

Problèmes d'enregistrement

1. Si l'enregistrement du point de terminaison échoue, consultez le journal des événements pour voir s'il signale des problèmes de licence.

Journal des événements Expressway - Inscription refusée

2. Autorité de certification inconnue

Problème connu avant x14.2.5, référez-vous à l'ID de bogue Cisco CSCwe09378. Si expressway exécute x14.2.5 ou une version plus récente mais ne parvient toujours pas à se connecter à Smart Licensing dans le cloud en raison d'une CA inconnue, comme indiqué dans la capture de paquets ci-dessous.  Il n’y a aucun moyen d’ajouter une autre autorité de certification à l’approbation Expressway pour Smart Licensing. Le seul correctif est donc de contourner le serveur proxy ou d’ajouter https://smartreceiver.cisco.com/ à la liste blanche sur le proxy Internet.

Capture de paquets Expressway

Détails du paquet de certificats

Mode d'évaluation

Si Expressway n’atteint pas CSSM lors de l’utilisation de jetons, ou si le déploiement a activé Smart Licensing, mais n’est pas configuré (problème courant lors de la mise à niveau de x14.0.x vers x14.1 ou version ultérieure), l’autoroute démarre un compte à rebours de 90 jours. Le déploiement peut fonctionner pendant 90 jours en mode évaluation. Si le déploiement est en cluster, n'essayez pas d'apporter des modifications au cluster après la période de 90 jours. Cela peut entraîner des problèmes irréversibles au niveau de la base de données, ce qui oblige à réinitialiser le noeud en usine.

• L'évaluation ne dure que 90 jours.  Il compte à rebours lorsque le serveur n'est pas enregistré dans le Gestionnaire de licences Smart. Une fois enregistrée, l'horloge s'arrête, mais ne se réinitialise pas. 
• Ne modifiez pas la configuration du cluster lorsque le mode d'évaluation a expiré. Cela peut interrompre le cluster et nécessiter sa reconstruction (réinitialisation en usine, reconstruction).
• Lorsque le mode Evaluation a expiré, le menu Cluster est grisé.
• Xstatus indique combien de jours il reste du mode d'évaluation.

xstatus evaluation mode

Journaux de diagnostic

Pour un dépannage supplémentaire, le débogage peut être activé dans l’Expressway. La journalisation standard capture certains problèmes. Groupe de journaux de diagnostic > loggingsnapshot les lignes pertinentes contiennent l'expression Smartlicense agent.

Les débogages peuvent être activés dans Maintenance > Diagnostics > Advanced > Support Log Configuration

Débogages de configuration du journal de support Expressway

Problèmes identifiés

Défauts

1. "Une erreur logicielle inattendue a été détectée dans smartlicense" et "signal SIGABRT, Aborted". Référez-vous à l'ID de bogue Cisco CSCwh22349

2. "Detail="Erreur de communication de licence Smart : le système n'a pas pu communiquer avec Cisco Smart Software Manager ou Cisco Smart Software Manager On-Prem basé sur le cloud".  Référez-vous à l'ID de bogue Cisco CSCwe09378

Informations connexes

• Assistance technique de Cisco et téléchargements