Guide de Push de Configuration

Pousser des modifications de configuration aux stations de base Nokia AirScale via RAN Monitor

Vue d'ensemble

RAN Monitor peut pousser des modifications de configuration aux stations de base Nokia AirScale en utilisant le protocole NE3S Bulk Operations. La configuration est exprimée sous forme de SCF (Site Configuration File) au format XML RAML 2.1. Le push suit un processus en trois étapes sur le BTS : télécharger (stager le plan), valider (vérifier les erreurs) et activer (appliquer les modifications). RAN Monitor gère automatiquement les trois étapes.

Un push de configuration peut être un SCF complet contenant chaque objet géré sur le BTS, ou une mise à jour partielle ciblant uniquement les paramètres spécifiques que vous souhaitez modifier. Les mises à jour partielles sont l'approche recommandée pour les modifications opérationnelles car elles sont plus rapides, moins risquées et évitent de déclencher des redémarrages inutiles du BTS.

Format XML SCF

Tous les fichiers de configuration utilisent le schéma XML RAML 2.1. La structure de base est :

<?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>

<!-- Les objets gérés vont ici -->

</cmData>
</raml>

Chaque objet géré est représenté comme un élément <managedObject> :

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

Attributs Clés

Attribut	Description
`class`	Identifiant de classe d'objet Nokia (ex. `NOKLTE:LNCEL`, `com.nokia.srbts.tnl:IPIF`)
`distName`	Nom distinct — le chemin de l'objet dans l'arbre des objets gérés
`operation`	`create` pour un push SCF complet, `update` pour des modifications partielles

Format du Nom Distinct

Le distName suit un chemin hiérarchique :

MRBTS-{bts_id}                                    # Racine du BTS
MRBTS-{bts_id}/LNBTS-{bts_id}                     # LTE eNodeB
MRBTS-{bts_id}/LNBTS-{bts_id}/LNCEL-{cell_id}     # Cellule LTE
MRBTS-{bts_id}/GNBTS-{gsm_id}                     # BTS GSM
MRBTS-{bts_id}/GNBTS-{gsm_id}/GNCEL-{cell_id}     # Cellule GSM
MRBTS-{bts_id}/MNL-1/MNLENT-1/PMCADM-1            # Administration PM
MRBTS-{bts_id}/EQM-1/APEQM-1                      # Gestion de l'équipement

Push SCF Complet vs Mise à Jour Partielle

Push SCF Complet

Un SCF complet contient chaque objet géré sur le BTS (généralement 100-200 objets). Il utilise operation="create" sur chaque objet. Cela remplace l'ensemble de la configuration.

Quand l'utiliser : Provisionnement initial, récupération après sinistre, ou restauration d'une configuration connue à partir d'une sauvegarde.

Risque : Élevé. Un SCF complet contient généralement des objets de transport/IP qui déclencheront un redémarrage du BTS, rendant le site hors ligne pendant 3 à 5 minutes.

Mise à Jour Partielle

Un SCF partiel contient uniquement les objets et paramètres que vous souhaitez modifier. Il utilise operation="update" et n'inclut que les éléments <p> spécifiques à modifier.

Quand l'utiliser : Changements de paramètres opérationnels, réglage de cellule, activation de fonctionnalités, configuration PM.

Risque : Faible à néant, à condition d'éviter les classes d'objets déclenchant un redémarrage.

Différences Clés

	SCF Complet	Mise à Jour Partielle
Attribut d'opération	`operation="create"`	`operation="update"`
Objets inclus	Tous les objets gérés	Seulement les objets modifiés
Paramètres inclus	Tous les paramètres par objet	Seulement les paramètres modifiés
Risque de redémarrage	Presque certain	Dépend des classes d'objets
Cas d'utilisation typique	Provisionnement initial	Changements quotidiens

Impact du Redémarrage par Classe d'Objet

Objets Qui Déclenchent un Redémarrage du BTS

Modifier l'une de ces classes d'objets entraînera le redémarrage du BTS. Le site sera hors ligne pendant 3 à 5 minutes pendant le redémarrage.

