Project

General

Profile

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

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
Add picture from clipboard (Maximum size: 48.8 MB)