Toda falha de license activate em um switch de campus Huawei da série S se resume a uma de seis mensagens de erro exatas. O que cada uma realmente significa, como o próprio arquivo de licença é estruturado internamente, e um caso real em que uma incompatibilidade de ESN em empilhamento esgotou silenciosamente um teste de 60 dias e derrubou um túnel VXLAN em toda a rede.
Por Yuwen Zhang (Atlas), fundador da AtlasCommTech — 13 anos de implantações de redes de operadoras e corporativas · Atualizado em julho de 2026
Uma falha em license activate não é um mistério — o equipamento informa, na íntegra, qual das seis causas exatas ocorreu.
Em um switch de campus Huawei da série S (S1720, S5700, S6700, S6730, S7700 e o restante da família), o license activate só falha de um pequeno número de formas exatas, e a CLI imprime o motivo exato em vez de um erro genérico. Aprenda essas seis mensagens uma vez e pare de adivinhar o que verificar em seguida.
A seguir: as seis mensagens classificadas pelo que realmente está quebrado, a estrutura interna do próprio arquivo de licença — que explica por que ocorre um erro de “formato inválido” mesmo quando o ESN parece correto — e um caso real em que uma licença ficou silenciosamente em estado Trial por 60 dias antes de um túnel VXLAN cair em toda a operação.
Organizar as seis mensagens pelo que realmente está errado indica onde olhar primeiro — o arquivo errado, um arquivo rejeitado, ou um arquivo que não corresponde a este equipamento ou a este momento.
Os rótulos do diagrama permanecem em inglês para clareza técnica.
As seis mensagens, palavra por palavra, vêm da mesma tabela de falhas de ativação de licença do manual de manutenção dos switches de campus Huawei da série S.
Os mesmos seis erros do diagrama acima — aqui está o texto exato da CLI, o que realmente está acontecendo e a correção para cada um.
| Mensagem de erro | Grupo | Significado |
|---|---|---|
| The filename is invalid, and the postfix of the file name must be 'dat'. | Grupo A | O arquivo apontado pelo activate não é um arquivo de licença .dat. |
| The specified file does not exist or is illegal. | Grupo A | Não existe nenhum arquivo com esse nome exato no armazenamento do equipamento. |
| License file validation failed. | Grupo B | A assinatura digital do arquivo não passa na verificação — geralmente uma transferência corrompida. |
| No product features present in LK. | Grupo B | Os itens controlados da licença não correspondem em nada a este produto. |
| License File expired. | Grupo C | A própria janela de validade da licença já passou. |
| License File with ESN or Version mismatch cannot be activated repetitively. | Grupo C | Uma licença com ESN/versão incompatível já foi ativada uma vez e está sendo tentada novamente. |
SINTOMAlicense activate <filename> retorna Error: The filename is invalid, and the postfix of the file name must be 'dat'.
CAUSAO arquivo apontado não tem a extensão .dat — ou o arquivo errado foi selecionado, ou a extensão foi alterada ou removida durante a transferência.
CORREÇÃOExecute primeiro dir no equipamento para confirmar o nome e a extensão exatos do arquivo, depois ative esse arquivo — não digite o nome de memória.
<Quidway> license active lics7700v200r0XX_XXX.dat
Error: Verify license failed.
Error: License file format invalidSINTOMAError: The specified file does not exist or is illegal.
CAUSAO nome do arquivo digitado na ativação não corresponde a nada realmente armazenado no equipamento, ou contém caracteres que a CLI trata como ilegais.
CORREÇÃOExecute dir para listar o que realmente existe no dispositivo de armazenamento, depois copie o nome do arquivo caractere por caractere — incluindo maiúsculas e minúsculas — em vez de digitá-lo novamente.
SINTOMAInfo: License file validation failed — e, separadamente, um ESN que visivelmente corresponde ao equipamento ainda assim é rejeitado como incompatível.
CAUSAA documentação de origem atribui exatamente esse sintoma à perda de pacotes durante o upload — uma transferência parcial ou corrompida deixa no equipamento um arquivo de licença incompleto, de modo que a assinatura não é mais validada mesmo que o campo ESN visível ainda pareça correto.
CORREÇÃOCompare com dir o tamanho do arquivo enviado com o tamanho do arquivo que foi emitido; se forem diferentes, mude o cliente FTP para o modo de transferência binária antes de enviar novamente e reative.
ftp client> binary
ftp client> put lics7700v200r0XX_XXX.dat
<SW> dir
// compare file size against the originally issued license fileSINTOMANo product features present in LK (o mesmo problema também aparece como “No product features present in license file” em FAQs relacionadas).
CAUSAOs itens controlados da licença foram gerados para um modelo de equipamento ou família de produto diferente daquele em que está sendo ativada — o ESN pode estar totalmente correto e a licença mesmo assim não se aplicará.
CORREÇÃOSolicite uma nova licença informando o modelo exato do equipamento, não apenas o ESN, e confirme o campo de produto no arquivo reemitido antes de enviá-lo novamente.
SINTOMAInfo: License File expired, em um arquivo que nunca havia sido ativado antes.
CAUSAA própria janela de validade da licença já se fechou quando alguém finalmente a ativa — comum quando uma licença fica um tempo na caixa de entrada depois de emitida, ou quando a janela fixa de uma licença demo se esgota antes da implantação.
CORREÇÃOSolicite novamente ou recompre uma licença comercial recente para o ESN atual do equipamento e ative-a imediatamente, em vez de acumular arquivos de licença emitidos mas não usados.
SINTOMAInfo: License File with ESN or Version mismatch cannot be activated repetitively.
CAUSAUma licença cujo ESN ou versão de software já não correspondia a este equipamento foi ativada uma vez antes — o que a coloca em estado Trial — e o mesmo arquivo está sendo ativado novamente agora. O equipamento recusa a repetição em vez de reiniciar silenciosamente o contador do período de teste.
CORREÇÃONão execute a mesma ativação novamente esperando um resultado diferente — solicite uma licença que realmente corresponda ao ESN e à versão de software atuais, e ative esse arquivo no lugar.
As seis mensagens de erro e suas causas foram verificadas diretamente na tabela de tratamento de falhas de licença dos switches de campus Huawei da série S.
Um arquivo de licença não é apenas um ESN e uma data de expiração — é um cabeçalho assinado mais um bloco assinado por recurso, e a assinatura cobre tudo isso.
A mais básica das seis falhas nem entra na classificação acima, porque acontece antes de o equipamento ter a chance de verificar ESN, validade ou correspondência de produto: o próprio arquivo está malformado. O license activate o rejeita imediatamente com um erro de duas linhas, e a causa é quase sempre uma de três coisas — um erro cometido ao solicitar a licença originalmente, corrupção durante a transferência, ou alguém editando manualmente um arquivo que nunca deveria ser tocado.
<Quidway> license active lics7700v200r0XX_XXX.dat
Error: Verify license failed.
Error: License file format invalidUm arquivo de licença genuíno é texto simples, estruturado como um cabeçalho assinado seguido por um bloco assinado para cada recurso controlado. Os campos que importam para o diagnóstico:
| Campo | O que contém |
|---|---|
| LicenseSerialNo / Sign | O número de série do arquivo e a assinatura digital calculada sobre o conteúdo ao redor — é isso que “format invalid” ou “validation failed” realmente verifica. |
| Product / Feature | O modelo de equipamento ao qual esse bloco se aplica, e qual recurso ou funcionalidade controlada ele concede — é isso que uma incompatibilidade “No product features present” verifica. |
| Esn | O número de série do equipamento ao qual esse bloco está vinculado — comparado diretamente com display esn na ativação. |
| Attrib | Três valores: comercial ou demo, a data de expiração (ou PERMANENT), e — fixado em 60 — o número de dias de teste que uma licença incompatível ou demo roda antes de seus recursos controlados falharem. |
| Function / Comment | Os itens controlados específicos concedidos (e quaisquer contagens de recursos, como capacidade de AP) mais um comentário interno de referência de pedido. |
Como o Sign é calculado sobre os campos visíveis ao redor, qualquer edição manual em um arquivo de licença — mesmo uma que pareça inofensiva, como organizar espaços em branco — quebra a assinatura e produz exatamente o erro de formato inválido acima. A orientação de origem é direta sobre isso: nunca modifique o conteúdo visível de um arquivo de licença, e antes de ativar, confirme que o tamanho do arquivo enviado corresponde ao tamanho do arquivo originalmente emitido.
A saída da licença parecia normal por dois meses — até que o contador de teste em que ela rodava silenciosamente se esgotou, e um túnel VXLAN de toda a operação caiu junto.
Um cliente relatou que um túnel VXLAN havia caído repentinamente. Ao verificar o switch, constatou-se que sua licença havia falhado — e o cliente confirmou que a licença estava instalada naquele equipamento havia exatamente 60 dias.
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)Dia zero: o sistema empilhado foi instalado com uma licença que trazia apenas o ESN da unidade em espera (slot 1). Como o slot 0 (mestre) nunca correspondeu, a licença caiu para o estado Trial imediatamente — e, segundo a orientação de origem, uma vez que uma licença está em Trial, sua contagem regressiva de 60 dias começa naquele exato momento, não em algum aviso posterior. Dia sessenta: a janela de teste se fechou, os recursos controlados pela licença falharam imediatamente, exatamente como descreve o FAQ — e como o VXLAN era um dos recursos sob essa licença, o túnel caiu sem mais aviso.
O mecanismo de licença em empilhamento da Huawei tem um modo de falha extra além de uma simples incompatibilidade de ESN em um único equipamento. Em versões anteriores à V200R009, uma única licença precisa trazer os ESNs de ambos os membros da pilha — uma licença com apenas um ESN entra em Trial assim que há um failover, mesmo que antes parecesse normal. A partir da V200R009, cada membro pode ter seu próprio arquivo de licença separado, mas somente se os itens controlados de ambos os arquivos forem idênticos: se as licenças do mestre e do em espera concedem conjuntos de recursos diferentes, o em espera começa a sincronizar silenciosamente o arquivo de licença do mestre, e se esse arquivo sincronizado não incluir o próprio ESN do em espera, o estado da licença dele também vira Trial — carregando o mesmo contador de 60 dias para o próximo failover.
Tiradas diretamente do campo — vale a pena ter uma resposta pronta para elas.
Segundo a documentação de origem, geralmente isso é um problema de transferência, não uma incompatibilidade real: a perda de pacotes durante o upload pode deixar um arquivo de licença incompleto no equipamento. Compare com dir o tamanho do arquivo enviado com o do arquivo originalmente emitido; se forem diferentes, mude o cliente FTP para o modo binário antes de reenviar e reativar.
Quase nunca. A grande maioria das ativações de licença tem efeito imediato, sem necessidade de reinício. Um pequeno número precisa de um comando adicional e de um reinício antes de fazer efeito — a licença de velocidade de porta de 40GE para 100GE é o exemplo documentado, que precisa executar assign port-speed 100GE e depois reiniciar o equipamento. Se a documentação da própria licença não menciona exigência de reinício, ela não precisa de um.
Segundo a orientação de origem, os recursos controlados pela licença falham imediatamente no momento em que a janela de teste se fecha — não há período de carência nem evento de aviso separado além dos alarmes que o próprio recurso possa gerar. A solução é solicitar novamente e reativar antes da data de expiração mostrada em display license, não depois.
O ESN de um equipamento está vinculado à sua placa de controle principal. Trocar a placa muda o ESN efetivo do equipamento, e se ele não corresponder mais ao ESN da licença instalada, a licença cai automaticamente para Trial — o mesmo mecanismo que aparece em um failover de empilhamento, só que aqui disparado por uma troca de hardware.
Não — para melhor compatibilidade, um arquivo de licença continua funcionando após uma atualização ou downgrade de software sem nenhuma ação necessária. Alinhar a versão de produto registrada na licença com a nova versão de software é opcional, e só é útil se você planeja futuras mudanças de capacidade ou solicitações de serviço relacionadas a essa licença.
Esta nota é construída em torno da tabela de falhas de ativação de licença e dos casos de campo do manual de manutenção dos switches de campus Huawei da série S — S1720, S5700, S6700, S6730, S7700 e modelos relacionados. Ela não cobre o licenciamento de roteadores AR ou firewalls, que usam uma ferramenta e um portal de ativação diferentes, e não aprofunda as diferenças de modo de licença na implantação em nuvem NCE-Campus, que segue sua própria tabela separada.
Envie-nos o texto exato do erro, o modelo do equipamento e o ESN, e como o arquivo de licença foi transferido — ajudaremos você a descobrir qual das seis causas realmente é.