Inicio / Notas técnicas / Solución de fallos de activación de licencia

Fallos de activación de licencia en switches: los seis mensajes de error explicados

Cada fallo de license activate en un switch de campus Huawei serie S se reduce a uno de seis mensajes de error exactos. Qué significa realmente cada uno, cómo está estructurado internamente el propio archivo de licencia, y un caso real en el que una discrepancia de ESN en el apilamiento agotó silenciosamente una prueba de 60 días y tumbó un túnel VXLAN en toda la red.

Por Yuwen Zhang (Atlas), fundador de AtlasCommTech — 13 años de despliegues de redes de operador y empresariales · Actualizado en julio de 2026

Seis mensajes, no mil posibilidades

Un license activate fallido no es un misterio — el equipo indica, textualmente, cuál de las seis causas exactas ocurrió.

En un switch de campus Huawei serie S (S1720, S5700, S6700, S6730, S7700 y el resto de la familia), license activate solo puede fallar de un pequeño número de formas precisas, y la CLI muestra el motivo exacto en lugar de un error genérico. Aprenda estos seis mensajes una vez y dejará de adivinar qué revisar a continuación.

A continuación: los seis mensajes clasificados según qué está realmente roto, la estructura interna del propio archivo de licencia — que explica por qué ocurre un error de «formato no válido» incluso cuando el ESN parece correcto — y un caso real en el que una licencia permaneció silenciosamente en estado Trial durante 60 días antes de que un túnel VXLAN cayera en todo el negocio.

Clasificando los seis errores: qué está realmente roto

Ordenar los seis mensajes según qué está realmente mal indica dónde mirar primero — el archivo equivocado, un archivo rechazado, o un archivo que no coincide con este equipo o este momento.

Category What's Actually Broken Exact Error Message GROUP A Wrong File Presented device never even reads a license The command points at a file that isn't a license file at all, or doesn't exist under that name on the device. postfix of the file name must be 'dat' specified file does not exist or is illegal GROUP B File Rejected By The Device it's a license file, just not a valid one The signature check fails, or the controlled items inside don't match this product family at all. License file validation failed No product features present in LK GROUP C Doesn't Match This Device Or Time a genuine license, wrong ESN or clock The file is a real, validly signed license — it's just past its own validity window, or tied to another ESN. License File expired License File with ESN or Version mismatch cannot be activated repetitively

Las etiquetas del diagrama se mantienen en inglés por claridad técnica.

Los seis mensajes, palabra por palabra, provienen de la misma tabla de fallos de activación de licencia del manual de mantenimiento de switches de campus Huawei serie S.

Los seis mensajes de error, uno por uno

Los mismos seis errores del diagrama anterior — aquí está el texto exacto de la CLI, qué está pasando realmente y la solución para cada uno.

Mensaje de errorGrupoSignificado
The filename is invalid, and the postfix of the file name must be 'dat'.Grupo AEl archivo apuntado por activate no es un archivo de licencia .dat.
The specified file does not exist or is illegal.Grupo ANo existe ningún archivo con ese nombre exacto en el almacenamiento del equipo.
License file validation failed.Grupo BLa firma digital del archivo no supera la verificación — a menudo por una transferencia corrupta.
No product features present in LK.Grupo BLos elementos controlados de la licencia no coinciden en absoluto con este producto.
License File expired.Grupo CLa propia ventana de validez de la licencia ya pasó.
License File with ESN or Version mismatch cannot be activated repetitively.Grupo CUna licencia con ESN/versión no coincidente ya se activó una vez y se está reintentando.

1. «postfix of the file name must be 'dat'» — el comando correcto, el archivo equivocado

SÍNTOMAlicense activate <filename> devuelve Error: The filename is invalid, and the postfix of the file name must be 'dat'.

CAUSAEl archivo señalado no lleva la extensión .dat — o se seleccionó el archivo equivocado, o la extensión se modificó o se perdió durante la transferencia.

