dls check in the omc-r

All Rights Reserved © 2007, Alcatel-Lucent

Do not delete this graphic elements in here:

All Rights Reserved © 2007, Alcatel-Lucent@@PRODUCT · @@COURSENAME

Evolium™ BSS / B9-B10 O&M Evolution - 3FL12784AAAB

DLS Check in the OMC-R


All Rights Reserved © Alcatel-Lucent 2007

2

What You Must Remember

How Does It Work?What Are the Impacts on HMI?

Test Yourself

What Is the Purpose of this Feature?



3

In B9, in case of DLS inconsistency, no information is provided at OMC-R level. In some cases, the bugs that are not corrected by the operator can result in blocking situations in the BSS.

1 What Is the Purpose of this Feature?Principles in B9

DLS corrupted

X.25 / IP

OMC-RDLS backup

The operator is not informed of the DLS

inconsistency!

DLS

DLS inconsistency may appear after a PRC activation with X.25 instability and may lead to a bad DLS update.



4

In B10, an application of the OMC-R, called DLS Periodic ChecK (DPCK), performs a DLS check after each backup. When an error is detected in the DLS, DPCK generates an alarm in ASUSM.

1 What Is the Purpose of this Feature?Principles in B10

DPCK ASUSM

DLS

DLS corrupted

X.25 / IP

OMC-RDLS backup Errorsin the DLS

An alarminforms the

operatorof the DLS

inconsistency!

DLS



5



Test Yourself




6

The DPCK application operates at OMC-R level each time a DLS backup is performed.

2 How Does It Work?Unitary Report Generation

CheckFunction

List

DLS corrupted

X.25 / IP

OMC-RDLS backup

DLS

DLSUnitaryReportDLS

DPCK

If one errorat least

is detected,an alarm is

generated in ASUSM.

Once the OMC-R has been backed up on the OMC-R disks manually or automatically, the DPCK application checks that there is no error in the DLS. To check the DLS consistency, DPCK performs a given number of tests on the DLS. These tests are written in the check function list file (merge of the Alcatel's reference file and of the customer's reference file in which the customer can add his own test). Then DPCK creates a unitary report for this DLS whether the DLS contains some errors or not. If DPCK detects at least one error, it generates at the same time an alarm to inform the operator that the DLS is corrupted. The alarm is displayed in the ASUSM interface.

If the DLS is backed up more than once a day, DPCK checks the DLS after each backup. Consequently, DPCK generates as many unitary reports as DLS backups. For a given DLS which is backed up several times a day, the unitary reports generated are differentiated by the backup time included in the name of each report.



7

2 How Does It Work?Unitary Report Description

BS S _5_20050628140002

A unitary report is characterized by its name:<BSSNAME>_<Date><Hour><Minute><Second>.log.old

A unitary report is made up of 2 parts:� a header containing global information:� Date� Tool version� Check reference list� Number of errors or warnings detected on the DLS

� a list of general checks:� List of errors and warnings coming from the Alcatel's reference list

� Optionally, list of errors and warnings coming from the customer's reference list

Date and time: 28/06/2005, 14:00:02DLS: AI0DCT01.01ADATAMODEL: AW55DPCK Version B10 1.20Check List: B10_Ev_03, Cust_B10_Ev_03TotalNOK: 2Warning:4General Check:RomCell_03.sqlCHECK_75 ERROR : TUPLE 40 IN R_PAR_ADJ IS NEVER USED BY MAP_ADJCHECK_76 ERROR : TUPLE 139 IN R_PAR_ADJ IS NEVER USED BY MAP_ADJEnd of processing

The name of the unitary report is broken down as follows:� BSSNAME: the BSC friendly name used in the OMC-R.� Date: yyyymmdd� Time: Hour (HH), Minute (mm), Second (ss)

A unitary report comprises the following information:� BSS friendly name,� Checked DLS and data model,� Date and time,� Tool version,� Reference file name,� Total information about NOK/Warning number,� Check script name, test case and test information,� Separate general checks and customer check.

A unitary report includes 3 kinds of error:� FDWN files unreachable,� Error caused by SQL script request,� DLS error.



8

At 5 a.m., DPCK summarizes all unitary reports into a synthetic report.

2 How Does It Work?Synthetic Report Generation

BS S _5_20050628140002

