5G Radio Node Integration MOP Guide
5G Radio Node Integration MOP Guide
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
<<GNB_example_project.zip>>
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
[Link]
[Link]
NodeInfo file details is used by ENM to add the node to ENM and to prepare the files for the integration.
<nodeType>5GRadioNode</nodeType>
Use the value from "Model ID" column, for the Product Identity and Revision which match closest to the NR SW
Package.
The nodeIdentifier is important to get the correct version of the MOM for the SW version to be used on the
node.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Site Equiment:
Example file is for BB6630 with one AIR6488 unit connected with 3 RiLinks, to RiPort D, E, F.
Site Basic:
ServiceDiscovery and ServiceDiscoveryServer MOs are included in example file. These MOs are required in NR
node.
TN Bulk Transport:
Create MOs:
• SctpProfile
• SctpEndpoint
RN Bulk GNodeBFunction
Create MOs:
• GNodeBFunction
RN Bulk SectorCarrier
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Create MOs:
• GNodeBRpFunction
o TddRadioChannel
o GNodeBSectorCarrier
o GUtranDUCell
GUtranDUCell::cgi must match GUtranCell::cgi which is calculated from gNBPlmnId, gNBId and cellId
RN Bulk GUtranCell
RN Bulk PpFunction
Create MOs:
• PpFunction
Execution :
(More detailed procedure described further below)
2. Drag and drop archive [Link] from Explorer window to ENM CLI workarea.
ap order file:"[Link]"
ap status -n <NodeName>
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
ap download -o -n <NodeName>
Onsite integration:
1. At the site, connect a laptop to LMT port.
Change laptop IP to [Link]
Turn off firewall
5. When log shows Download completed, the Integrate button will be active.
Click "Integrate"
6. After some minutes the node will reach config level "SITE_CONFIG_COMPLETE"
At this point it is possible to login to the node from remote.
The node will synchronize automatic with ENM and continue with Bulk file configuration.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
ap status -n <NodeName>
10. Note: If in the AI log the config level shows "OSS_CONFIGURATION_FAILED" and the ENM ap status
command printout shows failure, then check in ENM what failed and then perform ap upload and ap
resume.
More details provided further down.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
netconf_FeatureState_5G.xml
<ManagedElement xmlns="urn:com:ericsson:ecim:ComTop">
<managedElementId>1</managedElementId>
<SystemFunctions>
<systemFunctionsId>1</systemFunctionsId>
<Lm>
<lmId>1</lmId>
<FeatureState> <featureStateId>CXC4012218</featureStateId>
<featureState>ACTIVATED</featureState> </FeatureState> <!-- Basic Intelligent Connectivity -->
</Lm>
</SystemFunctions>
</ManagedElement>
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
NOTES:
Only Basic Intelligent Connectivity feature is mandatory to get 5G functionality working in eNB. Any case
double check which other features might add values for you customer to get 5G network working optimal
way
netconf_GUtranNetwork.xml
<ManagedElement>
<managedElementId>1</managedElementId>
<ENodeBFunction>
<eNodeBFunctionId>1</eNodeBFunctionId>
<intraRanIpAddressRef>Router=UP,InterfaceIPv4=1,AddressIPv4=1</intraRanIpAddressRef>
<GUtraNetwork>
<gUtraNetworkId>1</gUtraNetworkId>
<ExternalGNodeBFunction>
<externalGNodeBFunctionId>1</externalGNodeBFunctionId>
<gNodeBId>21</gNodeBId> <!-- Must match gNBId in the gNB node -->
<gNodeBPlmnId struct="PlmnIdentity">
<mcc>262</mcc>
<mnc>800</mnc>
<mncLength>3</mncLength>
</gNodeBPlmnId>
<TermPointToGNB>
<termPointToGNBId>1</termPointToGNBId>
<ipAddress>[Link]</ipAddress> <!-- gNB traffic IP -->
<administrativeState>UNLOCKED</administrativeState>
</TermPointToGNB>
</ExternalGNodeBFunction>
</GUtraNetwork>
</ENodeBFunction>
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
</ManagedElement>
[Link]
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
<<RN_Bulk_Cm_gNB_in_eNB.xml>>
(Missing eNodeBFunction::intraRanIpAddressRef and QciProfilePredefined::dualConnInitUlConf parameters.)
Auto Provisioning
The flowchart below highlights the main steps involved in Auto Provisioning.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Auto
Provisionin
g
Step Task/Observation
2 Click on your username in the top right corner of the ENM GUI and select View User Profile
from the drop down menu.
Verify that the user has the following roles required to complete this procedure:
• Operator
• SHM Operator or Administrator
• AMOS Operator or Administrator
• Shell Terminal (SSH) Access
• Topology Browser
• Alarm Monitoring (FM)
• Autoprovisioning Operator or Administrator
• Cmedit_Operator or Cmedit_Administrator
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
At the ENM Application Launcher, click on Software and Hardware Manager > License
Administration > View Imported Key Files
Check if the License Key File (LKF) exists for the site.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
If the LKF is not listed, click on Import Key Files and upload the LKF to ENM.
At the ENM homepage, click on Software and Hardware Manager > Software Administration >
View Software Packages
Check if the required Upgrade Package (UP) is available.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
If the UP is not listed, click on Import Software Package and upload the UP to the ENM.
At the ENM homepage, under Tools, click on Command Line Interface (CLI).
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
6 Start AutoProvisioning
Locate the AP project zip file on the PC from which you are accessing the ENM
Then drag and drop the project zip file into the ENM CLI workspace.
This will copy the project zip file from the PC into the ENM.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
7 In the ENM CLI, order the project file to add the new node into the ENM and generate the site
install file.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
8 In the ENM CLI, check the status for the project and the node to be integrated.
At this point it will show the integration status before the node is integrated on site.
The last task at this stage should be: Node Up Notification with a status of Waiting
>> ap view
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Once the onsite team has completed the onsite activities and called the NIC, proceed with this
procedure to complete the remote integration.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Click Integrate
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Once the onsite team has completed the onsite activities, proceed with this procedure to
complete the remote integration.
The integration status and last task in the list should both be: Integration Completed
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
12 In the ENM CLI, verify that the CM syncStatus for the node is SYNCHRONIZED.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Note: If the CM syncStatus for the node is UNSYNCHRONIZED, perform the following command
to sync the node.
Repeat the command above to verify the node is now SYNCHRONIZED.
13 In the ENM CLI, verify that CM supervision is set to true for the node.
Note: If CM supervision is not set to true, perform the following command to set the
attribute(s) to true.
Repeat the command above to verify the parameter has been changed.
14 In the ENM CLI, verify that SHM supervision is true for the node.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Note: If CM supervision is not set to true, perform the following command to set the
attribute(s) to true.
Repeat the command above to verify the parameter has been changed.
15 In the ENM CLI, verify that Alarm supervision is true for the node.
Note: If Alarm supervision is not set to true, perform the following command to set the
attribute to true.
Repeat the command above to verify the parameter has been changed.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
16 In the ENM CLI, verify that PM supervision is set to true for the node if PM supervision is
required.
Note: If PM supervision is not set to true, perform the following command to set the attribute(s)
to true if required.
Repeat the command above to verify the parameter has been changed.
17 At the ENM homepage, click on Software and Hardware Manager > Backup Administration
Then click on the Add Topology Data button to select the node you want to add under Network
Elements.
Verify that the latest backup of the node has been uploaded to the ENM.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Acknowledge any minor and major alarms by right clicking on the alarm and selecting
Acknowledge.
This will change the status of the alarm from ACTIVE_UNACKNOWLEDGED to
ACTIVE_ACKNOWLEDGED.
19 At the ENM homepage, click on Command Line Interface (CLI), once the AP of the node has
been completed and everything has been verified. The project file that was added at the
beginning of the AP will need to be manually deleted from the ENM.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Verify that the integration has completed for all nodes in the project before you delete the
project from the ENM.
Step Task/Observation
If AI log shows "OSS_CONFIGURATION_FAILED" and ENM ap status shows Import Configurations Failed
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Identify the error in the Bulk file in the project and correct it. The file must be unzipped from the
project.
Drag and drop the fixed file to the ENM CLI workarea
This will replace the faulty file in the ordered project with the corrected file.
Perform Resume, to resume the project and Import Configurations will be started again (with the
corrected file)
Note. The ap status must be in Waiting for Resume or Cancel before trigger Resume.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Manual Provisioning
This section provides the steps required to use the ENM to manually complete the integration of a new node.
Manual
Provisionin
g
Step Task/Observation
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
2 Click on your username in the top right corner of the ENM GUI and select View User Profile
from the drop down menu. Verify that the user has the following roles required to complete
this procedure:
• Administrator
• Operator
• SHM Operator
• SHM Administrator
• AMOS Administrator
• Shell Terminal (SSH) Access
• Topology Browser
• Alarm Monitoring (FM)
• Node CLI
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
3 At the ENM homepage, under Tools, click on Command Line Interface (CLI).
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
4 Drag and drop the add node batch file into the ENM CLI and run the batch file.
Note: The batch file will perform all CLI commands required to add the node into the ENM.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
5 Drag and drop the OneNodeEntity XML file from your PC into the ENM CLI and create the
OneNodeEntity entity on the ENM.
Verify that the new entity has been created on the ENM.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
6 In the ENM CLI, verify that CM, SHM, Alarm and PM supervision are active or enabled for the
node.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Note: If CM, SHM, Alarm or PM supervision are not set to true, perform the following
command(s) to set the attribute(s) to true. Repeat the command above to verify the parameter
has been changed.
CM:
>> cmedit set NetworkElement=<Node>,CmNodeHeartbeatSupervision=1 active=true
SHM:
>> cmedit set NetworkElement=<Node>,InventorySupervision=1 active=true
Alarm:
>> alarm enable <node>
PM:
>> cmedit set NetworkElement=<Node>,PmFunction=1 pmEnabled=true
7 In the ENM CLI, verify that the CM syncStatus for the node is SYNCHRONIZED.
Note: The node must be synchronized in order to perform any remote integration activities on
the node. The node will not be able to synchronize until the onsite integration activities have
been completed.
Note: If the CM syncStatus for the node is UNSYNCHRONIZED, perform the following command
to sync the node. Repeat the command above to verify the node is now SYNCHRONIZED.
8 Perform this step to apply TN, RN and feature activation 3GPP bulk CM files only if these
configuration files were not applied to the node during a warehouse configuration.
Note: Refer to the Appendices if the Customer wishes to apply moshell or Netconf files.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Note: When integrating a WCDMA node, separate TN and RN scripts will be generated for the
RNC.
Drag and drop the [Link] file into the ENM CLI and import the TN file.
Always apply the TN file first and then the RN and Feature Activation file(s).
Take note of the job ID # assigned to the import and check the status of the job.
After applying a Bulk CM file, you will need to save a backup on the node. Open a new window
in the ENM and start a Shell Terminal, then AMOS to the node from the Shell Terminal.
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
>lt all
>cvms <File_Applied_Name>
>cvls
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Note: Repeat for all RN and Feature Activation bulk CM files that you wish to import.
9 At the ENM homepage, click on Software and Hardware Manager > Backup Administration and
then click on the Add Topology Data button to select the node you want to add under Network
Elements.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19
Select the latest backup available on the node from the list and click on Manage Backup.
Enter a Job Name and check the Upload to ENM box and then click on Create.
Verify that the upload of the backup completes and shows a job status of 100%.
10 At the ENM homepage, click on Alarm Monitor and then click on the Add Topology Data button
and select Search for Network Objects from the drop down menu. Enter the name of the node
you want to find and click on Search. Select the node from the search results and then click on
the Return Selected Managed Objects button. The node will now appear in the Topology, click
on Apply and this will display the alarms for the node.
Verify that there is not an alarm for a missing LKF, in the case the LKF was not installed during
the onsite activities for the node, refer to the Appendices to apply the LKF using the ENM.
Acknowledge any minor and major alarms by right clicking on the alarm and selecting
Acknowledge. This will change the status of the alarm from ACTIVE_UNACKNOWLEDGED to
ACTIVE_ACKNOWLEDGED.
Confidentiality Class External Confidentiality Label Document Type Page
Clifford Imaguezegie
Document Number Revision Date Reference
PA1 2019-08-19