Baseband Integration - Warehouse Procedure [PDF]

Citation preview

  R   O N   I P R https://prscms.ericsson.net 6/1543-1/LZA 905 5680 2017© Ericsson AB [email protected] Baseband Integration – Warehouse Procedure Revision - C For Software Release(s): 16B,17.Q1,17.Q2,17A Published: Jun 29, 2017 NRO Deployment Document (NDD) 6/1543-1/LZA 905 5680 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.   R   O N  



I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 1 Table of Contents General Information..................................................................................................................................................... 3 Purpose.................................................................................................................................................................... 3 Intended Audience................................................................................................................................................... 3 Change Request Process..........................................................................................................................................3



Overview................................................................................................................................................................... 3 Overview of Activity................................................................................................................................................. 3 Service Impacts........................................................................................................................................................ 6 Coordination............................................................................................................................................................ 7 Deliverables and Responsibilities.............................................................................................................................7 Prerequisites and Dependencies..............................................................................................................................7 Prerequisites:....................................................................................................................................................... 7 Equipment Identification.....................................................................................................................................8 Entrance Criteria.................................................................................................................................................. 8



Exit Criteria........................................................................................................................................................... 8 Terminology............................................................................................................................................................. 8 Precautions and Preparations......................................................................................................................................9 Precautions.............................................................................................................................................................. 9 Safety and Environmental Documents.....................................................................................................................9 Required Documents................................................................................................................................................ 9 Job Preparations...................................................................................................................................................... 9 Tools & Test Sets..................................................................................................................................................9 Supplies.............................................................................................................................................................. 10 Software............................................................................................................................................................. 10 Additional Files for Mixed Mode Deployments......................................................................................................14 Usernames and Passwords....................................................................................................................................14



Procedures................................................................................................................................................................. 14 Connect to Baseband LMT port..............................................................................................................................14 Change Local Terminal IP Address.....................................................................................................................14 Disable Firewall.................................................................................................................................................. 15   R



  O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 2 Start SFTP server on PC......................................................................................................................................19 Zero Touch, Off Site Preconfiguration..................................................................................................................21 Offsite Full Integration........................................................................................................................................... 28 Baseband integration using locally stored configuration files...........................................................................28 Apply Netconf format RN/TN and Post Integration scripts using Cygwin..............................................................36 Additional Netconf Files for Mixed Mode Deployments........................................................................................42 Apply moshell scripts using Cygwin.......................................................................................................................42 Additional Moshell Files for Mixed Mode Deployments........................................................................................47 Power Off the Node...............................................................................................................................................47



Appendices............................................................................................................................................................... 47 Appendix - Configuration Files Description............................................................................................................47 Appendix - Intellectual Property Rights (IPR).........................................................................................................48



Glossary.................................................................................................................................................................... 49   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 3 General Information Purpose This document provides the information and procedures for warehouse pre-staging of the Baseband. It applies to Baseband 5216/5212. The steps in this documents can be used for both Greenfield Baseband deployments and Baseband Migration from DUx.This NDD is valid for Baseband nodes that will be managed by either an OSS-RC or an ENM OAM platform. This document does not cover the integration process using Smart Laptop USB or the smart phone EASi application. For integration using the Smart Laptop USB please use  Baseband Integration Smart Laptop USB User Guide  and for integration using the smart phone EASi application please use  Baseband Integration - EASi User Guide . Intended Audience 



Warehouse Integration Engineer  Change Request Process 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 This overview is provided as a high level look at sequences and processes covered by this document. This section does not contain any commands and is not intended to be executed.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 4 Before the integration is initiated, configuration files need to be obtained and stored on the warehouse technician's computer. These files are prepared by the engineering/scripting team. Please contact your project lead to obtain the latest configuration files for your site. This document covers the following two warehouse Integration options: Zero Touch, Offsite Pre-configuration   This option allows the warehouse engineer to download the SiteBasic, SiteEquipment, License file, and software Upgrade Package to the Baseband node at the warehouse. The warehouse pre-



