RNC Restoration

For public use IPR applies

1
Nokia Siemens Networks

RN33157EN10GLA0

Nokia Siemens Networks Academy

Legal notice
Intellectual Property Rights
All copyrights and intellectual property rights for Nokia Siemens Networks training documentation,
product documentation and slide presentation material, all of which are forthwith known as Nokia
Siemens Networks training material, are the exclusive property of Nokia Siemens Networks. Nokia
Siemens Networks owns the rights to copying, modification, translation, adaptation or derivatives
including any improvements or developments. Nokia Siemens Networks has the sole right to copy,
distribute, amend, modify, develop, license, sublicense, sell, transfer and assign the Nokia Siemens
Networks training material. Individuals can use the Nokia Siemens Networks training material for their
own personal self-development only, those same individuals cannot subsequently pass on that same
Intellectual Property to others without the prior written agreement of Nokia Siemens Networks. The
Nokia Siemens Networks training material cannot be used outside of an agreed Nokia Siemens
Networks training session for development of groups without the prior written agreement of Nokia
Siemens Networks.

For public use IPR applies

2
Nokia Siemens Networks

RN33157EN10GLA0

Content
RNC File System
Restore RNC from Backup Files

For public use IPR applies

4
Nokia Siemens Networks

RN33157EN10GLA0

RNC File System Overview

MEMORY
PROGRAM
READ/
WRITE
WORK
FILES

READ/
WRITE
MML
PROGRAM

CONFIGURATION
FILES

MEMORY FILE
SYSTEM

LOAD INTO
MEMORY

LOAD INTO
MEMORY

UPDATE
CHANGE ON
DISK

FILES ARE
READ INTO
MEMORY
WHEN MML
PROGRAMS
EXECUTED

WRITING
STRIGHT TO
DISK
COPYING
COPYING

PROGRAM
CODE FILES

DISK

COPIES OF
MEMORY FILES

MML PROGRAM
FILES

MML TEXT
FILES

FILES THAT COME WITH

SOFTWARE BUILD

RING
FILES
FILES
CREATED BY
SYSTEM

DISK FILE SYSTEM

For public use IPR applies

5
Nokia Siemens Networks

RN33157EN10GLA0

1. The system loads program codes from disk to memory

2. The system loads files from disk to memory
3. Programs start
4. Programs begin to use files.

BACKUP
FILES

REMOVABLE
DISK

File Type
Memory file

Characteristics

Unstructured
Actively used
Stored in RAM

Disk file

Structured
Located on hard disk

Fixed file
Contents remain unchanged in
restart

Copy kept on disk

Data cannot be changed

Permanent file
Contents remain unchanged in

File Types

restart

Copy kept on disk

Data can be changed by MML

Work file
Contents are lost in restart
Copy not kept on disk
Data changed by system (phone call,
etc)
For public use IPR applies
6
Nokia Siemens Networks

RN33157EN10GLA0

Program code file

MML program
Data file
Configuration file
Work file
Ring file

Memory File Handling (1/2)

Memory File Handling command group <DF_> in MML.
Available commands:
MAIN LEVEL COMMAND <___>
< DF?
LOADING PROGRAM VERSION 7.6-0
RNC

IPA2800 RNC

2009-01-16

08:45:20

MEMORY FILE HANDLING COMMANDS

?
D:
S:
R:
B:
L:
C:
M:
F:
Z;

For public use IPR applies

7
Nokia Siemens Networks

.....
.....
.....
.....
.....
.....
.....
.....
.....
.....

DISPLAY MENU
DISPLAY FILE OR RECORDS
SUBSTITUTE RECORDS OR SUBRECORDS
MODIFY RESERVATION STATES OF RECORDS
LIST RESERVATION STATES OF RECORDS
LIST FILE INFORMATION
COPY FILE OR FILES TO DISK
COPY FILE OR FILES TO MEMORY
COMPARE FILES
RETURN TO MAIN LEVEL

RN33157EN10GLA0

Memory File Handling (2/2)

One useful command is DFF. This command allows files in a unit to
be compared to those in the disk. This comparison of files can be
between:

Two memory files located in any of the computer units. (Memory

files are identified by file number)

Two disk copies of memory files located in any of the disks (Disk
files are identified by name)

One memory file and one disk file

For public use IPR applies

8
Nokia Siemens Networks

RN33157EN10GLA0

RNC Directory Structure (DMX)

Default (DEF) directory

SCMANA
SOMAFIGX.IMG
Common files