SOLUCIÓNEjecute primero dir en el equipo para confirmar el nombre y la extensión exactos del archivo, y luego actívelo — no vuelva a escribir el nombre de memoria.

<Quidway> license active lics7700v200r0XX_XXX.dat
Error: Verify license failed.
Error: License file format invalid

2. «The specified file does not exist or is illegal» — compruebe con dir antes de volver a escribir nada

SÍNTOMAError: The specified file does not exist or is illegal.

CAUSAEl nombre de archivo escrito al activar no coincide con nada realmente almacenado en el equipo, o contiene caracteres que la CLI considera ilegales.

SOLUCIÓNEjecute dir para listar lo que realmente hay en el dispositivo de almacenamiento, y luego copie el nombre de archivo carácter por carácter — incluidas mayúsculas y minúsculas — en lugar de volver a escribirlo.

3. «License file validation failed» — normalmente un problema de transferencia, no un archivo falso

SÍNTOMAInfo: License file validation failed — y, por separado, un ESN que visiblemente coincide con el equipo aún así se rechaza como no coincidente.

CAUSALa documentación fuente atribuye exactamente este síntoma a la pérdida de paquetes durante la carga — una transferencia parcial o corrupta deja en el equipo un archivo de licencia incompleto, por lo que su firma ya no se valida aunque el campo ESN visible siga leyéndose correctamente.

SOLUCIÓNCompare con dir el tamaño del archivo cargado con el tamaño del archivo que se le entregó; si difieren, cambie el cliente FTP a modo de transferencia binaria antes de volver a cargarlo, y luego reactive.

ftp client> binary
ftp client> put lics7700v200r0XX_XXX.dat
<SW> dir
// compare file size against the originally issued license file

4. «No product features present in LK» — ESN correcto, producto equivocado

SÍNTOMANo product features present in LK (el mismo problema subyacente también aparece como «No product features present in license file» en preguntas frecuentes relacionadas).

CAUSALos elementos controlados de la licencia se generaron para otro modelo de equipo o familia de producto distinta a la que se está activando — el ESN puede ser totalmente correcto y la licencia igual no se aplicará.

SOLUCIÓNVuelva a solicitar una nueva licencia indicando el modelo exacto del equipo, no solo el ESN, y confirme el campo de producto del archivo reemitido antes de volver a cargarlo.

5. «License File expired» — la licencia caducó antes de ser instalada

SÍNTOMAInfo: License File expired, en un archivo que nunca antes se había activado.

CAUSALa propia ventana de validez de la licencia ya se ha cerrado para cuando alguien finalmente la activa — algo habitual cuando una licencia queda un tiempo en la bandeja de entrada tras ser emitida, o cuando la ventana fija de una licencia demo se agota antes del despliegue.

SOLUCIÓNVuelva a solicitar o recompre una licencia comercial nueva para el ESN actual del equipo y actívela de inmediato, en lugar de acumular archivos de licencia emitidos pero sin usar.

6. «ESN or Version mismatch cannot be activated repetitively» — deje de reintentar con el mismo archivo

SÍNTOMAInfo: License File with ESN or Version mismatch cannot be activated repetitively.

CAUSAUna licencia cuyo ESN o versión de software ya no coincidía con este equipo se activó una vez antes — lo que la lleva a estado Trial — y ahora se está activando otra vez el mismo archivo. El equipo rechaza la repetición en lugar de reiniciar silenciosamente el contador de prueba.

SOLUCIÓNNo vuelva a ejecutar la misma activación esperando un resultado distinto — vuelva a solicitar una licencia que realmente coincida con el ESN y la versión de software actuales, y active ese archivo en su lugar.

Los seis mensajes de error y sus causas se han verificado directamente contra la tabla de gestión de fallos de licencia de los switches de campus Huawei serie S.

Por qué ocurre «formato no válido»: leer el propio archivo de licencia

Un archivo de licencia no es solo un ESN y una fecha de caducidad — es un encabezado firmado más un bloque firmado por cada función, y la firma cubre todo el conjunto.

