Pular para o conteúdo principal

Guia de Push de Configuração

Enviando alterações de configuração para estações base Nokia AirScale via RAN Monitor

Visão Geral​

O RAN Monitor pode enviar alterações de configuração para estações base Nokia AirScale usando o protocolo NE3S Bulk Operations. A configuração é expressa como um SCF (Site Configuration File) no formato XML RAML 2.1. O push segue um processo de três etapas na BTS: download (preparar o plano), validar (verificar erros) e ativar (aplicar alterações). O RAN Monitor gerencia automaticamente todas as três etapas.

Um push de configuração pode ser um SCF completo contendo todos os objetos gerenciados na BTS, ou uma atualização parcial direcionando apenas os parâmetros específicos que você deseja alterar. Atualizações parciais são a abordagem recomendada para mudanças operacionais porque são mais rápidas, de menor risco e evitam a reinicialização desnecessária da BTS.

Formato XML do SCF​

Todos os arquivos de configuração usam o esquema XML RAML 2.1. A estrutura básica é:

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>

<!-- Objetos gerenciados vão aqui -->

</cmData>
</raml>

Cada objeto gerenciado é representado como um elemento <managedObject>:

<managedObject class="NOKLTE:LNBTS" distName="MRBTS-256/LNBTS-256" operation="update">
<p name="enbName">MY-SITE-NAME</p>
</managedObject>

Atributos Chave​

AtributoDescrição
classIdentificador da classe de objeto Nokia (por exemplo, NOKLTE:LNCEL, com.nokia.srbts.tnl:IPIF)
distNameNome distinto — o caminho do objeto na árvore de objetos gerenciados
operationcreate para push de SCF completo, update para alterações parciais

Formato do Nome Distinto​

O distName segue um caminho hierárquico:

MRBTS-{bts_id}                                    # Raiz da BTS
MRBTS-{bts_id}/LNBTS-{bts_id}                     # LTE eNodeB
MRBTS-{bts_id}/LNBTS-{bts_id}/LNCEL-{cell_id}     # Célula LTE
MRBTS-{bts_id}/GNBTS-{gsm_id}                     # BTS GSM
MRBTS-{bts_id}/GNBTS-{gsm_id}/GNCEL-{cell_id}     # Célula GSM
MRBTS-{bts_id}/MNL-1/MNLENT-1/PMCADM-1            # Administração de PM
MRBTS-{bts_id}/EQM-1/APEQM-1                      # Gestão de Equipamentos

Push Completo de SCF vs Atualização Parcial​

Push Completo de SCF​

Um SCF completo contém todos os objetos gerenciados na BTS (tipicamente 100-200 objetos). Ele usa operation="create" em cada objeto. Isso substitui toda a configuração.

Quando usar: Provisionamento inicial, recuperação de desastres ou restauração de uma configuração conhecida a partir do backup.

Risco: Alto. Um SCF completo normalmente contém objetos de transporte/IP que irão acionar uma reinicialização da BTS, levando o site offline por 3-5 minutos.

Atualização Parcial​

Um SCF parcial contém apenas os objetos e parâmetros que você deseja alterar. Ele usa operation="update" e inclui apenas os elementos <p> específicos que estão sendo modificados.

Quando usar: Alterações de parâmetros operacionais, ajuste de células, ativação de recursos, configuração de PM.

Risco: Baixo a nenhum, desde que você evite classes de objetos que acionam reinicializações.

Principais Diferenças​

Push Completo de SCFAtualização Parcial
Atributo de operaçãooperation="create"operation="update"
Objetos incluídosTodos os objetos gerenciadosApenas objetos que estão sendo alterados
Parâmetros incluídosTodos os parâmetros por objetoApenas parâmetros que estão sendo alterados
Risco de reinicializaçãoQuase certoDepende das classes de objetos
Caso de uso típicoProvisionamento inicialAlterações do dia a dia

Impacto da Reinicialização por Classe de Objeto​

Objetos Que Acionam uma Reinicialização da BTS​

Alterar qualquer uma dessas classes de objetos fará com que a BTS reinicie. O site ficará offline por 3-5 minutos durante a reinicialização.

CategoriaClasses de Objetos
Transporte / IPTNL, ETHIF, ETHLK, IPIF, IPADDRESSV4, IPRT, IPRTV6, VLANIF, L2SWI, BRGPRT, IBRGPRT, IPNO, ETHSVC, TNLSVC, IPSECC, FIREWALL
Sistema / HardwareMRBTS, SMOD, BBMOD
Plano de GerenciamentoMPLANENW, CLOCK, SYNC, NTP
Segurança / CertificadosSECADM, CERTH, CERTHENT, CMP, CMPECDSA, CMPFH