staging engineer will use the “Zero touch integration off-site pre-configuration” tab of the Baseband Network Loader Web User Interface to perform this activity. The node is then powered off and taken to the planned site, where, after power-up, the remaining portion of the integration is performed remotely from OSS-RC or the ENM.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 5 Offsite Full Integration With this option the warehouse pre-staging engineer will use the “LMT Integration on-site configuration” tab of the Baseband Network Loader Web User Interface to download and integrate the Baseband node with the SiteBasic, SiteEquipment, and software Upgrade Package. The warehouse engineer will also apply any TN/RN and post installation scripts in the warehouse using Cygwin and Moshell software tools.   R   O N   I



P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 6  After the completion of this procedure, the Baseband node is sent to the onsite field technician for physical installation at the desired site. The onsite field technician should contact the OMC / NIC staff to inform them of his activities at the site. The OMC / NIC staff must verify the integration process is complete and make any necessary changes on the OSS-RC or the ENM server before the node is considered ready for operation. Service Impacts This document is for initial warehouse preparation and therefore there will be no impact to traffic.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 7 Coordination The following users are involved in the integration process. Warehouse Technician  Performs all preparation activities at the warehouse prior to node being deployed to site. Field Technician 



Performs all activities on-site. Remote Integration Engineer   Plans the node integration and prepares configuration data on the OSS-RC. OMC Technician  Monitors the network from an Operation and Maintenance Center (OMC). Deliverables and Responsibilities Responsible Party Responsibility Site Access Passwords Equipment/Material Customer owned Node changes Customer Site drawings and Special safety requirements Physical install The NIC will update the node as required. All work will be done remotely. Local engineering team and/or GSC group will provide scripts as required Ericsson Project Management to ensure Ericsson teams complete work, stay on schedule and co-ordinate with customer PMs. Third Party Prerequisites or activities that will be executed by a third party Prerequisites and Dependencies Prerequisites: 



Review all documents or references prior to performing this procedure.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 18 7Wait 20 seconds for the system to update. 8 Next to Network Threat Protection, click Change Settings. 9Remove the check from the box labeled Enable Firewall and Click OK .   R   O N   I P R 6/1543-1/LZA 905 5680



© Ericsson AB [email protected] 19   Start SFTP server on PC The instructions in this document refer to Core FTP mini-ftp server.   Start SFTP Server StepTask/Observation 1Open the SFTP server software.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 20 2In the user field type: rbs 3In the password field type: rbs 4In the port field type: 22 5 In the root path type: C:Node_Integration 6Click -



START     R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 41 14 Restart the node manually after the Feature Activation completed.   acc FieldReplacementUnit=1 restartUnit   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".   15 Once the Baseband is backup, type: lt all   When prompted, type rbs



for username and rbs for the password.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 42 16 Repeat the same steps to apply any other scripts provided in netconf format. Note: If you observe any errors during the execution of the script, please take a capture of the error and send it to the engineering team that provided you the script 17When done, type quit  to exit out of moshell. Additional Netconf Files for Mixed Mode Deployments There will be multiple Radio Network (RN) files and multiple post Install scripts in Mixed Mode deployments. The first 2 digits at the start of the file name indicate the order in which the files are applied. Use the same procedure above to apply any additional Netconf (.xml) files provided for Mixed Mode node Integration. Apply moshell scripts using Cygwin Moshell scripts are applied to the Baseband node using a Cygwin terminal window and the moshell application.



The first 2 digits at the start of the file name indicate the order in which the files are applied. Apply moshell scripts in Cygwin StepTask/Observation 1 Store the moshell scripts in Cygwin c:cygwinhomescripts folder.   Note: The exact path of the files may be different depending on Cygwin home directory.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 43   2 Open Cygwin and go to the folder where the scripts are stored.   cd /home/scripts 3 In the Cygwin window, moshell to the Baseband using the LMT port IP address.   moshell 169.254.2.2   R



  O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 46   9 Once the Baseband is backup, type: lt all   When prompted, type rbs for username and rbs for the password.   10 Execute the Post Integration Script from Cygwin terminal.   run PostIntegration.mos   Note: If you observe any errors during the execution of the script, please take a capture of the error and send it to the engineering team that provided you the script 11 Save an image on the Baseband after the execution of each script.



cvms PostIntegartion_Applied 12 Verify the image is saved by listing all the saved image names on the Baseband using the command: cvls 13 Execute the Cell Relation Script from Cygwin terminal.   run CellRelation.mos   Note: If you observe any errors during the execution of the script, please take a capture of the error and send it to the engineering team that provided you the script 14 Save an image on the Baseband after the execution of each script. cvms CellRelation_Applied   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 47 15 Verify the image is saved by listing all the saved image names on the Baseband using the command:



cvls 16When done, type quit  to exit out of moshell.   Additional Moshell Files for Mixed Mode Deployments There will be multiple Radio Network (RN) files and multiple post Install scripts in Mixed Mode deployments. The first 2 digits at the start of the file name indicate the order in which the files are applied. Use the same procedure above to apply any additional Moshell files provided for Mixed Mode node Integration. Power Off the Node For warehouse installations, when the integration is complete, power off the node and safely package the node in proper ESD shipping material in preparation for transportation to the site. Appendices Appendix - Configuration Files Description The table below provides a brief description of the standard configuration files used during Baseband node integration. File NameFile TypeFile Content RbsSummaryNetconf (.xml) Contains the paths to the SiteBasic and SiteEquipment files used in the integration. SiteBasicNetconf (.xml) Contains Security management, system management, and transport network configuration. SiteEquipmentNetconf (.xml)Contains information related to node hardware. Transport Network (TN)Netconf (.xml) Contains configuration related to the transport / backhaul of the node. Radio Network (RN)Netconf (.xml)



Contains configuration related to the wireless / radio access technology being deployed i.e. LTE, WCDMA, GSM. Feature Activation scriptMoshell (.mos)Activates Node features. Post Integration scriptMoshell (.mos)Applies customer / market specific parameters to the site.   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 48 Cell Relations scriptMoshell (.mos)Defines node cell relations. Upgrade Package (UP)ZIPContains Network Loader and Software Installation files. License Key File (LKF)XMLLicense keys for node features. Appendix - Intellectual Property Rights (IPR) This document contains Ericsson Intellectual Property (IP) also known as Intellectual Property Rights (IPR). This document was created using modified/selective content from the Telcordia GR1275 Central Office/Network Environment Equipment Installation/Removal Generic Requirements Issue 12. This document is not intended for use by external customers or any customer delegate, including Third Party vendors and/or sub-contractors. Review of this document with customers should only occur with the knowledge, consent and control of Ericsson personnel in a manner where content is not distributed to the customer. The following Table of IPR examples is provided as reference information and examples to identify



Ericsson Intellectual Property (IP). This information is provided for use by Ericsson Customer Unit interfacing functions.    Detailed Acceptance Plans/Test Cases  Detailed Assembly Instructions/Diagrams  Cable Diagrams  Connections  Software upgrade command lines  Processes  Configuration files/scripts  Ericsson Developed Applications (Apps)  Industrial design  Session logs  Restricted User Level Passwords 



Ericsson Developed Tools  Installation Instructions  Commissioning Instructions  Integration Instructions  Integration files/scripts  Copyright material  Patent material  Trademark material  Ericsson Radio Frequency Specs  Debug logs  Detailed Patch Procedures   Any capture of Ericsson messaging traffic (i.e. Wire Shark)   R   O



N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 49  IOT (Inter-Operability Test) and Integration Processes   Glossary The Glossary is used to define the Terms and Acronyms used throughout the document. Term/AcronymDefinition  AIWSAuto Integration Web Service  APAuto Provisioning  ARNEAdd Remove Network Element BSIMBase Station Integration Manager  CLICommand Line Interface DUDigital Unit DURDocument Update Request ENMEricsson Network Manager  FTPFile Transfer Protocol G1Generation 1 node (i.e. DUL / DUS / DUG) G2Generation 2 node (i.e. Baseband 5212 / 5216) GUIGraphical User Interface IPRIntellectual Property Rights L/GLTE / GSM L/WLTE / WCDMA



LKFLicense Key File LMTLocal Maintenance Terminal NDDNRO Deployment Document NICNetwork Integration Center  OMCOperations and Maintenance Center  OSS-RCOperations Support System - Radio and Core RBSRadio Base Station RNRadio Network RRURemote Radio Unit   R   O N   I P R 6/1543-1/LZA 905 5680 © Ericsson AB [email protected] 50 SFTPSecure FTP SIFSite Installation File SMRSSoftware Management Repository Services TNTransport Network UPUpgrade Package USBUniversal Serial Bus