El más básico de los seis fallos ni siquiera entra en la clasificación anterior, porque ocurre antes de que el equipo tenga la oportunidad de comprobar el ESN, la caducidad o la coincidencia de producto: el propio archivo está mal formado. license activate lo rechaza de inmediato con un error de dos líneas, y la causa es casi siempre una de tres cosas — un error cometido al solicitar originalmente la licencia, corrupción durante la transferencia, o alguien editando manualmente un archivo que nunca debía tocarse.

<Quidway> license active lics7700v200r0XX_XXX.dat
Error: Verify license failed.
Error: License file format invalid

Un archivo de licencia genuino es texto plano, estructurado como un encabezado firmado seguido de un bloque firmado por cada función controlada. Los campos que importan para el diagnóstico:

CampoQué contiene
LicenseSerialNo / SignEl número de serie del archivo y la firma digital calculada sobre el contenido circundante — esto es lo que realmente comprueba «format invalid» o «validation failed».
Product / FeatureEl modelo de equipo al que se aplica este bloque, y qué función o recurso controlado otorga — esto es lo que comprueba una discrepancia «No product features present».
EsnEl número de serie del equipo al que está vinculado este bloque — comparado directamente con display esn en la activación.
AttribTres valores: comercial o demo, la fecha de caducidad (o PERMANENT), y — fijado en 60 — el número de días de prueba que una licencia no coincidente o demo funciona antes de que fallen sus funciones controladas.
Function / CommentLos elementos controlados específicos otorgados (y cualquier recuento de recursos, como la capacidad de AP) más un comentario interno de referencia de pedido.

Dado que Sign se calcula sobre los campos visibles circundantes, cualquier edición manual de un archivo de licencia — incluso una que parezca inofensiva, como ordenar espacios en blanco — rompe la firma y produce exactamente el error de formato no válido anterior. La guía fuente es tajante al respecto: nunca modifique el contenido visible de un archivo de licencia, y antes de activar, confirme que el tamaño del archivo cargado coincide con el tamaño del archivo emitido originalmente.

Caso real: un contador de prueba de 60 días que nadie vigilaba tumbó VXLAN

La salida de la licencia se veía bien durante dos meses — hasta que el contador de prueba sobre el que corría silenciosamente se agotó, y un túnel VXLAN de todo el negocio cayó con él.

Un cliente informó que un túnel VXLAN había caído de repente. Al revisar el switch se vio que su licencia había fallado — y el cliente confirmó que la licencia llevaba instalada en ese equipo exactamente 60 días.

La alarma y la cronología
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)

Día cero: el sistema apilado se instaló con una licencia que solo llevaba el ESN de la unidad en espera (slot 1). Como el slot 0 (maestro) nunca coincidió, la licencia pasó de inmediato a estado Trial — y según la guía fuente, una vez que una licencia está en Trial, su cuenta regresiva de 60 días arranca en ese mismo momento, no en algún punto de aviso posterior. Día sesenta: la ventana de prueba se cerró, las funciones controladas por la licencia fallaron de inmediato, tal como describe la FAQ — y como VXLAN era una de las funciones bajo esa licencia, el túnel cayó sin más aviso.

Por qué el apilamiento empeora esto

El mecanismo de licencia en apilamiento de Huawei tiene un modo de fallo adicional además de una simple discrepancia de ESN en un solo equipo. En versiones anteriores a V200R009, una sola licencia debe llevar los ESN de ambos miembros de la pila — una licencia con un solo ESN pasa a Trial en cuanto hay una conmutación, aunque antes se viera bien. Desde V200R009 en adelante, cada miembro puede llevar su propio archivo de licencia por separado, pero solo si los elementos controlados de ambos archivos son idénticos: si las licencias del maestro y del en espera otorgan conjuntos de funciones distintos, el en espera empieza a sincronizar silenciosamente el archivo de licencia del maestro, y si ese archivo sincronizado no incluye el propio ESN del en espera, el estado de licencia de este también pasa a Trial — llevando el mismo contador de 60 días a la siguiente conmutación.

