Chaque échec de license activate sur un commutateur de campus Huawei série S se ramène à l'un de six messages d'erreur précis. Ce que chacun signifie réellement, comment le fichier de licence est structuré en interne, et un cas réel où une incompatibilité d'ESN en pile a discrètement épuisé un essai de 60 jours avant de couper un tunnel VXLAN à l'échelle du réseau.
Par Yuwen Zhang (Atlas), fondateur d'AtlasCommTech — 13 ans de déploiements de réseaux opérateurs et d'entreprise · Mis à jour en juillet 2026
Un license activate en échec n'est pas un mystère — l'équipement vous indique, mot pour mot, laquelle des six causes exactes s'est produite.
Sur un commutateur de campus Huawei série S (S1720, S5700, S6700, S6730, S7700 et le reste de la famille), license activate ne peut échouer que d'un petit nombre de façons précises, et la CLI affiche la raison exacte plutôt qu'une erreur générique. Apprenez ces six messages une bonne fois et vous arrêterez de deviner quoi vérifier ensuite.
Voici la suite : les six messages classés selon ce qui est réellement défaillant, la structure interne du fichier de licence lui-même — qui explique pourquoi une erreur « format invalide » survient même quand l'ESN semble correct — et un cas réel où une licence est restée silencieusement en état Trial pendant 60 jours avant qu'un tunnel VXLAN ne tombe pour toute l'activité.
Trier les six messages selon ce qui ne va pas réellement indique où regarder en premier — le mauvais fichier, un fichier rejeté, ou un fichier qui ne correspond pas à cet équipement ou à ce moment précis.
Les légendes du schéma restent en anglais pour la clarté technique.
Les six messages, mot pour mot, proviennent du même tableau de pannes d'activation de licence du manuel de maintenance des commutateurs de campus Huawei série S.
Les mêmes six erreurs que sur le schéma ci-dessus — voici le texte CLI exact, ce qui se passe réellement, et la correction pour chacune.
| Message d'erreur | Groupe | Signification |
|---|---|---|
| The filename is invalid, and the postfix of the file name must be 'dat'. | Groupe A | Le fichier pointé par activate n'est pas un fichier de licence .dat. |
| The specified file does not exist or is illegal. | Groupe A | Aucun fichier portant exactement ce nom n'existe sur le stockage de l'équipement. |
| License file validation failed. | Groupe B | La signature numérique du fichier ne passe pas la vérification — souvent un transfert corrompu. |
| No product features present in LK. | Groupe B | Les éléments contrôlés de la licence ne correspondent absolument pas à ce produit. |
| License File expired. | Groupe C | La propre fenêtre de validité de la licence est déjà passée. |
| License File with ESN or Version mismatch cannot be activated repetitively. | Groupe C | Une licence avec ESN/version incompatible a déjà été activée une fois et on retente l'activation. |
SYMPTÔMElicense activate <filename> renvoie Error: The filename is invalid, and the postfix of the file name must be 'dat'.
CAUSELe fichier ciblé ne porte pas l'extension .dat — soit le mauvais fichier a été sélectionné, soit l'extension a été modifiée ou perdue pendant le transfert.
CORRECTIONExécutez d'abord dir sur l'équipement pour confirmer le nom de fichier et l'extension exacts, puis activez ce fichier — ne retapez pas un nom de fichier de mémoire.
<Quidway> license active lics7700v200r0XX_XXX.dat
Error: Verify license failed.
Error: License file format invalidSYMPTÔMEError: The specified file does not exist or is illegal.
CAUSELe nom de fichier saisi lors de l'activation ne correspond à rien de réellement stocké sur l'équipement, ou contient des caractères que la CLI considère illégaux.
CORRECTIONExécutez dir pour lister ce qui se trouve réellement sur le périphérique de stockage, puis copiez le nom de fichier caractère par caractère — casse comprise — plutôt que de le retaper.
SYMPTÔMEInfo: License file validation failed — et par ailleurs, un ESN qui correspond visiblement à l'équipement est quand même rejeté comme incompatible.
CAUSELa documentation source rattache exactement ce symptôme à une perte de paquets pendant le téléversement — un transfert partiel ou corrompu laisse sur l'équipement un fichier de licence incomplet, dont la signature ne se valide plus même si le champ ESN visible reste correct.
CORRECTIONComparez avec dir la taille du fichier téléversé à celle du fichier qui vous a été délivré ; en cas de différence, basculez le client FTP en mode de transfert binaire avant de retéléverser, puis réactivez.
ftp client> binary
ftp client> put lics7700v200r0XX_XXX.dat
<SW> dir
// compare file size against the originally issued license fileSYMPTÔMENo product features present in LK (le même problème sous-jacent apparaît aussi sous la forme « No product features present in license file » dans certaines FAQ liées).
CAUSELes éléments contrôlés de la licence ont été générés pour un autre modèle d'équipement ou une autre famille de produits que celle sur laquelle on tente de l'activer — l'ESN peut être parfaitement correct et la licence ne s'appliquera quand même pas.
CORRECTIONRedemandez une nouvelle licence en précisant le modèle exact de l'équipement, pas seulement l'ESN, et vérifiez le champ produit du fichier réémis avant de le retéléverser.
SYMPTÔMEInfo: License File expired, sur un fichier qui n'a jamais été activé auparavant.
CAUSELa propre fenêtre de validité de la licence est déjà refermée au moment où quelqu'un finit par l'activer — fréquent lorsqu'une licence traîne un moment dans une boîte de réception après émission, ou lorsque la fenêtre fixe d'une licence démo s'épuise avant le déploiement.
CORRECTIONRedemandez ou rachetez une licence commerciale récente correspondant à l'ESN actuel de l'équipement, et activez-la immédiatement plutôt que de laisser s'accumuler des fichiers de licence émis mais inutilisés.
SYMPTÔMEInfo: License File with ESN or Version mismatch cannot be activated repetitively.
CAUSEUne licence dont l'ESN ou la version logicielle ne correspondait déjà pas à cet équipement a été activée une première fois — ce qui la fait passer en état Trial — et le même fichier est réactivé maintenant. L'équipement refuse la répétition plutôt que de réinitialiser silencieusement le compte à rebours d'essai.
CORRECTIONNe relancez pas la même activation en espérant un résultat différent — redemandez une licence qui corresponde réellement à l'ESN et à la version logicielle actuels, puis activez ce nouveau fichier à la place.
Les six messages d'erreur et leurs causes sont directement recoupés avec le tableau de traitement des pannes de licence des commutateurs de campus Huawei série S.
Un fichier de licence n'est pas qu'un ESN et une date d'expiration — c'est un en-tête signé plus un bloc signé par fonctionnalité, et la signature couvre l'ensemble.
La plus basique des six pannes n'entre même pas dans la classification ci-dessus, car elle survient avant que l'équipement n'ait la chance de vérifier l'ESN, l'expiration ou la correspondance produit : le fichier lui-même est mal formé. license activate le rejette immédiatement avec une erreur de deux lignes, et la cause est presque toujours l'une de trois choses — une erreur commise lors de la demande initiale de la licence, une corruption pendant le transfert, ou quelqu'un ayant manuellement modifié un fichier qui n'aurait jamais dû être touché.
<Quidway> license active lics7700v200r0XX_XXX.dat
Error: Verify license failed.
Error: License file format invalidUn véritable fichier de licence est en texte brut, structuré comme un en-tête signé suivi d'un bloc signé par fonctionnalité contrôlée. Les champs qui comptent pour le dépannage :
| Champ | Ce qu'il contient |
|---|---|
| LicenseSerialNo / Sign | Le numéro de série du fichier et la signature numérique calculée sur le contenu environnant — c'est ce que « format invalid » ou « validation failed » vérifie réellement. |
| Product / Feature | Le modèle d'équipement auquel ce bloc s'applique, et quelle fonctionnalité ou ressource contrôlée il accorde — c'est ce que vérifie une incompatibilité « No product features present ». |
| Esn | Le numéro de série de l'équipement auquel ce bloc est lié — comparé directement à display esn lors de l'activation. |
| Attrib | Trois valeurs : commercial ou démo, la date d'expiration (ou PERMANENT), et — fixé à 60 — le nombre de jours d'essai qu'une licence incompatible ou démo tient avant l'échec de ses fonctionnalités contrôlées. |
| Function / Comment | Les éléments contrôlés spécifiques accordés (et tout comptage de ressource, comme la capacité en AP) plus un commentaire de référence de commande interne. |
Comme Sign est calculé sur les champs visibles environnants, toute modification manuelle d'un fichier de licence — même une qui semble inoffensive, comme nettoyer des espaces — casse la signature et produit exactement l'erreur de format invalide ci-dessus. La documentation source est directe à ce sujet : ne jamais modifier le contenu visible d'un fichier de licence, et avant d'activer, confirmer que la taille du fichier téléversé correspond à la taille du fichier délivré à l'origine.
L'affichage de la licence semblait normal pendant deux mois — jusqu'à ce que l'horloge d'essai sur laquelle elle tournait discrètement s'épuise, et qu'un tunnel VXLAN pour toute l'activité tombe avec elle.
Un client a signalé qu'un tunnel VXLAN était soudainement tombé. La vérification du commutateur a montré que sa licence avait échoué — et le client a confirmé que la licence était installée sur cet équipement depuis exactement 60 jours.
Board fails. (Index=67108873, EntityPhysicalIndex=67108873,
PhysicalName="MPU Board 0", EntityTrapEntType=1, EntityTrapFaultID=132322,
EntityTrapReasonDescr="the ESN of card does not match the license file")
<SW> display license
Info: No license is activated.
<SW> display esn
ESN of slot 0: 1022B5088417
ESN of slot 1: 1022B5088418
<SW> more licensexxx.dat
ESN:1022B5088418
// the license's ESN matches slot 1 (standby) -- not slot 0 (the master this switch is checking against)Jour zéro : le système empilé a été installé avec une licence ne portant que l'ESN de l'unité de secours (slot 1). Comme le slot 0 (maître) ne correspondait jamais, la licence est immédiatement passée en état Trial — et selon la documentation source, une fois une licence en Trial, son compte à rebours de 60 jours démarre immédiatement, pas à un point d'avertissement ultérieur. Jour soixante : la fenêtre d'essai s'est refermée, les fonctionnalités contrôlées par la licence ont échoué immédiatement, exactement comme la FAQ le décrit — et comme VXLAN faisait partie des fonctionnalités sous cette licence, le tunnel est tombé sans avertissement supplémentaire.
Le mécanisme de licence en empilement de Huawei comporte un mode de défaillance supplémentaire par rapport à une simple incompatibilité d'ESN sur un seul équipement. Sur les versions antérieures à V200R009, une licence unique doit porter les ESN des deux membres de la pile — une licence avec un seul ESN passe en Trial dès qu'il y a un basculement, même si elle semblait correcte auparavant. À partir de V200R009, chaque membre peut porter son propre fichier de licence séparé, mais seulement si les éléments contrôlés des deux fichiers sont identiques : si les licences maître et de secours accordent des ensembles de fonctionnalités différents, le membre de secours commence silencieusement à synchroniser le fichier de licence du maître, et si ce fichier synchronisé n'inclut pas son propre ESN, l'état de licence du membre de secours bascule aussi en Trial — portant la même horloge de 60 jours jusqu'au basculement suivant.
Tirées directement du terrain — celles pour lesquelles il vaut la peine d'avoir une réponse prête.
Selon la documentation source, il s'agit généralement d'un problème de transfert, pas d'une véritable incompatibilité : une perte de paquets pendant le téléversement peut laisser un fichier de licence incomplet sur l'équipement. Comparez avec dir la taille du fichier téléversé à celle du fichier émis à l'origine ; en cas de différence, basculez le client FTP en mode binaire avant de retéléverser et de réactiver.
Presque jamais. La grande majorité des activations de licence prennent effet immédiatement sans redémarrage requis. Un petit nombre nécessite une commande de suivi et un redémarrage avant application — la licence de vitesse de port 40GE vers 100GE est l'exemple documenté, qui nécessite l'exécution de assign port-speed 100GE puis le redémarrage de l'équipement. Si la documentation propre d'une licence ne mentionne pas d'exigence de redémarrage, elle n'en a pas besoin.
Selon la documentation source, les fonctionnalités contrôlées par la licence échouent immédiatement au moment où la fenêtre d'essai se referme — il n'y a ni délai de grâce ni événement d'avertissement séparé au-delà des alarmes que la fonctionnalité elle-même génère. La solution consiste à redemander et réactiver avant la date d'expiration indiquée dans display license, pas après.
L'ESN d'un équipement est lié à sa carte de contrôle principale. Remplacer la carte change l'ESN effectif de l'équipement, et si celui-ci ne correspond plus à l'ESN de la licence installée, la licence passe automatiquement en Trial — le même mécanisme qui apparaît lors d'un basculement en empilement, simplement déclenché ici par un remplacement matériel.
Non — pour une meilleure compatibilité, un fichier de licence continue de fonctionner à travers une mise à niveau ou un retour en arrière du logiciel sans aucune action requise. Aligner la version produit enregistrée de la licence sur la nouvelle version logicielle est facultatif, et utile uniquement si vous prévoyez de futurs changements de capacité ou demandes de service liés à cette licence.
Cette note s'appuie sur le tableau des pannes d'activation de licence et les cas de terrain du manuel de maintenance des commutateurs de campus Huawei série S — S1720, S5700, S6700, S6730, S7700 et modèles apparentés. Elle ne couvre pas les licences des routeurs AR ou des pare-feux, qui utilisent un outil et un portail d'activation différents, et n'approfondit pas les différences de mode de licence sous déploiement NCE-Campus géré dans le cloud, qui suit son propre tableau distinct.
Envoyez-nous le texte d'erreur exact, le modèle d'équipement et l'ESN, et la façon dont le fichier de licence a été transféré — nous vous aiderons à déterminer laquelle des six causes il s'agit réellement.