Tool version: 9.1.5Total DLS: 29Context files not found: 1: BSS_2No upload DLS: 2; BSS_5, BSS_9NOK (errors): 1NOK (warning): 2Context file not found: BSC: BSC_Name1,DLS: DLSzzzzzzBSC: BSC_Name4, DLS: abc: 3 errors, 6 warningsunitaryReportDynamicLink - <unitary report file name1> - See unitary reportBSC: BSC_Name5, DLS: def: 2 warningsunitaryReportDynamicLink - <unitary report file name1> - See unitary reportBSC: BSC_Name6, DLS: ghi: 50 warnings

UnitaryReportDLS1

UnitaryReportDLS2

UnitaryReportDLS3

DPCK

DP CK_ 2 0 0 5 0 5 3 1 .log.old

The synthetic report is characterized by its name:<DPCK>_<Date>. log.old

The synthetic report is made up of 2 parts:� a header that contains the number of DLSs uploaded and the number of errors and warnings.� some summarized information related to each BSC with the number of errors and warnings detected on the DLS and the name of the associated unitary report.

The synthetic report is stored in the directory \alcatel\var\maintenance\log.After the generation of a synthetic report, all the unitary reports are moved to the same directory \alcatel\var\maintenance\log.



9

The functions to be tested are declared in the check function list file. The check function list file is created by merging 2 files:� the Alcatel's reference file containing SQL scripts,� the customer's reference file which is empty by default.The Alcatel's reference file is enriched each time a new problem is detected.

2 How Does It Work?Key Points of DPCK

DPCK does not correct the bugs but detects the bugs declared in the check function list file in order to help the operator to solve the problems.

The check function list used by DPCK is enriched as new problems appear in the field. That is why the tool is not mandatorily updated at each MR or at each new BSS release.

If the operator wants to add a new test to the check function list file, he must write the new SQL script in the file which is stored in a specific directory.



10



Test Yourself




11

3 What Are the Impacts on HMI?Main DPCK Directory

In B10, a new directory is created for the DPCK application:\alcatel\omc3\DPCK

The unitary reports generated by DPCK are stored in the directory:\alcatel\var\share\DPCK\report

After the generation of a syntheticreport, DPCK:� stores the synthetic report in the directory:

\alcatel\var\maintenance\log� moves all unitary reports to the directory:

\alcatel\var\maintenance\log

The DPCK delivery package is included in the OMC-R CD3 during OMC-R installation.

Meaning of the sub-directories:� <bin>: contains the DPCK executable file.� <tmp>: a temporary working directory used to protect a parallel execution (for each DLS, a temporary sub-directory for input files is generated).� <DLSContext>: used to put FDWN files. FDWN files contain a formal description of the DLS.� <Fix>: used to store the fixed check function list (Alcatel's reference file).� <ForCustomer>: used to store the operator's defined check function list (customer's reference file).� <log>: used to store the log file generated by DPCK after each check.� <report>: used to store the unitary reports.



12

The DPCK application is launched via UNIX® commands on the OMC-R terminal.

To launch the DPCK application:1. Open a Terminal window.2. Log in as axadmin user.3. Execute the script $ /alcatel/omc3/osm/script/launch_dpck4. End.

3 What Are the Impacts on HMI?DLS Check Application Activation



13

To inform the operator that DPCK has detected DLS inconsistency, which means there is at least one error in the unitary report, a new alarm "Errors in checked DLS" is defined at OMC-R level.

3 What Are the Impacts on HMI?New Alarm Generated by DPCK

BS S _5_20050628140002

Errors in checked DLS

evenType ProcessingErrorprobableCause corruptDataAlarm Number 500015perceivedSeverity MajorAlarm Description The checked DLS contains error(s)Impact on System After the running DLS is backed up, several

checks are performed and some of them fail.

When the "Errors in checked DLS" alarm is raised, the operator has to correct the DLS inconsistency and then to launch another backup to clear the alarm.



14



Test Yourself




15

1. The "DLS Check in the OMC-R" feature consists in checking the consistency of the DLS thanks to the DPCK application running on the OMC-R server.

2. Once the DLS is backed up on the OMC-R, the DPCK application:� checks the DLS according to the tests written in the chek function list file.� generates a unitary report with the possible errors and warnings detected

during the check.� generates an alarm called "Errors in checked DLS" if there is at least one error

in the unitary report.

3. The DPCK application summarizes all unitary reports into a synthetic report at 5 a.m.

4. The tests to be performed on the DLS are updated according to the new problems detected in the field.

5. The DPCK application does not solve the bugs of the DLS but detects them.




16

End of Module

dls check in the omc-r

Documents