Solución
  1. Solución inmediata: forzar una conmutación de la pila y reactivar la licencia después — esto restaura el servicio pero no elimina la discrepancia subyacente.
  2. Solución permanente, opción uno: solicitar un único archivo de licencia que lleve explícitamente los ESN de ambos miembros de la pila.
  3. Solución permanente, opción dos: separar la pila, instalar una licencia coincidente por unidad en cada miembro individualmente, confirmar que ambos muestran estado Normal, y luego volver a formar la pila.
  4. En cualquier caso, compare display license verbose con display esn en ambos miembros después de cualquier cambio, antes de asumir que la solución realmente surtió efecto.

Diseños de soluciones relacionadas

Cinco preguntas que surgen constantemente

Extraídas directamente del campo — las que vale la pena tener respondidas de antemano.

El ESN de mi archivo de licencia coincide exactamente con el del equipo — ¿por qué la activación sigue diciendo que el ESN no coincide?

Según la documentación fuente, esto suele ser un problema de transferencia, no una discrepancia real: la pérdida de paquetes durante la carga puede dejar un archivo de licencia incompleto en el equipo. Compare con dir el tamaño del archivo cargado con el del archivo emitido originalmente; si difieren, cambie el cliente FTP a modo binario antes de volver a cargar y reactivar.

¿Necesito reiniciar el switch después de activar una licencia?

Casi nunca. La gran mayoría de las activaciones de licencia surten efecto de inmediato sin necesidad de reinicio. Un pequeño número necesita un comando adicional y un reinicio antes de aplicarse — la licencia de velocidad de puerto de 40GE a 100GE es el ejemplo documentado, que necesita ejecutar assign port-speed 100GE y luego reiniciar el equipo. Si la propia documentación de una licencia no menciona un requisito de reinicio, no lo necesita.

¿Qué ocurre realmente cuando se agotan los 60 días de una licencia Trial?

Según la guía fuente, las funciones controladas por la licencia fallan de inmediato en el momento en que se cierra la ventana de prueba — no hay periodo de gracia ni evento de aviso independiente más allá de las alarmas que la propia función pueda generar. La solución es volver a solicitar y reactivar antes de la fecha de caducidad mostrada en display license, no después.

Cambié la tarjeta de control principal de la unidad en espera y el estado de la licencia pasó a Trial — ¿por qué, si no toqué la licencia?

El ESN de un equipo está vinculado a su tarjeta de control principal. Cambiar la tarjeta modifica el ESN efectivo del equipo, y si este ya no coincide con el ESN de la licencia instalada, la licencia pasa automáticamente a Trial — el mismo mecanismo que aparece en una conmutación de apilamiento, solo que aquí lo dispara un cambio de hardware.

¿Actualizar o revertir el software del switch invalida la licencia existente?

No — para una mejor compatibilidad, un archivo de licencia sigue funcionando tras una actualización o reversión del software sin necesidad de ninguna acción. Alinear la versión de producto registrada en la licencia con la nueva versión de software es opcional, y solo útil si planea futuros cambios de capacidad o solicitudes de servicio sobre esa licencia.

Límites honestos de esta nota

Límites honestos de esta nota

Esta nota se basa en la tabla de fallos de activación de licencia y los casos de campo del manual de mantenimiento de switches de campus Huawei serie S — S1720, S5700, S6700, S6730, S7700 y modelos relacionados. No cubre el licenciamiento de routers AR ni de firewalls, que usan una herramienta y un portal de activación distintos, y no profundiza en las diferencias de modo de licencia bajo el despliegue en la nube NCE-Campus, que sigue su propia tabla separada.

¿Atascado con una licencia que no activa?

Envíenos el texto exacto del error, el modelo del equipo y el ESN, y cómo se transfirió el archivo de licencia — le ayudaremos a determinar cuál de las seis causas es realmente.

WhatsApp a un ingeniero →

Lectura relacionada

Solo usamos cookies para analítica anónima — sin publicidad ni rastreo entre sitios.Política de privacidad