Build_A
Status BU

Root Directory in DMX operating system

Non default (NODEF) directory

Default Flag

Build_B
Status FB

Build_C
Status NW

BLCODE

BLCODE

BLCODE Boot loadable code files

MMDIRE

MMDIRE

MMDIRE

MMDIRE MML program files

LFILES

LFILES

LFILES

LFILES Loadable files and

databases

ASWDIR

ASWDIR

ASWDIR

ASWDIR Application specific

work files

WEBFIL

WEBFIL

WEBFIL

WEBFIL

CONVPR

For public use IPR applies

9
Nokia Siemens Networks

...

BLCODE

SCMANA

Used for Change

Delivery Installation

Build_D
Status UT

CDTEMP

HTTP Server root

directory for Web based
Management

SOMAFIGX.IMG
only Build_B info
with default flag

RN33157EN10GLA0

SCMANA
Software and Configuration Management directory, contains SOMAFI file to let the
RNC system be informed the default SW directory. Up to 8 SW directory can be
recorded in SOMAFI.
BLCODE
The Boot Loadable Code subdirectory contains the program code files and
parameter files that are loaded first into the unit's memory when the computer unit
starts up.
MMDIRE
The MMI system subdirectory includes MML programs and their text files.
LFILES
The Loadable Files subdirectory contains disk copies of memory files and Chorus
program code and Chorus files.
ASWDIR
The Application Specific Work subdirectory is for saving some of the applications'
work files on disk, e.g. for routine measurements. The system itself constructs the
necessary directory and files.
CONVPR
The Conversion Program subdirectory contains the file conversion programs that
are needed to perform software updates.
WEBFIL
The files of the WEBFIL subdirectory and its six additional subdirectories are
needed for the Web Based management of the network element and graphical user
interface GUI.

RNC Restoration
Running SW package failure
MASHAN
POSIX
PACKETGX

System disk failure

For public use IPR applies

10
Nokia Siemens Networks

RN33157EN10GLA0

Running SW Package Failure

In rare situations, it may be necessary to patch directly information to
the disk file before it is loaded to a computer unit
most usual case being patching the default status to a particular SW build in the
SOMAFI file.

Another example is when data (such as the RNC ID) must be changed in the
RNW database.

Various tools exist for patching in the service terminal, including the
use of:
MASHAN
POMOXI
In addition, another extension is available for patching the SOMAFI, which is
named PACKETGX.

For public use IPR applies

11
Nokia Siemens Networks

RN33157EN10GLA0

Patching SOMAFI using MASHAN (1/2)

Only active OMU can use

V command for patching
VD command for directories
VL command for patching with
checksum calculation

FUNCTION

HEXADECIMAL

ASCII

cursor moves
horizontally

in half bytes

in bytes

data input characters

only
hexadecimal

Any
characters

For public use IPR applies

12
Nokia Siemens Networks

RN33157EN10GLA0

The V-commands recognise the

following keyboard code sequences:
Ctrl-C - end of editing
Ctrl-D - directory patching help
Ctrl-E - editor help
Ctrl-G - cursor to desired block.
Ctrl-N - next block
Ctrl-P - previous block
TAB - ASCII/hexadecimal input
arrow up - line up (= 16 bytes left)
arrow down - line down (= 16 bytes
right)
arrow left - byte left
arrow right - byte right
HOME - cursor to 1st byte of block

Patching SOMAFI using MASHAN (1/2)

MAS> V:W1-ABCDEF.ABC,5,10
BLOCK NO: 0005
FROM:
00 01 02 03 04 05 06 07
0000: XX XX XX XX XX XX XX XX
0010: XX XX XX XX XX XX XX XX
0020: XX XX XX XX XX XX XX XX
.
.
.
00F0: XX XX XX XX XX XX XX XX

W1-ABCDEF
08 09 0A 0B
XX XX XX XX
XX XX XX XX
XX XX XX XX

0C
XX
XX
XX

.ABC
0D 0E
XX XX
XX XX
XX XX

0F
XX
XX
XX

0123456789ABCDEF
................
................
................

XX XX XX XX XX XX XX XX ................

MAS> VD:W0,5

BLOCK NO: 0023

0000:
0010:
0020:

00F0:

00
XX
XX
XX

01
XX
XX
XX

02
XX
XX
XX

03
XX
XX
XX
.
.
.
XX XX XX XX

FROM:
04
XX
XX
XX

05
XX
XX
XX

