Professional Documents
Culture Documents
net
ERICSSON
For Software Release(s): 17.Q1,16B,17.Q3,17A,17.Q2,17.Q4
Published: Feb 07, 2018
IPR
NRO Deployment Document (NDD)
Copyright Statement: This NDD is developed by Ericsson for Ericsson's use in the Installation, Configuration and
Implementation of Ericsson network elements. This work product represents Intellectual Property belonging to
Ericsson and is only to be used pursuant to contracts between Ericsson and the customer.
ERICSSON
Change Request Process ..........................................................................................................................................3
Overview ......................................................................................................................................................................3
Overview of Activity .................................................................................................................................................3
Initial Conditions ......................................................................................................................................................3
Post Conditions ........................................................................................................................................................4
Services Inclusions, Exclusions, and Assumptions....................................................................................................4
Inclusions..............................................................................................................................................................4
IPR
Assumptions.........................................................................................................................................................4
Service Impacts ........................................................................................................................................................4
Coordination ............................................................................................................................................................4
Terminology .............................................................................................................................................................5
Usernames and Passwords.......................................................................................................................................5
Prechecks .....................................................................................................................................................................5
Verify Templates exist in OSS Common Explorer.....................................................................................................6
Verify Baseband Software and License exist in SHM .............................................................................................15
LMT Integration..........................................................................................................................................................22
Integration Files .....................................................................................................................................................23
Preparing BSIM for Baseband Integration..............................................................................................................24
LMT Integration Onsite Configuration .......................................................................................................................39
Integration Files .....................................................................................................................................................39
Verify Connectivity to Baseband from OSS-RC.......................................................................................................40
Apply ARNE script on the OSS-RC...........................................................................................................................42
ARNE Import file options....................................................................................................................................44
Synchronize the Baseband node to the OSS-RC.....................................................................................................45
Application of TN/RN and post installation scripts in moshell or netconf format .................................................49
Baseband Integration Postchecks ..............................................................................................................................62
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 1
Apply Configuration File on RNC for WCDMA nodes .............................................................................................63
Requesting BSC configuration updates for GSM nodes .........................................................................................64
Backup the Baseband to the OSS-RC using SHM....................................................................................................64
Integration Postchecks...........................................................................................................................................68
Inform Field Technician that the site is ready for call testing ................................................................................68
ERICSSON
Appendices.................................................................................................................................................................69
Application of Bulk CM scripts using Planned Configuration Administration (PCA) ..............................................69
Importing of a Bulk CM script into a PCA ...............................................................................................................69
Activation of a Bulk CM script using a PCA.............................................................................................................79
Additional Bulk CM Files for Mixed Mode Deployments .......................................................................................86
Digital Unit Backup to the OSS-RC..........................................................................................................................87
Appendix - Intellectual Property Rights (IPR) .........................................................................................................87
IPR
Glossary......................................................................................................................................................................88
ERICSSON
integration on the OSS-RC. It applies to Baseband 5216/5212, Baseband 6620/6630, and
Baseband C608 nodes. It covers "LMT Integration"and "LMT Integration Onsite Configuration"
scenarios. Zero Touch Integration is covered in a separate NDD called Baseband Integration –
Zero Touch Remote Procedure for OSS-RC.
Intended Audience
Remote Integration Engineer with access to OSS-RC
IPR
If you have comments or corrections for this document, please click the Suggest a Change
button below the section you wish to update.
Overview
Overview of Activity
Before the integration is initiated, configuration files need to be obtained from engineering and
stored on the OSS-RC server. Please contact your site lead or project manager to obtain the
latest configuration files for your site.
In case of migration, the remote integration engineer will backup the configuration from the
existing DUx to the OSS-RC, prior to the shutdown of traffic and replacement of the node by the
onsite technician.
The onsite technician needs to complete the onsite portion of the Baseband integration
procedure in coordination with executing the procedures in this document by the remote
Integration engineer. The onsite technician could also provide a copy of the onsite
AutoIntegration log for reference of the activity done onsite.
Initial Conditions
A new greenfield integration or a site migration (DUx to Baseband) is scheduled.
Post Conditions
RBS is ready for service traffic testing.
ERICSSON
Services Inclusions, Exclusions, and Assumptions
Inclusions
The local Ericsson Engineering team will provide the network configuration scripts
to be loaded for each site. A list of these files can be found in the procedures
sections of this document.
The remote network integrator must have access to the following software/hardware and be
familiar with it’s use.
IPR
Access to the OSS-RC server GUI
Assumptions
This document assumes all equipment is currently in proper working order and is either
alarm free or the customer is aware of any known issues and has made Ericsson and all
stakeholders associated with the execution of this document aware of the known
alarms/issues.
Service Impacts
In case of a DUx migration to Baseband, all traffic on the DUx will be down approximately 2
hours before the new Baseband module can take new calls. This downtime includes time for the
physical removal of DUx and the installation of the Baseband node. The integration portion of the
activity takes 35 to 45 minutes. This NDD is to be performed during a low traffic period as a
precautionary measure. All service impacting work should be completed 30 minutes prior to end
of maintenance window.
Note: Cell downtime is 2 hours or less if the time is counted between lock cell to unlock cell, and not
between first script to last script. Lock cell is the time when the last DUx node EUtranCellFDD is locked.
And unlock is the time when the first Baseband EUtranCellFDD is unlocked.
Coordination
The following users are involved in the integration process.
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 4
Warehouse Technician (if applicable)
Performs all preparation activities at the warehouse prior to node being deployed to
site.
Field Technician
ERICSSON
Performs all activities on-site
Plans the node integration and prepares configuration data and involved servers and
services.
OMC Technician
IPR
Terminology
The table below shows a list of some of the old integration methods and their corresponding new
names starting in release 16B and onward.
Prechecks
The Ericsson Radio Systems – Go To Market (ERS-GTM) document contains a section for
System level prechecks that need to performed on the OSS-RC in preparation for Baseband
Integration. These system level checks require root access to the INFRA and OMSAS servers on
the OSS-RC and they are usually performed by the customer or the OSS-RC administrators.
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 5
In addition, the Baseband Radio Node End To End Integration Guide 25/1553-CNA 403 1646
Uen BB, which can be found in CPI, contains procedures that can be used by the OSS-RC
administrators to prepare the server for Baseband integration.
Please note that Zero Touch integration for Baseband nodes with GSM Radio Access
Technology is supported starting release 17A and above.
ERICSSON
Perform the procedures below to verify that the needed Node templates, software, and licenses
exist on the OSS-RC before starting the node integration.
Step Task/Observation
IPR
Connect to the OSS-RC server and open the OSS Common Explorer GUI window.
Note: OSS Common Explorer GUI is not the same as OSS Explorer. Make sure you select OSS
Common Explorer from the launch menu on the OSS-RC.
2 Click on "View" from the top window menu and select "Utilities".
4 Look for the ARNE template name that will be used with Baseband integration in your market.
ERICSSON
IPR
If you are provided the template xml file that you wish to use for your market, you can import
it into the Utilities tab by clicking on the "Add new Template" icon.
ERICSSON
6
IPR
Browse through the filesystem folders to where the template xml file is stored.
7
Note: You need to sftp the template xml file(s) to the OSS-RC prior to importing.
9 Give the new template a name and select the appropriate "Domain" and "Type" fields. For
ERICSSON
IPR
Click the "Schema..." button and select the appropriate .xsd schema file for your template.
For ARNE template, the schema filename can be found in the "xsi:schemaLocation=" field
10
The needed schema filename for the template can be found in the "xsi:schemaLocation="
11
field in the template xml file content. You can view the content of the xml file on your PC or in
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 11
Solaris OS by using "cat" or "more" commands. For Baseband ARNE templates, we typically
use the "dg2NodeTemplate.xsd" schema file.
ERICSSON
IPR
Browse through the filesystem folders to where the schema xsd file is stored.
12
14
15 Click "OK" to acknowledge the validation window and then click "Add" to import the template
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 13
into the OSS Utilities.
ERICSSON
IPR
Repeat the same steps above for the Site Installation File (SIF) template. If template import is
required, select "FileMgr" for the Domain field and select Type "RadioSiteInstall". For
Baseband Site Installation templates, we typically use the "SiteInstallation.xsd" schema file.
16
17 Repeat the same steps above for the OSS Node Protocol template. If template import is
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 14
required, select "FileMgr" for the Domain field and select Type "OSSNodeProtocol".
ERICSSON
IPR
Note: For any release of OSS “Security Enrollment” can be inside the SiteBasic file of the
Baseband node. Starting in release 16B the “Security Enrollment” can be separated from
SiteBasic file and into an OssNodeProtocol.xml file. This separation is optional and
the OssNodeProtocol.xml file can be generated by the PCI tool. Starting in release 17A, the
BSIM tool generates the OSSNodeProtocol.xml file for Zero Touch and LMT integration
scenarios. In order to do this, BSIM requires having an OSS Node Protocol template in the
Utilities tab. This template can be generated by the PCI tool as well and imported into the
OSS Common Explorer Utilities.
Depending on the Radio Access technology being deployed, there may be additional
18 templates required for node integration. Please use the same steps above to verify or import
any other required templates for your specific deployment scenario.
Step Task/Observation
1 Connect to the OSS-RC server and open a web browser such as FireFox
2 Put the following in the address field of the web browser:
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 15
https://mashost:51831/NSS-Client/
ERICSSON
IPR
Login to the Software Hardware Manager (SHM) using the OSS-RC username and
3
password.
4 Click on "Upgrade" tab in the Software Hardware Manager window.
In this window you will see a list of node software packages that have been imported into the
6 Software Hardware Manager application. You can sort the Name, ME Type, Description,
Imported by, and Date imported.
In the pop-up window, you can see the Product Number and Revision associated with the
8
package. Verify that the package used by your Baseband node is available in the list.
11
You can select the license entry that you want, and click on "view" button to see more details
12
related to the license.
13
You can import a license file into the SHM list if you have the .lkf or .xml file and you have put
14 it on the OSS-RC. Click the "import" button on the top right hand side of the window and
follow the prompts to import the license.
ERICSSON
OSS Node Protocol file (xml)
IPR
Feature Activation file (Bulk CM)
Step Task/Observation
Connect to the OSS-RC server and open the OSS Common Explorer GUI window.
1
Note: OSS Common Explorer GUI is not the same as OSS Explorer. Make sure you select OSS
Common Explorer from the launch menu on the OSS-RC.
The Site Installation File (SIF) that is generated in the procedure above, is sent to the onsite field
technician to apply to the Baseband node and perform the node integration. Once that is
complete, the remote integration engineer on the OSS-RC will need to do the following:
Verify node connectivity from the OSS-RC and check synchronization. Procedures "Verify Connectivity to
Baseband from OSS-RC" and "Synchronize the Baseband node to the OSS-RC" can be referenced to
perform these tasks.
ERICSSON
Software Upgrade Package file (zip)
IPR
Radio Network (RN) files (Netconf, Moshell, or Bluk CM)
Verify that you can moshell to the Baseband from the OSS-RC
Step Task/Observation
Connect to the OSS-RC server and open a terminal window by right clicking on the desktop
1 and selecting "Open Terminal".
ping xxx.xxx.xxx.xxx
Note: Replace the xxx.xxx.xxx.xxx with the actual OAM IP address of the Baseband.
If the ping test fails, then contact the onsite technician and the transport team if necessary to
3
help troubleshoot connectivity to the Baseband node.
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 41
If the ping test is successful, then proceed to amos to the Baseband unit from the OSS-RC
terminal window.
amos xxx.xxx.xxx.xxx
Note: Replace the xxx.xxx.xxx.xxx with the actual OAM IP address of the Baseband.
ERICSSON
4
IPR
5 Type q to exit from amos shell.
Step Task/Observation
Connect to the OSS-RC server and open a terminal window by right clicking on the desktop
1
and selecting "Open Terminal".
ssh mashost
Note: Enter your OSS-RC server password when prompted
3
ls *.xml
ERICSSON
Note: Look for the import file name in the output list.
Import the ARNE file into the OSS-RC database using the following command:
Note: Replace "XML file name" with the actual ARNE script file name.
IPR
4
Option Description
-f "xml file
ERICSSON
File to import. The XML file to parse
name.xml"
-i_nau (Node Already Used) Ignore errors about the attributes SubNetwork
userLabel, Site userLabel, ManagedElementID, ipaddress, group userLabel or
-i_nau
ftpService userLabel name already in use, reported as warning instead, does
not affect exit code.
-import Imports the file specified by -f.
Used only to validate all Network Elements.
r1: This stops the import after the first error.
rall: report all errors.
IPR
Validation of delete XML files checks for syntax errors and the following
-val:[r1|rall] semantic errors/warnings:
• the import version in the XML file must match the DTD version (error)
• the object being deleted does not exist (warning)
However, the import itself will restrict changes that could lead to an
inconsistent model.
Disable the Model upgrade operation. This option should not be used in normal
-notrans
operation.
This option is used to get the ARNE Rules Engine tracing in the import log file.
-traceon This option should not be used in normal operation unless Rules Engine
tracing is required.
Step Task/Observation
Connect to the OSS-RC server and open the OSS Common Explorer GUI window.
1
Note: OSS Common Explorer GUI is not the same as OSS Explorer. Make sure you select OSS
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 45
Common Explorer from the launch menu on the OSS-RC.
ERICSSON
IPR
In the "Topology" panel, click on the down arrow right underneath the word "Label"
3 Select "LTE" or "WCDMA" depending on the type of node you are integrating.
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 46
ERICSSON
IPR
Still in the "Topology" panel, click on the right pointing triangle to expand the child elements.
ERICSSON
6
IPR
7 Wait about 2 minutes for the Synchronization to take place.
Check the Synchronization status of the element by looking in the "Properties" panel and in
8 the "Configuration" tab. You may need to scroll down a little bit to see element's
"connectionStatus" and "mirrorMIBsynchStatus".
Moshell format
Bulk CM format
The following procedure shows the steps for applying scripts in netconf or moshell format.
Please use the Appendix entitled "Application of TN/RN scripts using Bulk CM" to apply scripts
that are delivered in Bulk CM format.
ERICSSON
Step Task/Observation
Connect to the OSS-RC server and open a terminal window by right clicking on the desktop
and selecting "Open Terminal".
IPR
1
In the terminal window, change directory to the where the site scripts are located.
2
cd /"path"
Note: Replace "path" with the actual file path to the scripts
amos xxx.xxx.xxx.xxx
Note: Replace the xxx.xxx.xxx.xxx with the actual OAM IP address of the Baseband.
ERICSSON
3
IPR
Once connected to the Baseband, type: lt all
4 When prompted, type the Baseband's local maintenance username and password.
Note: "lt all" command loads the MO tree and builds the proxy table.
5
For scripts in netconf format, use the "netconf" command below:
>netconf TN.xml
Note: Contact your next level of support if you encounter any errors during the execution of this
procedure.
Save an image on the Baseband after the execution of each script.
6
ERICSSON
IPR
Verify the image is saved by listing all the saved image names on the Baseband using the
command:
7
>cvls
8
For scripts in netconf format, use the "netconf" command below:
>netconf RN.xml
Note: Contact your next level of support if you encounter any errors during the execution of this
procedure.
Save an image on the Baseband after the execution of each script.
9
>cvms RN_Applied
IPR
command:
>cvls
10
ERICSSON
Note: Contact your next level of support if you encounter any errors during the execution of this
procedure.
Save an image on the Baseband after the execution of each script.
>cvms FeatureActivation_Applied
IPR
12
Verify the image is saved by listing all the saved image names on the Baseband using the
command:
13
>cvls
14
The reboot process will prompt for several variables. Type "y" when prompted to confirm the
restart. Then type "1" to indicate "RESTART_COLD", type "0" for
"PLANNED_RECONFIGURATION", and finally type a text string indicative of the reason for
the restart; for example, "updates".
When prompted, type the Baseband's local maintenance username and password.
15
Note: "lt all" command loads the MO tree and builds the proxy table.
16
For scripts in moshell format, use the "run" command below:
>run PostIntegration.mos
Note: Contact your next level of support if you encounter any errors during the execution of this
procedure.
ERICSSON
Save an image on the Baseband after the execution of each script.
>cvms PostIntegartion_Applied
17
IPR
Verify the image is saved by listing all the saved image names on the Baseband using the
command:
18
>cvls
19
For scripts in netconf format, use the "netconf" command below:
>netconf CellRelations.xml
Note: Contact your next level of support if you encounter any errors during the execution of this
procedure.
Save an image on the Baseband after the execution of each script.
20
>cvms CellRelation_Applied
>cvls
Request or perform BSC changes in case the Baseband is providing GSM radio access service.
Create a configuration backup on the Baseband node and transfer it to the OSS-RC.
ERICSSON
Bulk CM RNC configuration file
If the RNC(s) configuration files are delivered in Bulk CM format, please refer to the procedure
entitled "Application of Bulk CM scripts using Planned Configuration Administration (PCA)".
If the RNC(s) configuration files are delivered in Moshell format, please use the procedure below.
Note: The application of RNC scripts is only applicable for WCDMA nodes.
IPR
Configuration on RNC for WCDMA nodes via moshell commands/script
Step Task/Observation
Connect to the OSS-RC server and open a terminal window by right clicking on the desktop
1
and selecting "Open Terminal".
In the terminal window, change directory to the where the site scripts are located.
2 >cd /"path"
Note: Replace "path" with the actual file path to the scripts
3 >amos xxx.xxx.xxx.xxx
Note: Replace the xxx.xxx.xxx.xxx with the actual OAM IP address of the RNC.
4
Note: "lt all" command loads the MO tree and builds the proxy table.
6 Repeat the step above for all RNC scripts associated with you node.
7 Type "exit" to quit out of moshell.
ERICSSON
Requesting BSC configuration updates for GSM nodes
The integration of a GSM node may require configuration changes on the associated BSC(s).
The integration engineer should check with the customer or project leads to make sure those
changes have been completed for the GSM node being added to the network. For more
information on BSC changes please refer to Baseband Integration - GSM BSC Procedure.
IPR
This section provides the basic instructions to backup the Baseband unit to the OSS-RC server.
Step Task/Observation
1 Connect to the OSS-RC server and open a web browser such as FireFox
Put the following in the address field of the web browser:
2
https://mashost:51831/NSS-Client/
5 Expand the Element Tree and Select the Node you wish to backup to the OSS-RC
IPR
7
IPR
9
Inform Field Technician that the site is ready for call testing
Once all postchecks have completed successfully, the remote integration engineer should inform
the onsite field technician that the site is ready for call testing.
ERICSSON
Use the two procedures below to apply Bulk CM scripts to a node using a Planned Configuration
Area (PCA) on the OSS-RC. These two procedures can be used to apply Bulk CM scripts to G2
nodes and to the WCDMA RNC.
IPR
Import Bulk CM scripts into a Planned Configuration
Step Task/Observation
Connect to the OSS-RC server and open the OSS Common Explorer GUI window.
Note: OSS Common Explorer GUI is not the same as OSS Explorer. Make sure you select OSS
Common Explorer from the launch menu on the OSS-RC.
ERICSSON
2
IPR
3 Click on the New Planned Configuration icon to create a new PCA
Step Task/Observation
Connect to the OSS-RC server and open the OSS Common Explorer GUI window.
1
Note: OSS Common Explorer GUI is not the same as OSS Explorer. Make sure you select OSS
Common Explorer from the launch menu on the OSS-RC.
Note: Always run the Transport Network (TN) script first, before the Radio Network (RN) script.
ERICSSON
3
IPR
A new window will pop up. Leave "Create Rollback File" unchecked and click on the "Next" to
4
continue.
Note: The same steps can be used to apply any post install Bulk CM script provided for this site.
The previous two procedures can be used to applu Bulk CM scripts to a WCDMA RNC. Please
check with your next level of support if you are not sure about the format or procedure you need
to use to apply any of the provided site scripts.
ERICSSON
Backup the DU node to the OSS-RC
Step Task/Observation
1 Connect to the OSS-RC server and open the Software Management Organizer GUI
Select Network from left panel of the window and search for your node name in the middle
2
panel of the window
Select the node you want to backup and click on the "config" tab in the right panel of the
3
window.
Scroll down through the list of CVs on the node and select the one you want to upload to the
IPR
4
OSS-RC
5 Right click on the CV name you want to backup and clock "Upload CVs"
6 Click on the "Jobs" option in the left panel to verify that the upload is successful.
ERICSSON
Configuration files/scripts Trademark material
IPR
IOT (Inter-Operability Test) and
Integration Processes
Glossary
The Glossary is used to define the Terms and Acronyms used throughout the document.
Term/Acronym Definition
AIWS Auto Integration Web Service
AP Auto Provisioning
ARNE Add Remove Network Element
BSIM Base Station Integration Manager
CA Certificate Authority
CLI Command Line Interface
DU Digital Unit
DUR Document Update Request
ENM Ericsson Network Manager
FTP File Transfer Protocol
G1 Generation 1 node (i.e. DUL / DUS / DUG)
7/1543-1/LZA 905 5680
© Ericsson AB 2020 kamel.afilales@ericsson.com 88
G2 Generation 2 node (i.e. Baseband 5212/5216, 6620/6630, & C608)
GUI Graphical User Interface
IPR Intellectual Property Rights
L/G LTE / GSM
L/W LTE / WCDMA
ERICSSON
LKF License Key File
LMT Local Maintenance Terminal
NDD NRO Deployment Document
NIC Network Integration Center
NMA Netconf Manager Adapter
OMC Operations and Maintenance Center
OMSAS Operation and Maintenance Security Administration Server
OSS-RC Operations Support System - Radio and Core
IPR
RA Registration Authority
RBS Radio Base Station
RN Radio Network
RRU Remote Radio Unit
SFTP Secure FTP
SIF Site Installation File
SMRS Software Management Repository Services
TN Transport Network
UP Upgrade Package
USB Universal Serial Bus
VC Vendor Credentials
ZT Zero Touch