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 no BTS: download (preparar o plano), validar (verificar erros) e ativar (aplicar alterações). O RAN Monitor gerencia todas as três etapas automaticamente.
Um push de configuração pode ser um SCF completo contendo todos os objetos gerenciados no BTS, ou uma atualização parcial visando 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 reinicializações desnecessárias do 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
| Atributo | Descrição |
|---|---|
class | Identificador da classe de objeto Nokia (por exemplo, NOKLTE:LNCEL, com.nokia.srbts.tnl:IPIF) |
distName | Nome distinto — o caminho do objeto na árvore de objetos gerenciados |
operation | create 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 do 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 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 no 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 de backup.
Risco: Alto. Um SCF completo normalmente contém objetos de transporte/IP que irão acionar uma reinicialização do 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 PM.
Risco: Baixo a nenhum, desde que você evite classes de objetos que acionam reinicializações.
Principais Diferenças
| Push Completo de SCF | Atualização Parcial | |
|---|---|---|
| Atributo de operação | operation="create" | operation="update" |
| Objetos incluídos | Todos os objetos gerenciados | Apenas objetos sendo alterados |
| Parâmetros incluídos | Todos os parâmetros por objeto | Apenas parâmetros sendo alterados |
| Risco de reinicialização | Quase certo | Depende das classes de objetos |
| Caso de uso típico | Provisionamento inicial | Alterações do dia a dia |
Impacto da Reinicialização por Classe de Objeto
Objetos que Acionam uma Reinicialização do BTS
Alterar qualquer uma dessas classes de objeto fará com que o BTS reinicie. O site ficará offline por 3-5 minutos durante a reinicialização.
| Categoria | Classes de Objetos |
|---|---|
| Transporte / IP | TNL, ETHIF, ETHLK, IPIF, IPADDRESSV4, IPRT, IPRTV6, VLANIF, L2SWI, BRGPRT, IBRGPRT, IPNO, ETHSVC, TNLSVC, IPSECC, FIREWALL |
| Sistema / Hardware | MRBTS, SMOD, BBMOD |
| Plano de Gestão | MPLANENW, CLOCK, SYNC, NTP |
| Segurança / Certificados | SECADM, CERTH, CERTHENT, CMP, CMPECDSA, CMPFH |
Objetos Seguros para Alterar Sem Reinicialização
Essas classes de objeto 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.
| Categoria | Classes de Objetos | Notas |
|---|---|---|
| Rádio LTE | LNCEL, LNCEL_FDD, LNBTS, LNBTS_FDD | Alguns parâmetros causam breve reconfiguração da célula |
| Rádio GSM | GNBTS, GNCEL, GNBCF | |
| Monitoramento de Desempenho | PMCADM, PMMNL, PMCCP, PMPLM, PMRNL, PMTNLINT | |
| Recursos | FEATCADM, FEATGADM, FEATLADM | |
| ANR / Relações de Vizinhança | ANR, ANRPRL | |
| RRC / DRX | DRX, SDRX, SIB | |
| S1 / Transporte | SCTP, TRSNW, LNMME | |
| Outros | ALARMSUPP, 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 pelo 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
Alterando o Nome do eNB
Sem reinicialização. Tem efeito imediato.
<?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>
Alterando o Nome da Célula
Sem reinicialização. Tem efeito imediato.
<?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>
Alterando 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>
Alterando 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>
Alterando o Intervalo de Coleta de PM
Sem reinicialização. Tem efeito 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>
Alterando Múltiplos Parâmetros em Objetos
Vários objetos podem ser incluídos em um único SCF. Este exemplo altera 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>
Alterando um Endereço IP (Aciona Reinicialização)
Alterar objetos de transporte/IP irá reiniciar o 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
- Navegue até Status do eNodeB no painel de controle
- Clique em Config Ops no dispositivo alvo
- Selecione seu arquivo XML SCF parcial (arraste e solte ou navegue)
- Clique em Enviar Configuração para o Dispositivo
- O RAN Monitor remove automaticamente os objetos de tempo de execução, em seguida, realiza download, valida e ativa
- 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, depois 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 do 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âmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
airscale_name | String | Sim | - | Nome do dispositivo registrado no RAN Monitor |
config_file | String | Sim | - | Caminho absoluto para o arquivo XML SCF no servidor do RAN Monitor |
Melhores Práticas
-
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.
-
Use atualizações parciais para mudanças operacionais. Inclua apenas os objetos e parâmetros que você precisa alterar. Isso minimiza o risco e evita reinicializações.
-
Use
operation="update"para alterações parciais. O atributooperation="create"é para substituições completas de SCF e irá sobrescrever todos os parâmetros no objeto. -
Verifique a classe do objeto antes de enviar. Se seu SCF incluir objetos de transporte, sistema, gestão ou segurança, o BTS irá reiniciar. Planeje uma janela de manutenção de acordo.
-
Verifique se o
distNamecorresponde ao seu BTS alvo. O ID MRBTS, ID LNBTS e IDs de células devem corresponder ao dispositivo alvo. Enviar odistNameerrado fará com que o BTS rejeite a configuração com um erro de validação. -
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). Estes são gerados automaticamente pelo 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 o 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 da validação ser concluída. O BTS processa cada etapa de forma assíncrona.
Resolução: O RAN Monitor espera pela conclusão assíncrona entre as etapas automaticamente. Se isso ocorrer, tente novamente o push. Se persistir, verifique se nenhum outro sistema de gestão (NetAct, WebLM) está simultaneamente enviando configuração para o mesmo BTS.
BTS Reiniciou Inesperadamente
Sintomas: BTS fica offline após o push de configuração, ping falha por 3-5 minutos.
Causa: A configuração enviada incluiu objetos de transporte/IP, sistema ou segurança que acionam uma reinicialização.
Resolução: O BTS voltará por conta própria 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 de Plano Não Encontrado
Sintomas: A ativação falha com Processing of attachment detail property file failed in agent
Causa: Erro interno do BTS ao ler o arquivo de 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.