06
XX
XX
XX

07
XX
XX
XX

W0-DIRECTORY
08
XX
XX
XX

09
XX
XX
XX

0A
XX
XX
XX

0B
XX
XX
XX

RN33157EN10GLA0

.DIR
0D
XX
XX
XX

0E
XX
XX
XX

0F
XX
XX
XX

0123456789ABCDEF
................
................
................

XX XX XX XX XX XX XX XX XX XX XX XX ................

CHECKSUM; CALCULATED: XXXX, IN BLOCK: XXXX

For public use IPR applies

13
Nokia Siemens Networks

0C
XX
XX
XX

FAIL

Patching SOMAFI using POSIX

POMOXI extension gives access to POSIX subsystem
With POMOXI can access disk during mini-debugger

PO M O X I - T he boss around the PO SIX subsystem

? ..... H E L P
B ..... C R E A T E A PO SIX PR O C E SS
K ..... K E R N E L IN T E R N A L S
S ..... SH E L L C O M M A N D S
T ..... H E L P O N T Y PE S
X ..... R E L E A SE T H E PO SIX C O N T E X T
Z ..... E X IT
00:PO M > ?S

For public use IPR applies

14
Nokia Siemens Networks

RN33157EN10GLA0

Patching SOMAFI using PACKETGX (1/2)

Possible to use in the
debugger state
Not in minidebugger
C command checks the status
L command lists block by block

0001-PAC>C
DEFAULT PACKAGE INFO CHECKED AND OK

CHECKING MAFILE(S)
CHECKED
CHECKING SOMAFI(S)
CHECKED

For public use IPR applies

15
Nokia Siemens Networks

00
00
20
44
39
31
05
31

55
55
20
49
2E
20
06
42

54
32
20
52
35
32
20
30

00
20
39
00
2D
2E
00
30

00
39
20
55
30
33
00
39

00
2E
55
32
20
2D
00
00

00
31
32
33
20
30
00
00

00
2D
5F
31
20
20
00

00
30
39
42
20
20
00

00
20
5F
30
43
20
00

00
20
31
30
49
20
00

00
20
5F
39
44
47
00

00
20
30
01
49
25
00

03
20
00
55
30
31
55

00
20
00
32
30
14
32

Stop listing = CTRL-C, Continue = <any other key>

COMMAND EXECUTED

RN33157EN10GLA0

***/

SOMAFI RECORD NUMBER 0 :

78
03
20
00
20
33
08
33

STATUSES CHECKED AND OK

/*** WARNING: If you do not know what you are doing

do not use PACKET use MML!
PACKAGE HANDLING FIRST AID KIT
? ..... MENU
D ..... SELECT DEFAULT SOFTWARE PACKAGE IN SOMAFI
S ..... SET STATUS OF SOFTWARE PACKAGE IN SOMAFI
E ..... EDIT SOFTWARE PACKAGE RECORD IN SOMAFI
L ..... LIST SOMAFI FILE
C ..... CHECK SOMAFI FILE
P ..... LIST SOMAFI FILE STRUCTURE DEFINITION
H ..... HELP FOR USING PACKET COMMANDS
Z ..... RETURN TO MAIN LEVEL

x.UT............
..U2 9.1-0
9 U2_9_1_0..
.DIR.U231B009.U2
9.5-0
CIDI00
31 2.3-0
G%1.
... ..........U2
31B009..

Patching SOMAFI using PACKETGX (2/2)

D command used for patching

0001-PAC>DN:TESTSW
PACKAGE: TESTSW 7.2-0

CIDI0031 3.2-0

$W

SET TO DEFAULT PACKAGE

PACKAGE: DEFSW PREVIOUS DEFAULT PACKAGE INFORMATION DELETED

SOMAFI HAS BEEN UPDATED TO DISKS
NEW DEFAULT PACKAGE INFORMATION IS TAKEN OVER AFTER SYSTEM RESET
COMMAND EXECUTED

For public use IPR applies

16
Nokia Siemens Networks

RN33157EN10GLA0

System Disk Failure

Put spare OMU into SE-NH
(re)start SYM-OMU in Mini-debugger mode
Install one new disk
Format the disk and create partition
Insert the removable media (USB stick or MOD)
Copy the backup SW build and SOMAFI
Reset the SYM-OMU
Put spare OMU back into SP-EX
Restart the system
Install another new disk
For public use IPR applies
17
Nokia Siemens Networks

RN33157EN10GLA0