Catégorie	Classes d'Objets
Transport / IP	`TNL`, `ETHIF`, `ETHLK`, `IPIF`, `IPADDRESSV4`, `IPRT`, `IPRTV6`, `VLANIF`, `L2SWI`, `BRGPRT`, `IBRGPRT`, `IPNO`, `ETHSVC`, `TNLSVC`, `IPSECC`, `FIREWALL`
Système / Matériel	`MRBTS`, `SMOD`, `BBMOD`
Plan de Gestion	`MPLANENW`, `CLOCK`, `SYNC`, `NTP`
Sécurité / Certificats	`SECADM`, `CERTH`, `CERTHENT`, `CMP`, `CMPECDSA`, `CMPFH`

Objets Sûrs à Modifier Sans Redémarrage

Ces classes d'objets peuvent être mises à jour sans déclencher un redémarrage. Certains changements de paramètres radio entraîneront une brève interruption de cellule (secondes) lors de la reconfiguration de la cellule.

Catégorie	Classes d'Objets	Remarques
Radio LTE	`LNCEL`, `LNCEL_FDD`, `LNBTS`, `LNBTS_FDD`	Certains paramètres causent une brève reconfiguration de cellule
Radio GSM	`GNBTS`, `GNCEL`, `GNBCF`
Surveillance de Performance	`PMCADM`, `PMMNL`, `PMCCP`, `PMPLM`, `PMRNL`, `PMTNLINT`
Fonctionnalités	`FEATCADM`, `FEATGADM`, `FEATLADM`
ANR / Relations de Voisinage	`ANR`, `ANRPRL`
RRC / DRX	`DRX`, `SDRX`, `SIB`
S1 / Transport	`SCTP`, `TRSNW`, `LNMME`
Autre	`ALARMSUPP`, `REDRT`, `CAGENB`, `CADPR`, `QOS`

Objets d'Exécution (Lecture Seule)

Les classes d'objets se terminant par _R sont des objets d'exécution générés automatiquement par le BTS. Ils ne peuvent pas être poussés et sont automatiquement supprimés par RAN Monitor avant le téléchargement. Exemples : EQM_R, APEQM_R, LNCEL_R, TNL_R, ETHIF_R.

Exemples de Mise à Jour Partielle

Changer le Nom de l'eNB

Pas de redémarrage. Prend effet immédiatement.

<?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>

Changer le Nom de la Cellule

Pas de redémarrage. Prend effet immédiatement.

<?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>

Changer l'ID de Cellule Physique

Pas de redémarrage. La cellule se reconfigurera brièvement.

<?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>

Changer l'EARFCN et la Largeur de Bande

Pas de redémarrage, mais la cellule sera brièvement indisponible (secondes) lors de la reconfiguration à la nouvelle fréquence.

<?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>

Changer l'Intervalle de Collecte PM

Pas de redémarrage. Prend effet lors du prochain cycle de collecte.

<?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>

Changer Plusieurs Paramètres à Travers des Objets

Plusieurs objets peuvent être inclus dans un seul SCF. Cet exemple change le nom de l'eNB et un paramètre de cellule en un seul 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>

Changer une Adresse IP (Déclenche un Redémarrage)

Modifier des objets de transport/IP déclenchera le redémarrage du BTS. Le site sera hors ligne pendant 3 à 5 minutes.

<?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>

Pousser la Configuration via l'Interface Web

Naviguez vers État du BTS dans le panneau de contrôle
Cliquez sur Config Ops sur le dispositif cible
Sélectionnez votre fichier XML SCF partiel (glisser-déposer ou parcourir)
Cliquez sur Pousser la Configuration vers le Dispositif
RAN Monitor supprime automatiquement les objets d'exécution, puis effectue le téléchargement, la validation et l'activation
Surveillez le message de résultat pour le succès ou les erreurs

Pour plus de contrôle, développez la section Avancé : Étapes manuelles de téléchargement/validation/activation pour stager un plan sans l'activer, puis validez et activez séparément.

Pousser la Configuration via l'API

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

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

Le chemin config_file doit exister sur le serveur RAN Monitor. Copiez le fichier sur le serveur d'abord si nécessaire.

Réponse en cas de succès :

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

Réponse en cas d'échec :

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

Paramètres de l'API

Paramètre	Type	Requis	Par défaut	Description
`airscale_name`	String	Oui	-	Nom de l'appareil enregistré dans RAN Monitor
`config_file`	String	Oui	-	Chemin absolu vers le fichier XML SCF sur le serveur RAN Monitor

Meilleures Pratiques

