Project

General

Profile

DUL 20 Configuration » History » Version 6

lynxis, 11/11/2020 10:20 PM

1 1 lynxis
h1. DUL 20 Configuration
2
3
The DUL can be configured via
4
5
* OSS-RC (Ericsson operations support system-radio and core - a centralized server)
6
* EMA (Element Manager - a Windows WebUI utility)
7
* moshell (a javabased command line utility - runs on linux)
8
* ncli (a command line utility which runs on the DUL itself)
9
10
h2. Configuration tools
11
12
h3. EMA - Element Manager
13
14
There are different versions of this tool. An ancient version can be downloaded from the DUL itself:
15
http://169.254.1.10/em/index.html
16
17
h3. ncli
18
19
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.
20
21
h3. moshell
22
23
The most powerful tool to configure the DUL. It loads the ManagedObject on startup. But can also operate offline on backups.
24
See [[moshell]] for further information how to install and use it.
25
26
h2. Backup & Recover
27
28
A backup of the DUL can be created via ftp and serial.
29
The serial is required to boot into the recovery mode.
30
31 3 lynxis
h3. Boot DUL into recovery
32 1 lynxis
33
Configure the serial connection to **9600** baud (alternative **115200**).
34
Restart the DUL by removing the power for 5 seconds.
35
If the connection is working a boot message is shown:
36
<pre>
37 2 lynxis
OSE Delta PowerPC/BL410660
38
Start of @(#)CXC1729957 R80L37 2013-02-01 10:34:51 GMT
39
Plug-in Unit Product Name:   DUL2001
40
Plug-in Unit Product No:     KDU137533/4
41
Plug-in Unit Product rev:    R1F
42
Plug-in Unit Product Date:   20120402
43
Plug-in Unit Product Serial: XXXXXXXXXX
44
Ethernet MAC_address 0:      0x3CCAFFEE2342
45
RAM size:                    1024 Mbytes
46 1 lynxis
</pre>
47
48
Press enter to show the login prompt `username`.
49
50
Login using username "rbs" and password "rbs".
51
<pre>
52 2 lynxis
username: rbs
53
password:
54
Welcome to OSE Shell OSE5.5.
55
$
56 1 lynxis
</pre>
57
Enter the recovery state:
58
59
<pre>
60 2 lynxis
$ reload --
61
[..]
62
Stop due to remain in basic/backup set
63 1 lynxis
</pre>
64
65
Verify the address of the LMT B interface.
66
67
<pre>
68 2 lynxis
$ ifconfig
69
le0: inet 169.254.1.10 netmask 255.255.0.0 broadcast 169.254.255.255
70 1 lynxis
</pre>
71
72
If the address is not correct, the address can be set by:
73
74
<pre>
75 2 lynxis
$ ifconfig le0 169.254.1.10 netmask 255.255.0.0
76 1 lynxis
</pre>
77
78
The DUL should be reachable by icmp/ping and ftp.
79
80 4 lynxis
h3. Backup
81 1 lynxis
82 3 lynxis
Backup the "partitions" /c and /d from the DUL to be safe.
83
/c and /d contains configuration and system files, application and firmwares.
84
The DUL supports a ftp service.
85
86
Mount the volume of c2 on the DUL first.
87
88
<pre>
89
$ mount_c2
90
$
91
</pre>
92
93
Use your local ftp terminal to get all data. Either graphical client or text.
94
As an example **gftp** (text version) is used in a terminal on the laptop.
95
96
<pre>
97
linux ~> mkdir backup ; cd backup
98
linux ~> gftp rbs:rbs@169.254.1.10
99
</pre>
100
101
<pre>
102
linux ~> gftp 169.254.1.10
103
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
104
my website at http://www.gftp.org/
105
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
106
107
Looking up 169.254.1.10
108
Trying 169.254.1.10:21
109
Connected to 169.254.1.10:21
110
220 Welcome to OSE FTP server (Version ose5.3).
111
USER rbs
112
230 User logged in.
113
SYST
114
215 UNIX system type.
115
TYPE I
116
200 Command OK.
117
PWD
118
257 "/" is current directory.
119
ftp>
120
</pre>
121
Copy /c2 and /d recursive.
122
123
<pre>
124
ftp> mget c2
125
[..]
126
127
ftp> mget d
128
[..]
129
</pre>
130
Depending on the software version and configuration the size can vary. E.g. 300 MB - 800 MB.
131
132
Restart the node into normal operation.
133
134
<pre>
135
$ reload
136 1 lynxis
</pre>
137 4 lynxis
138
h2. Recovery
139
140
Ensure the DUL is booted into recovery.
141
142
<pre>
143
$ reload --
144
$ mount_c2
145
146
$ formathd /c2
147
> y
148
$ formathd /d
149
> y
150
151
$ reload --
152
$ ifconfig le0 169.254.1.10 netmask 255.255.0.0
153
</pre>
154
155
Use ftp to copy files towards the DUL
156
<pre>
157
linux ~> gftp 169.254.1.10
158
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
159
my website at http://www.gftp.org/
160
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
161
162
Looking up 169.254.1.10
163
Trying 169.254.1.10:21
164
Connected to 169.254.1.10:21
165
220 Welcome to OSE FTP server (Version ose5.3).
166
USER rbs
167
230 User logged in.
168
SYST
169
215 UNIX system type.
170
TYPE I
171
200 Command OK.
172
PWD
173
257 "/" is current directory.
174
ftp>
175
</pre>
176
177
Copy /c2 and /d recursive.
178
179
<pre>
180
ftp> mput c2
181
[..]
182
183
ftp> mput d
184
[..]
185
</pre>
186
187
Restart the DUL into normal operation.
188
189
<pre>
190
reload
191
</pre>
192
193 3 lynxis
194 1 lynxis
h2. Understanding ManagedObjects
195 3 lynxis
196
**TODO**
197 1 lynxis
198
h2. Step-by-Step Configuration Howto using the moshell.
199 5 lynxis
200
h2. Configure a DUL from the scratch [L13A]
201
202
Ericsson created the so-called moshell (managed object shell). It
203
is a utility using java, bash, awk, perl, ssh.
204
205
This howto is for L13A release. You can check the release of the DUL with the moshell.
206
207
<pre>
208
moshell> cvls
209
210
[...]
211
===================================================================================================================
212
201111-16:36            CV Name                                   Upgrade Package       Release
213
===================================================================================================================
214
Startable:              selfconfig_autocreated1                   CXP102051/18_R23BM    L13A (C13.0-EP7)
215
Loaded:                 selfconfig_autocreated1                   CXP102051/18_R23BM    L13A (C13.0-EP7)
216
Executing:              selfconfig_autocreated1                   CXP102051/18_R23BM    L13A (C13.0-EP7)
217
Last created:           selfconfig_autocreated1                   CXP102051/18_R23BM    L13A (C13.0-EP7)
218
-------------------------------------------------------------------------------------------------------------------
219
[...]
220
</pre>
221
222
h2. Cleanup old states
223
224
The DUL doesn't support a factory reset method other than installing the software from the scratch using the Recovery method.
225
The following howto cleans up most of the old state.
226
227
<pre>
228
# load full mom tree
229
lt all
230
231
# do not ask for confirmation
232
uv del_confirmation=0
233
uv bldebset_confirmation=0
234
235
bl IpSystem=1,IpSec
236
del IpSystem=1,IpSec
237
238
# returns errors if no ntp is defined
239
acc ManagedElementData=1 deleteNtpThird
240
acc ManagedElementData=1 deleteNtpSecondary
241
acc ManagedElementData=1 deleteNtpPrimary
242
243
# remove all cells
244
rdel ENodeBFunction=1,EUtranCellFDD
245
rdel ENodeBFunction=1,Cdma2000Network
246
rdel ENodeBFunction=1,GeraNetwork
247
rdel ENodeBFunction=1,UtraNetwork
248
249
# clear old MO from EnodeBFunction to recreate the refMos
250
set ENodeBFunction=1 upIpAccessHostRef
251
set ENodeBFunction=1 sctpRef
252
253
del TransportNetwork=1,Sctp=1
254
255
# clean up synchronizsation
256
set TimingUnit gpsOutEnabled false
257
# get a list of activated synchronisations
258
get Synchronization=1
259
# remove all entries with `syncReference =`
260
accn Synchronization=1 removeSyncRefResource IpSystem=1,IpAccessHostEt=1,IpSyncRef=1
261
accn Synchronization=1 removeSyncRefResource Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=1
262
del TuSyncRef
263
del IpSyncRef
264
265
# remove remaining Ip Mo
266
del IpSystem=1,IpAccessSctp
267
del IpSystem=1,IpAccessHostEt
268
269
# ensure the NodeIp is set to 169.254.1.10
270
get IpOam=1,Ip=1,EthernetLink=1
271
# check ipv4Addresses => 169.254.1.10 prefix = 16
272
# if not, set it
273
# ensure the nodeInterfaceName is set to le0
274
get IpOam=1,Ip=1 nodeInterfaceName
275
set IpOam=1,Ip=1 nodeInterfaceName le0
276
# The IP now changing. exit moshell and reconnect.
277
278
del IpOam=1,Ip=1,IpHostLink
279
del Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface
280
del Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1
281
# clean up the equipment
282
del ENodeBFunction=1,SectorCarrier
283
bl SectorEquipmentFunction
284
del SectorEquipmentFunction
285
rdel Equipment=1,AntennaUnitGroup
286
287
# remove all connection of the DUL CPRI ports
288
get Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,RiPort remoteRiPortRef
289
set Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,RiPort remoteRiPortRef
290
291
# check for RRUS
292
lpr Equipment=1,AuxPlugInUnit
293
# if only RUS/RRUS appear, remove them
294
rdel Equipment=1,AuxPlugInUnit
295
296
# check for RUS
297
lpr Equipment=1
298
# remove other old RUS
299
</pre>
300
301
h3. setup an empty node
302
303
**It's unsure to what the license is bound. It's expected to bound to a uniqueName or the logicalName.
304
  License issues will show up in the alarm list `al`.**
305
306
<pre>
307 6 lynxis
set ManagedElement=1 userLabel somesite-01
308 5 lynxis
309 6 lynxis
# create network interface. PortNo defines SFP or Ethernet
310
cr Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1
311
    Attribute 1 of 3, dscpPbitMap (sequence:structRef-DscpPbit): d
312
    Attribute 2 of 3, linkType (enumRef:LinkType):
313
    Enter one of the following integers: 0:FRONT_PORTS, 1:BACKPLANE_PORTS: 0
314
    Attribute 3 of 3, portNo (long): 2
315 5 lynxis
316 6 lynxis
cr Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface=1
317
    Attribute 1 of 2, networkPrefixLength (long): 24
318
    Attribute 2 of 2, defaultRouter0 (string): 10.23.0.1
319
    Following attributes are optional. Enter attribute value or "d" for default.
320
    Once the MO is created, these attributes cannot be changed (they are restricted).
321
    Attribute 1 of 5, ownIpAddressActive (string): d
322
    Attribute 2 of 5, ownIpAddressPassive (string): d
323
    Attribute 3 of 5, rps (boolean): false
324
    Attribute 4 of 5, vlanRef (moRef:ManagedObject):
325
        Enter mo LDN:
326
    Attribute 5 of 5, mtu (long): 1500
327 5 lynxis
328 6 lynxis
# set OAM IP
329
cr Ip=1,IpHostLink=1
330
    Attribute 1 of 1, ipInterfaceMoRef (moRef:ManagedObject):
331
    Enter mo LDN: Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface=1
332
set Ip=1,IpHostLink=1 ipv4Addresses 10.23.0.199
333 5 lynxis
334 6 lynxis
# set eNodeB IP
335
cr IpSystem=1,IpAccessHostEt=1
336
    Attribute 1 of 2, ipAddress (string): 10.23.0.198
337
    Attribute 2 of 2, ipInterfaceMoRef (moRef:ManagedObject):
338
       Enter mo LDN: Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1,IpInterface=1
339
    Following attributes are optional. Enter attribute value or "d" for default.
340
    Once the MO is created, these attributes cannot be changed (they are restricted).
341
    Attribute 1 of 1, networkPrefixLength (long): 24
342 5 lynxis
343 6 lynxis
cr IpSystem=1,IpAccessSctp=1
344
    Attribute 1 of 1, ipAccessHostEtRef1 (moRef:IpAccessHostEt):
345
       Enter mo LDN: IpSystem=1,IpAccessHostEt=1
346 5 lynxis
347
348 6 lynxis
# ntp settings
349
accn ManagedElementData createNtpPrimary 10.23.0.2 16 1024 true true
350
accn ManagedElementData createNtpSecondary 10.23.0.3 16 1024 true true
351 5 lynxis
352 6 lynxis
# optional allow ntp sync for clock ref
353
cr IpSystem=1,IpAccessHostEt=1,IpSyncRef=1
354
    Following attributes are optional. Enter attribute value or "d" for default.
355
    Once the MO is created, these attributes cannot be changed (they are restricted).
356
    Attribute 1 of 1, ntpServerIpAddress (string): 10.23.0.2
357 5 lynxis
358 6 lynxis
cr IpSystem=1,IpAccessHostEt=1,IpSyncRef=2
359
    Following attributes are optional. Enter attribute value or "d" for default.
360
    Once the MO is created, these attributes cannot be changed (they are restricted).
361
    Attribute 1 of 1, ntpServerIpAddress (string): 10.23.0.3
362
accn Synchronization=1 addSyncRefResource IpSystem=1,IpAccessHostEt=1,IpSyncRef=1 3
363
accn Synchronization=1 addSyncRefResource IpSystem=1,IpAccessHostEt=1,IpSyncRef=2 4
364
deb IpSystem=1,IpAccessHostEt=1,IpSyncRef=1
365
deb IpSystem=1,IpAccessHostEt=1,IpSyncRef=2
366 5 lynxis
367 6 lynxis
# only GPS or external clock can be used.
368
## external clock sync (untested). See `mom TuSyncRef` for more info about Tu
369
# cr Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=1
370
# accn Synchronization=1 addSyncRefResource Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=1 1
371
# deb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2
372 5 lynxis
373 6 lynxis
# gps sync
374
cr Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2
375
accn Synchronization=1 addSyncRefResource Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2 2
376
deb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2
377 5 lynxis
378
379 6 lynxis
# create sctp nodes
380
cr TransportNetwork=1,Sctp=1
381
    Attribute 1 of 2, numberOfAssociations (long): 10
382
    Attribute 2 of 2, rpuId (moRef:ReliableProgramUniter):
383
       Enter mo LDN: ReliableProgramUniter=sctp_host
384
set TransportNetwork=1,Sctp=1 ipAccessSctpRef IpSystem=1,IpAccessSctp=1
385 5 lynxis
386 6 lynxis
# setup ENodeBFunction
387
# there might be old values
388
get ENodeBFunction
389 5 lynxis
390 6 lynxis
# part of Cell Global Identity
391
set ENodeBFunction=1 eNBId 2342
392
set ENodeBFunction=1 sctpRef TransportNetwork=1,Sctp=1
393
set ENodeBFunction=1 eNodeBPlmnId mcc=901,mnc=70,mncLength=2
394
set ENodeBFunction=1 upIpAccessHostRef IpSystem=1,IpAccessHostEt=1
395 5 lynxis
396 6 lynxis
# s1 link
397
cr ENodeBFunction=1,TermPointToMme=1
398
# a second ip can be also set or an domainName
399
set ENodeBFunction=1,TermPointToMme=1 ipAddress1 10.23.0.2
400
deb ENodeBFunction=1,TermPointToMme=1
401 5 lynxis
402 6 lynxis
# setup the hardware equipment
403
# create a subrack
404
cr Equipment=1,RbsSubrack=1
405
    Following attributes are optional. Enter attribute value or "d" for default.
406
    Once the MO is created, these attributes cannot be changed (they are restricted).
407
    Attribute 1 of 1, noOfSlots (long): d
408 5 lynxis
409 6 lynxis
# should not be needed, this SwAllocation should be already present
410
get SwManagement=1,SwAllocation=RBS_RU
411
# cr SwManagement=1,SwAllocation=RBS_RU
412
# accn SwManagement=1,SwAllocation=RBS_RU addRepertoire SwManagement=1,Repertoire=LTE_RBS_RU
413 5 lynxis
414 6 lynxis
# the dul needs to support this specific RUS/RRUS. Take a look on the installed RUS/RRUS productNumber
415
# in this case KRC11875
416
# check if this RUS is supported
417
lpr KRC11875
418
# SwManagement=1,PiuType=KRC11875/1_*
419
# should return a MO, this MO is required when adding a new antenna setup
420
cr Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1
421
    Attribute 1 of 1, piuType (moRef:PiuType):
422
    Enter mo LDN: PiuType=KRC11875/1_*
423 5 lynxis
424 6 lynxis
# connect the RUS Data 1 port to the DUL RiPort A
425
set Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,RiPort=DATA_1 remoteRiPortRef Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,RiPort=A
426 5 lynxis
427 6 lynxis
# create antennagroup
428
cr Equipment=1,AntennaUnitGroup=1
429 5 lynxis
430 6 lynxis
cr Equipment=1,AntennaUnitGroup=1,RfBranch=1
431
    Attribute 1 of 2, dlAttenuation (sequence:long):
432
    Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
433
    Attribute 2 of 2, ulAttenuation (sequence:long):
434
    Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
435
cr Equipment=1,AntennaUnitGroup=1,RfBranch=2
436
    Attribute 1 of 2, dlAttenuation (sequence:long):
437
    Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
438
    Attribute 2 of 2, ulAttenuation (sequence:long):
439
    Enter value or sequence of values, separated by ,: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
440
cr Equipment=1,AntennaUnitGroup=1,AntennaUnit=1
441 5 lynxis
442 6 lynxis
# connect the Antenna with the RUS
443
set Equipment=1,AntennaUnitGroup=1,RfBranch=1 rfPortRef Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,DeviceGroup=ru,RfPort=A
444
set Equipment=1,AntennaUnitGroup=1,RfBranch=2 rfPortRef Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,DeviceGroup=ru,RfPort=b
445 5 lynxis
446 6 lynxis
# unblock the RUS
447
deb Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1,DeviceGroup=ru,RfPort=A
448 5 lynxis
449 6 lynxis
# create sectorequipment function
450
cr SectorEquipmentFunction=1
451
# on older setup this is in W, on newer this is in mW ###
452
# use mom SectorEquipmentFunction configuredOutputPower to know it#
453
set SectorEquipmentFunction=1 confOutputPower 20
454 5 lynxis
455 6 lynxis
# connect Sector Function to the antenna
456
set SectorEquipmentFunction rfBranchRef Equipment=1,AntennaUnitGroup=1,RfBranch=1
457 5 lynxis
458 6 lynxis
cr ENodeBFunction=1,SectorCarrier=1
459
    Attribute 1 of 1, sectorFunctionRef (moRef:SectorEquipmentFunction):
460
    Enter mo LDN: SectorEquipmentFunction=1
461
set ENodeBFunction=1,SectorCarrier=1 noOfRxAntennas 1
462
set ENodeBFunction=1,SectorCarrier=1 noOfTxAntennas 1
463 5 lynxis
464 6 lynxis
# create cell
465
cr ENodeBFunction=1,EUtranCellFDD=1
466
    Attribute 1 of 6, earfcndl (long): 300
467
    Attribute 2 of 6, earfcnul (long): 18300
468
    Attribute 3 of 6, cellId (long): 1
469
    Attribute 4 of 6, physicalLayerCellIdGroup (long): 1
470
    Attribute 5 of 6, physicalLayerSubCellId (long): 1
471
    Attribute 6 of 6, tac (long): 1
472
    Following attributes are optional. Enter attribute value or "d" for default.
473
    Once the MO is created, these attributes cannot be changed (they are restricted).
474
    Attribute 1 of 5, sectorCarrierRef (sequence:moRef-SectorCarrier):
475
       Enter LDN, or sequence of LDNs (separated by spaces): ENodeBFunction=1,SectorCarrier=1
476
    Attribute 2 of 5, dlChannelBandwidth (long): d
477
    Attribute 3 of 5, ulChannelBandwidth (long): d
478
    Attribute 4 of 5, additionalPlmnList (sequence:structRef-PlmnIdentity): d
479
    Attribute 5 of 5, additionalPlmnReservedList (sequence:boolean):
480
       Enter value or sequence of values, separated by ,: d
481 5 lynxis
482 6 lynxis
# Check the status of all nodes
483
st
484
# most of the MO should be unlocked and enabled.
485
# ensure all important nodes are unlocked
486
ldeb ENodeBFunction=1,EUtranCellFDD=1
487
ldeb ENodeBFunction=1,TermPointToMme=1
488
ldeb SectorEquipmentFunction=1
489
ldeb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,ExchangeTerminalIp=1,GigaBitEthernet=1
490
ldeb Equipment=1,Subrack=1,Slot=1,PlugInUnit=1,TimingUnit=1,TuSyncRef=2
491
ldeb Equipment=1,RbsSubrack=1,RbsSlot=1,AuxPlugInUnit=1
492 5 lynxis
493 6 lynxis
# finally create a new configuration version otherwise everything is lost after a restart
494
cvms singlecell moshell
495 5 lynxis
</pre>
Add picture from clipboard (Maximum size: 48.8 MB)