DUL 20 Configuration¶
The DUL can be configured via
- OSS-RC (Ericsson operations support system-radio and core - a centralized server)
- EMA (Element Manager - a Windows WebUI utility)
- moshell (a java based command line utility - runs on linux)
- ncli (a command line utility which runs on the DUL itself)
Configuration tools¶
EMA - Element Manager¶
There are different versions of this tool. An ancient version can be downloaded from the DUL itself:
http://169.254.1.10/em/index.html
ncli¶
With the ncli basic operations can be performed. However the ncli usually doesn't have a ManagedObject tree loaded which means it doesn't know which attributes an ManagedObject can have.
moshell¶
The most powerful tool to configure the DUL. It loads the ManagedObject on startup. But can also operate offline on backups.
See moshell for further information.
Backup & Recover¶
A backup of the DUL can be created via ftp and serial.
The serial is required to boot into the recovery mode.
Boot DUL into recovery¶
Configure the serial connection to 9600 baud (alternative 115200).
Restart the DUL by removing the power for 5 seconds.
If the connection is working a boot message is shown:
OSE Delta PowerPC/BL410660 Start of @(#)CXC1729957 R80L37 2013-02-01 10:34:51 GMT Plug-in Unit Product Name: DUL2001 Plug-in Unit Product No: KDU137533/4 Plug-in Unit Product rev: R1F Plug-in Unit Product Date: 20120402 Plug-in Unit Product Serial: XXXXXXXXXX Ethernet MAC_address 0: 0x3CCAFFEE2342 RAM size: 1024 Mbytes
Press enter to show the login prompt `username`.
Login using username "rbs" and password "rbs".
username: rbs password: Welcome to OSE Shell OSE5.5. $
Enter the recovery state:
$ reload -- [..] Stop due to remain in basic/backup set
Verify the address of the LMT B interface.
$ ifconfig le0: inet 169.254.1.10 netmask 255.255.0.0 broadcast 169.254.255.255
If the address is not correct, the address can be set by:
$ ifconfig le0 169.254.1.10 netmask 255.255.0.0
The DUL should be reachable by icmp/ping and ftp.
Backup¶
Backup the "partitions" /c and /d from the DUL to be safe.
/c and /d contains configuration and system files, application and firmwares.
The DUL supports a ftp service.
Note: /c is mounted as /c2 in the recovery.
Mount the volume of c2 on the DUL first.
$ mount_c2 $
Use your local ftp terminal to get all data. Either graphical client or text.
As an example gftp (text version) is used in a terminal on the laptop.
linux ~> mkdir backup ; cd backup linux ~> gftp rbs:rbs@169.254.1.10
linux ~> gftp 169.254.1.10 gFTP 2.0.19, Copyright (C) 1998-2008 Brian Masney <masneyb@gftp.org>. If you have any questions, comments, or suggestions about this program, please feel free to email them to me. You can always find out the latest news about gFTP from my website at http://www.gftp.org/ gFTP comes with ABSOLUTELY NO WARRANTY; for details, see the COPYING file. This is free software, and you are welcome to redistribute it under certain conditions; for details, see the COPYING file Looking up 169.254.1.10 Trying 169.254.1.10:21 Connected to 169.254.1.10:21 220 Welcome to OSE FTP server (Version ose5.3). USER rbs 230 User logged in. SYST 215 UNIX system type. TYPE I 200 Command OK. PWD 257 "/" is current directory. ftp>
Copy /c2 and /d recursive.
ftp> mget c2 [..] ftp> mget d [..]
Depending on the software version and configuration the size can vary. E.g. 300 MB - 800 MB.
Restart the node into normal operation.
$ reload
Recovery¶
Ensure the DUL is booted into recovery.
$ reload -- $ mount_c2 $ formathd /c2 > y $ formathd /d > y $ reload -- $ ifconfig le0 169.254.1.10 netmask 255.255.0.0
Use ftp to copy files towards the DUL
linux ~> gftp 169.254.1.10 gFTP 2.0.19, Copyright (C) 1998-2008 Brian Masney <masneyb@gftp.org>. If you have any questions, comments, or suggestions about this program, please feel free to email them to me. You can always find out the latest news about gFTP from my website at http://www.gftp.org/ gFTP comes with ABSOLUTELY NO WARRANTY; for details, see the COPYING file. This is free software, and you are welcome to redistribute it under certain conditions; for details, see the COPYING file Looking up 169.254.1.10 Trying 169.254.1.10:21 Connected to 169.254.1.10:21 220 Welcome to OSE FTP server (Version ose5.3). USER rbs 230 User logged in. SYST 215 UNIX system type. TYPE I 200 Command OK. PWD 257 "/" is current directory. ftp>
Copy /c2 and /d recursive.
ftp> mput c2 [..] ftp> mput d [..]
Restart the DUL into normal operation.
reload
Understanding ManagedObjects¶
TODO Expand this section
The Configuration Version (CV)¶
The digital unit can store multiple configurations, known as configuration versions, and confguration is not automatically persisted/saved. The cv command provides low level access to operations for managing the loaded and applied CV. Moshell also provides higher-level commands for managing CVs. The cvls command shows the current configuration state and the list of all available configurations. The cvget command can be used to download a CV from the unit to the local terminal for backup. cvmk stores a new CV from the current configuration state, and cvset sets the CV which will be applied to all system components (including attached hardware) on next startup. cvms combines cvmk and cvset into a single command, persisting the current configuration and designating it to be applied on next startup.
Step-by-Step Configuration Howto using the moshell.¶
This howto is for L13A release. You can check the release of the DUL with the moshell.
moshell> cvls [...] =================================================================================================================== 201111-16:36 CV Name Upgrade Package Release =================================================================================================================== Startable: selfconfig_autocreated1 CXP102051/18_R23BM L13A (C13.0-EP7) Loaded: selfconfig_autocreated1 CXP102051/18_R23BM L13A (C13.0-EP7) Executing: selfconfig_autocreated1 CXP102051/18_R23BM L13A (C13.0-EP7) Last created: selfconfig_autocreated1 CXP102051/18_R23BM L13A (C13.0-EP7) ------------------------------------------------------------------------------------------------------------------- [...]
Cleanup old states¶
The DUL doesn't support a factory reset method other than installing the software from the scratch using the Recovery method.
The following howto cleans up most of the old state.
# load full mom tree lt all # do not ask for confirmation uv del_confirmation=0 uv bldebset_confirmation=0 bl IpSystem=1,IpSec del IpSystem=1,IpSec # returns errors if no ntp is defined acc ManagedElementData=1 deleteNtpThird acc ManagedElementData=1 deleteNtpSecondary acc ManagedElementData=1 deleteNtpPrimary # remove all cells rdel ENodeBFunction=1,EUtranCellFDD rdel ENodeBFunction=1,Cdma2000Network rdel ENodeBFunction=1,GeraNetwork rdel ENodeBFunction=1,UtraNetwork # clear old MO from EnodeBFunction to recreate the refMos set ENodeBFunction=1 upIpAccessHostRef set ENodeBFunction=1 sctpRef del TransportNetwork=1,Sctp=1 # clean up synchronizsation set TimingUnit gpsOutEnabled false # get a list of activated synchronisations get Synchronization=1 # remove all entries with `syncReference =` accn Synchronization=1 removeSyncRefResource IpSystem=1,IpAccessHostEt=1,IpSyncRef=1 accn Synchronization=1 removeSyncRefResource Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=1 del TuSyncRef del IpSyncRef # remove remaining Ip Mo del IpSystem=1,IpAccessSctp del IpSystem=1,IpAccessHostEt # ensure the NodeIp is set to 169.254.1.10 get IpOam=1,Ip=1,EthernetLink=1 # check ipv4Addresses => 169.254.1.10 prefix = 16 # if not, set it # ensure the nodeInterfaceName is set to le0 get IpOam=1,Ip=1 nodeInterfaceName set IpOam=1,Ip=1 nodeInterfaceName le0 # The IP now changing. exit moshell and reconnect. del IpOam=1,Ip=1,IpHostLink del Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface del Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1 # clean up the equipment del ENodeBFunction=1,SectorCarrier bl SectorEquipmentFunction del SectorEquipmentFunction rdel Equipment=1,AntennaUnitGroup # remove all connection of the DUL CPRI ports get Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,RiPort remoteRiPortRef set Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,RiPort remoteRiPortRef # check for RRUS lpr Equipment=1,AuxPlugInUnit # if only RUS/RRUS appear, remove them rdel Equipment=1,AuxPlugInUnit # check for RUS lpr Equipment=1 # remove other old RUS
setup an empty node¶
It's unsure to what the license is bound. It's expected to bound to a uniqueName or the logicalName.
License issues will show up in the alarm list `al`.
# load full mom tree lt all # do not ask for confirmation uv del_confirmation=0 uv bldebset_confirmation=0 set ManagedElement=1 userLabel somesite-01 # create network interface. PortNo defines SFP or Ethernet cr Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1 Attribute 1 of 3, dscpPbitMap (sequence:structRef-DscpPbit): d Attribute 2 of 3, linkType (enumRef:LinkType): Enter one of the following integers: 0:FRONT_PORTS, 1:BACKPLANE_PORTS: 0 Attribute 3 of 3, portNo (long): 2 cr Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface=1 Attribute 1 of 2, networkPrefixLength (long): 24 Attribute 2 of 2, defaultRouter0 (string): 10.23.0.1 Following attributes are optional. Enter attribute value or "d" for default. Once the MO is created, these attributes cannot be changed (they are restricted). Attribute 1 of 5, ownIpAddressActive (string): d Attribute 2 of 5, ownIpAddressPassive (string): d Attribute 3 of 5, rps (boolean): false Attribute 4 of 5, vlanRef (moRef:ManagedObject): Enter mo LDN: Attribute 5 of 5, mtu (long): 1500 # set OAM IP cr Ip=1,IpHostLink=1 Attribute 1 of 1, ipInterfaceMoRef (moRef:ManagedObject): Enter mo LDN: Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface=1 set Ip=1,IpHostLink=1 ipv4Addresses 10.23.0.199 # set eNodeB IP cr IpSystem=1,IpAccessHostEt=1 Attribute 1 of 2, ipAddress (string): 10.23.0.198 Attribute 2 of 2, ipInterfaceMoRef (moRef:ManagedObject): Enter mo LDN: Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface=1 Following attributes are optional. Enter attribute value or "d" for default. Once the MO is created, these attributes cannot be changed (they are restricted). Attribute 1 of 1, networkPrefixLength (long): 24 cr IpSystem=1,IpAccessSctp=1 Attribute 1 of 1, ipAccessHostEtRef1 (moRef:IpAccessHostEt): Enter mo LDN: IpSystem=1,IpAccessHostEt=1 # ntp settings accn ManagedElementData createNtpPrimary 10.23.0.2 16 1024 true true accn ManagedElementData createNtpSecondary 10.23.0.3 16 1024 true true # optional allow ntp sync for clock ref with low priority cr IpSystem=1,IpAccessHostEt=1,IpSyncRef=1 Following attributes are optional. Enter attribute value or "d" for default. Once the MO is created, these attributes cannot be changed (they are restricted). Attribute 1 of 1, ntpServerIpAddress (string): 10.23.0.2 cr IpSystem=1,IpAccessHostEt=1,IpSyncRef=2 Following attributes are optional. Enter attribute value or "d" for default. Once the MO is created, these attributes cannot be changed (they are restricted). Attribute 1 of 1, ntpServerIpAddress (string): 10.23.0.3 accn Synchronization=1 addSyncRefResource IpSystem=1,IpAccessHostEt=1,IpSyncRef=1 3 accn Synchronization=1 addSyncRefResource IpSystem=1,IpAccessHostEt=1,IpSyncRef=2 4 deb IpSystem=1,IpAccessHostEt=1,IpSyncRef=1 deb IpSystem=1,IpAccessHostEt=1,IpSyncRef=2 # only GPS or external clock can be used. ## external clock sync (untested). See `mom TuSyncRef` for more info about Tu # cr Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=1 # accn Synchronization=1 addSyncRefResource Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=1 1 # deb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2 # gps sync with high priority cr Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2 accn Synchronization=1 addSyncRefResource Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2 2 deb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2 # create sctp nodes cr TransportNetwork=1,Sctp=1 Attribute 1 of 2, numberOfAssociations (long): 10 Attribute 2 of 2, rpuId (moRef:ReliableProgramUniter): Enter mo LDN: ReliableProgramUniter=sctp_host set TransportNetwork=1,Sctp=1 ipAccessSctpRef IpSystem=1,IpAccessSctp=1 # setup ENodeBFunction # there might be old values get ENodeBFunction # part of Cell Global Identity set ENodeBFunction=1 eNBId 2342 set ENodeBFunction=1 sctpRef TransportNetwork=1,Sctp=1 set ENodeBFunction=1 eNodeBPlmnId mcc=901,mnc=70,mncLength=2 set ENodeBFunction=1 upIpAccessHostRef IpSystem=1,IpAccessHostEt=1 # s1 link cr ENodeBFunction=1,TermPointToMme=1 # a second ip can be also set or an domainName set ENodeBFunction=1,TermPointToMme=1 ipAddress1 10.23.0.2 deb ENodeBFunction=1,TermPointToMme=1 # setup the hardware equipment # create a subrack cr Equipment=1,RbsSubrack=1 Following attributes are optional. Enter attribute value or "d" for default. Once the MO is created, these attributes cannot be changed (they are restricted). Attribute 1 of 1, noOfSlots (long): d # should not be needed, this SwAllocation should be already present get SwManagement=1,SwAllocation=RBS_RU # cr SwManagement=1,SwAllocation=RBS_RU # accn SwManagement=1,SwAllocation=RBS_RU addRepertoire SwManagement=1,Repertoire=LTE_RBS_RU # the dul needs to support this specific RUS/RRUS. Take a look on the installed RUS/RRUS productNumber # in this case KRC11875 # check if this RUS is supported lpr KRC11875 # SwManagement=1,PiuType=KRC11875/1_* # should return a MO, this MO is required when adding a new antenna setup cr Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1 Attribute 1 of 1, piuType (moRef:PiuType): Enter mo LDN: PiuType=KRC11875/1_* # connect the RUS Data 1 port to the DUL RiPort A set Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,RiPort=DATA_1 remoteRiPortRef Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,RiPort=A # create antennagroup cr Equipment=1,AntennaUnitGroup=1 cr Equipment=1,AntennaUnitGroup=1,RfBranch=1 Attribute 1 of 2, dlAttenuation (sequence:long): Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 Attribute 2 of 2, ulAttenuation (sequence:long): Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 cr Equipment=1,AntennaUnitGroup=1,RfBranch=2 Attribute 1 of 2, dlAttenuation (sequence:long): Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 Attribute 2 of 2, ulAttenuation (sequence:long): Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 cr Equipment=1,AntennaUnitGroup=1,AntennaUnit=1 # connect the Antenna with the RUS set Equipment=1,AntennaUnitGroup=1,RfBranch=1 rfPortRef Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,DeviceGroup=ru,RfPort=A set Equipment=1,AntennaUnitGroup=1,RfBranch=2 rfPortRef Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,DeviceGroup=ru,RfPort=b # unblock the RUS deb Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,DeviceGroup=ru,RfPort=A # create sectorequipment function cr SectorEquipmentFunction=1 # on older setup this is in W, on newer this is in mW ### # use mom SectorEquipmentFunction configuredOutputPower to know it# set SectorEquipmentFunction=1 confOutputPower 20 # connect Sector Function to the antenna set SectorEquipmentFunction rfBranchRef Equipment=1,AntennaUnitGroup=1,RfBranch=1 cr ENodeBFunction=1,SectorCarrier=1 Attribute 1 of 1, sectorFunctionRef (moRef:SectorEquipmentFunction): Enter mo LDN: SectorEquipmentFunction=1 set ENodeBFunction=1,SectorCarrier=1 noOfRxAntennas 1 set ENodeBFunction=1,SectorCarrier=1 noOfTxAntennas 1 # create cell cr ENodeBFunction=1,EUtranCellFDD=1 Attribute 1 of 6, earfcndl (long): 300 Attribute 2 of 6, earfcnul (long): 18300 Attribute 3 of 6, cellId (long): 1 Attribute 4 of 6, physicalLayerCellIdGroup (long): 1 Attribute 5 of 6, physicalLayerSubCellId (long): 1 Attribute 6 of 6, tac (long): 1 Following attributes are optional. Enter attribute value or "d" for default. Once the MO is created, these attributes cannot be changed (they are restricted). Attribute 1 of 5, sectorCarrierRef (sequence:moRef-SectorCarrier): Enter LDN, or sequence of LDNs (separated by spaces): ENodeBFunction=1,SectorCarrier=1 Attribute 2 of 5, dlChannelBandwidth (long): d Attribute 3 of 5, ulChannelBandwidth (long): d Attribute 4 of 5, additionalPlmnList (sequence:structRef-PlmnIdentity): d Attribute 5 of 5, additionalPlmnReservedList (sequence:boolean): Enter value or sequence of values, separated by ,: d # Check the status of all nodes st # most of the MO should be unlocked and enabled. # ensure all important nodes are unlocked ldeb ENodeBFunction=1,EUtranCellFDD=1 ldeb ENodeBFunction=1,TermPointToMme=1 ldeb SectorEquipmentFunction=1 ldeb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1 ldeb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2 ldeb Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1 # check the alarm list al # finally create a new configuration version otherwise everything is lost after a restart cvms singlecell moshell
Updated by matt9j over 1 year ago · 13 revisions