Téléchargez toujours une sauvegarde d'abord. Utilisez le bouton "Télécharger la Config" de l'interface Web ou l'API pour sauvegarder la configuration actuelle avant d'apporter des modifications.
Utilisez des mises à jour partielles pour les changements opérationnels. Incluez uniquement les objets et paramètres que vous devez modifier. Cela minimise le risque et évite les redémarrages.
Utilisez operation="update" pour des modifications partielles. L'attribut operation="create" est destiné aux remplacements SCF complets et écrasera tous les paramètres de l'objet.
Vérifiez la classe d'objet avant de pousser. Si votre SCF inclut des objets de transport, système, gestion ou sécurité, le BTS redémarrera. Planifiez une fenêtre de maintenance en conséquence.
Vérifiez que le distName correspond à votre BTS cible. L'ID MRBTS, l'ID LNBTS et les ID de cellule doivent correspondre à l'appareil cible. Poussez le mauvais distName et le BTS rejettera la configuration avec une erreur de validation.
Un changement à la fois pour les paramètres critiques. Lors de la modification des paramètres radio qui affectent le service (EARFCN, largeur de bande, PCI), effectuez un changement par push afin de pouvoir isoler tout problème.

Dépannage

Validation Échouée : Objet Dupliqué

Symptômes : Le push échoue avec Duplicated object MRBTS-256/EQM_R-1

Cause : Le SCF contient des objets d'exécution (_R). Ceux-ci sont générés automatiquement par le BTS et ne peuvent pas être poussés.

Résolution : RAN Monitor supprime automatiquement les objets _R. Si vous voyez cette erreur, vérifiez que vous poussez via RAN Monitor et non directement au BTS.

Activation Échouée : Conflit d'Opération

Symptômes : Le push échoue avec Operation could not execute because of operation conflict, RequestOperationType = {activate}, OngoingOperationType = {validate}

Cause : L'activation a été envoyée avant que la validation ne soit terminée. Le BTS traite chaque étape de manière asynchrone.

Résolution : RAN Monitor attend la fin asynchrone entre les étapes automatiquement. Si cela se produit, réessayez le push. Si cela persiste, vérifiez qu'aucun autre système de gestion (NetAct, WebLM) ne pousse simultanément la configuration vers le même BTS.

BTS Redémarré de Manière Inattendue

Symptômes : Le BTS devient hors ligne après le push de configuration, le ping échoue pendant 3 à 5 minutes.

Cause : La configuration poussée incluait des objets de transport/IP, système ou sécurité qui déclenchent un redémarrage.

Résolution : Le BTS reviendra de lui-même après 3 à 5 minutes. Pour éviter cela à l'avenir, utilisez une mise à jour partielle qui n'inclut que les paramètres spécifiques que vous souhaitez modifier, en évitant les classes d'objets déclenchant un redémarrage énumérées ci-dessus.

Fichier de Plan Non Trouvé

Symptômes : L'activation échoue avec Processing of attachment detail property file failed in agent

Cause : Erreur interne du BTS lors de la lecture du fichier de plan mis en scène. Cela peut se produire lorsque plusieurs opérations de configuration se chevauchent.

Résolution : Attendez 30 secondes et réessayez le push. Si l'erreur persiste, redémarrez la session NE3S en utilisant le bouton "Forcer la reconnexion" dans l'interface Web avant de réessayer.

Vue d'ensemble​

Format XML SCF​

Attributs Clés​

Format du Nom Distinct​

Push SCF Complet vs Mise à Jour Partielle​

Push SCF Complet​

Mise à Jour Partielle​

Différences Clés​

Impact du Redémarrage par Classe d'Objet​

Objets Qui Déclenchent un Redémarrage du BTS​

Objets Sûrs à Modifier Sans Redémarrage​

Objets d'Exécution (Lecture Seule)​

Exemples de Mise à Jour Partielle​

Changer le Nom de l'eNB​

Changer le Nom de la Cellule​

Changer l'ID de Cellule Physique​

Changer l'EARFCN et la Largeur de Bande​

Changer l'Intervalle de Collecte PM​

Changer Plusieurs Paramètres à Travers des Objets​

Changer une Adresse IP (Déclenche un Redémarrage)​

Pousser la Configuration via l'Interface Web​

Pousser la Configuration via l'API​

Paramètres de l'API​

Meilleures Pratiques​

Dépannage​

Validation Échouée : Objet Dupliqué​

Activation Échouée : Conflit d'Opération​

BTS Redémarré de Manière Inattendue​

Fichier de Plan Non Trouvé​