Objetos Seguros para Alterar Sem Reinicialização​

Essas classes de objetos podem ser atualizadas sem acionar uma reinicialização. Algumas alterações de parâmetros de rádio causarão uma breve interrupção da célula (segundos) enquanto a célula é reconfigurada.

CategoriaClasses de ObjetosNotas
Rádio LTELNCEL, LNCEL_FDD, LNBTS, LNBTS_FDDAlguns parâmetros causam breve reconfiguração da célula
Rádio GSMGNBTS, GNCEL, GNBCF
Monitoramento de DesempenhoPMCADM, PMMNL, PMCCP, PMPLM, PMRNL, PMTNLINT
RecursosFEATCADM, FEATGADM, FEATLADM
ANR / Relações de VizinhançaANR, ANRPRL
RRC / DRXDRX, SDRX, SIB
S1 / TransporteSCTP, TRSNW, LNMME
OutrosALARMSUPP, REDRT, CAGENB, CADPR, QOS

Objetos de Tempo de Execução (Somente Leitura)​

Classes de objetos que terminam em _R são objetos de tempo de execução gerados automaticamente pela BTS. Eles não podem ser enviados e são removidos automaticamente pelo RAN Monitor antes do upload. Exemplos: EQM_R, APEQM_R, LNCEL_R, TNL_R, ETHIF_R.

Exemplos de Atualização Parcial​

Mudando o Nome do eNB​

Sem reinicialização. Entra em vigor imediatamente.

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="NOKLTE:LNBTS" distName="MRBTS-256/LNBTS-256" operation="update">
<p name="enbName">NICK-LAB-AIRSCALE</p>
</managedObject>
</cmData>
</raml>

Mudando o Nome da Célula​

Sem reinicialização. Entra em vigor imediatamente.

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="NOKLTE:LNCEL" distName="MRBTS-256/LNBTS-256/LNCEL-256" operation="update">
<p name="cellName">TRI-B5-1</p>
</managedObject>
</cmData>
</raml>

Mudando o ID Físico da Célula​

Sem reinicialização. A célula será brevemente reconfigurada.

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="NOKLTE:LNCEL_FDD" distName="MRBTS-256/LNBTS-256/LNCEL-256/LNCEL_FDD-256" operation="update">
<p name="physCellId">120</p>
</managedObject>
</cmData>
</raml>

Mudando EARFCN e Largura de Banda​

Sem reinicialização, mas a célula ficará brevemente indisponível (segundos) enquanto se reconfigura para a nova frequência.

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="NOKLTE:LNCEL_FDD" distName="MRBTS-256/LNBTS-256/LNCEL-256/LNCEL_FDD-256" operation="update">
<p name="earfcnDL">1400</p>
<p name="dlChBw">10 MHz</p>
</managedObject>
</cmData>
</raml>

Mudando o Intervalo de Coleta de PM​

Sem reinicialização. Entra em vigor no próximo ciclo de coleta.

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="com.nokia.srbts.mnl:PMCADM" distName="MRBTS-256/MNL-1/MNLENT-1/PMCADM-1" operation="update">
<p name="rTPmCollInterval">60s</p>
</managedObject>
</cmData>
</raml>

Mudando Múltiplos Parâmetros em Objetos​

Múltiplos objetos podem ser incluídos em um único SCF. Este exemplo muda o nome do eNB e um parâmetro da célula em um único push:

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="NOKLTE:LNBTS" distName="MRBTS-256/LNBTS-256" operation="update">
<p name="enbName">NICK-LAB-AIRSCALE</p>
</managedObject>
<managedObject class="NOKLTE:LNCEL" distName="MRBTS-256/LNBTS-256/LNCEL-256" operation="update">
<p name="cellName">TRI-B5-1</p>
<p name="pMax">331</p>
</managedObject>
</cmData>
</raml>

Mudando um Endereço IP (Aciona Reinicialização)​

Alterar objetos de transporte/IP irá reiniciar a BTS. O site ficará offline por 3-5 minutos.

<?xml version="1.0" encoding="UTF-8"?>
<raml xmlns="raml21.xsd" version="2.1">
<cmData type="actual" scope="all" domain="ALL">
<header>
<log dateTime="2026-03-21T00:00:00+00:00" action="created"></log>
</header>
<managedObject class="com.nokia.srbts.tnl:IPADDRESSV4" distName="MRBTS-256/TNL-1/IPNO-1/IPIF-1/IPADDRESSV4-1" operation="update">
<p name="localIpAddr">10.7.15.66</p>
</managedObject>
</cmData>
</raml>

Enviando Configuração via a Interface Web​

  1. Navegue até Status da BTS no painel de controle
  2. Clique em Config Ops no dispositivo alvo
  3. Selecione seu arquivo XML SCF parcial (arraste e solte ou navegue)
  4. Clique em Enviar Configuração para o Dispositivo
  5. O RAN Monitor remove automaticamente os objetos de tempo de execução, em seguida, realiza download, validação e ativação
  6. Monitore a mensagem de resultado para sucesso ou erros

Para mais controle, expanda a seção Avançado: Passos manuais de download/validação/ativação para preparar um plano sem ativá-lo, em seguida, valide e ative separadamente.

Enviando Configuração via API​

PUT /api/ne3s/function/provision
Content-Type: application/json

{
  "airscale_name": "ons-Lab-Airscale",
  "config_file": "/path/to/partial-config.xml"
}

O caminho config_file deve existir no servidor RAN Monitor. Copie o arquivo para o servidor primeiro, se necessário.

Resposta em caso de sucesso:

{
  "status": "success",
  "operation": "provision",
  "plan_id": "plan_1774041772721652742",
  "data": "<activateResponse>...</activateResponse>"
}

Resposta em caso de falha:

{
  "status": "error",
  "code": "PROVISION_FAILED",
  "message": "validate failed: Validation error details..."
}

Parâmetros da API​

ParâmetroTipoRequeridoPadrãoDescrição
airscale_nameStringSim-Nome do dispositivo registrado no RAN Monitor
config_fileStringSim-Caminho absoluto para o arquivo SCF XML no servidor RAN Monitor

Melhores Práticas​

  1. Sempre faça o download de um backup primeiro. Use o botão "Download Config" da Interface Web ou a API para salvar a configuração atual antes de fazer alterações.

  2. Use atualizações parciais para alterações operacionais. Inclua apenas os objetos e parâmetros que você precisa alterar. Isso minimiza o risco e evita reinicializações.

  3. Use operation="update" para alterações parciais. O atributo operation="create" é para substituições completas de SCF e irá sobrescrever todos os parâmetros no objeto.

  4. Verifique a classe do objeto antes de enviar. Se seu SCF incluir qualquer objeto de transporte, sistema, gerenciamento ou segurança, a BTS irá reiniciar. Planeje uma janela de manutenção de acordo.

  5. Verifique se o distName corresponde à sua BTS alvo. O ID MRBTS, ID LNBTS e IDs de células devem corresponder ao dispositivo alvo. Envie o distName errado e a BTS rejeitará a configuração com um erro de validação.

  6. Uma alteração por vez para parâmetros críticos. Ao alterar parâmetros de rádio que afetam o serviço (EARFCN, largura de banda, PCI), faça uma alteração por push para que você possa isolar quaisquer problemas.

Solução de Problemas​

Validação Falhou: Objeto Duplicado​

Sintomas: O push falha com Duplicated object MRBTS-256/EQM_R-1

Causa: O SCF contém objetos de tempo de execução (_R). Esses objetos são gerados automaticamente pela BTS e não podem ser enviados.

Resolução: O RAN Monitor remove automaticamente os objetos _R. Se você ver esse erro, verifique se está enviando através do RAN Monitor e não diretamente para a BTS.

Ativação Falhou: Conflito de Operação​

Sintomas: O push falha com Operation could not execute because of operation conflict, RequestOperationType = {activate}, OngoingOperationType = {validate}

Causa: A ativação foi enviada antes que a validação fosse concluída. A BTS processa cada etapa de forma assíncrona.

Resolução: O RAN Monitor aguarda a conclusão assíncrona entre as etapas automaticamente. Se isso ocorrer, tente novamente o push. Se persistir, verifique se nenhum outro sistema de gerenciamento (NetAct, WebLM) está simultaneamente enviando configuração para a mesma BTS.

BTS Reiniciou Inesperadamente​

Sintomas: A BTS fica offline após o push de configuração, o ping falha por 3-5 minutos.

Causa: A configuração enviada incluía objetos de transporte/IP, sistema ou segurança que acionam uma reinicialização.

Resolução: A BTS voltará sozinha após 3-5 minutos. Para evitar isso no futuro, use uma atualização parcial que inclua apenas os parâmetros específicos que você deseja alterar, evitando as classes de objetos que acionam reinicializações listadas acima.

Arquivo do Plano Não Encontrado​

Sintomas: A ativação falha com Processing of attachment detail property file failed in agent

Causa: Erro interno da BTS ao ler o arquivo do plano preparado. Pode ocorrer quando várias operações de configuração se sobrepõem.

Resolução: Aguarde 30 segundos e tente novamente o push. Se o erro persistir, reinicie a sessão NE3S usando o botão "Force Reconnect" na Interface Web antes de tentar novamente.

Última atualização em