RNC Log Collection Tool

7/29/2019 RNC Log Collection Tool

1/15

NN-20500-100

Wireless Service Provider Solutions

UMTS

RNC Log Collection ToolUMTS 4.1, UMTS 5 0 01.03/EN Preliminary July 2006


2/15

UMTS

RNC LOG COLLECTION TOOL

Document number: NN-20500-100Document issue: 01.03/ ENDocument status: PreliminaryProduct Release: UMTS 4.1, UMTS 5.0Date: July 2006

Copyright 2006 Nortel Networks, All Rights Reserved

Originated in France

NORTEL CONFIDENTIAL

The information contained in this document is the property of Nortel Networks. Except as specifically authorized in

writing by Nortel Networks, the holder of this document shall keep the information contained herein confidential

and shall protect same in whole or in part from disclosure and dissemination to third parties and use same for

evaluation, operation and maintenance purposes only.

The content of this document is provided for information purposes only and is subject to modification. It does not

constitute any representation or warranty from Nortel Networks as to the content or accuracy of the information

contained herein, including but not limited to the suitability and performances of the product or its intended

application.

This is the Way. This is Nortel, Nortel, the Nortel logo, and the Globemark are trademarks of Nortel Networks. All

other trademarks are the property of their owners.


3/15

Nortel Confidential Publication history i

Copyright

2006 Nortel Networks RNC Log Collection Tool

PUBLICATION HISTORY

July 2006

Issue 01.03 / EN, PreliminaryInternal review and editorial update

July 2006

Issue 01.02 / EN, Preliminary

Internal review and editorial update

June 2006

Issue 01.01 / EN, Draft

Document creation


4/15

Nortel Networks Confidential ii

NN-20500-100 01.03/ EN Preliminary J uly 2006 Copyright

2006 Nortel Networks

TABLE OF CONTENTS

1. INTRODUCTION .........................................................................................................................1

1.1. OBJECT.................................................................................................................................1

1.2. APPLICABILITY .......................................................................................................................1

1.3. AUDIENCE .............................................................................................................................1

2. REFERENCE DOCUMENTS.......................................................................................................1

2.1. APPLICABLE DOCUMENTS........................................................................................................1

2.2. REFERENCE DOCUMENTS .......................................................................................................1

3. GENERAL DESCRIPTION..........................................................................................................2

3.1. TOOL DESCRIPTION ................................................................................................................2

3.2. LOGS TYPES ..........................................................................................................................2

4. PRE-REQUISITES ......................................................................................................................3

5. PACKAGE DELIVERY DESCRIPTION.......................................................................................4

6. RUNNING THE TOOL.................................................................................................................5

6.1. WHEN TO RUN THETOOL.......................................................................................................5

6.2. HOW TO RUN THETOOL.........................................................................................................5

6.3. TOOL PROGRESS DESCRIPTION ...............................................................................................6

6.4. TOOLRESULTS..................................................................................................................86.5. TOOL PRE-CHECKS ...............................................................................................................8

7. ABBREVIATIONS AND DEFINITIONS.......................................................................................9

7.1. ABREVIATIONS .......................................................................................................................9

7.2. DEFINITIONS ..........................................................................................................................9


5/15

Nortel Confidential 1

Copyright


1. INTRODUCTION

1.1. OBJECT

This document aims at describing the log collection tool.

This tool must be run from an OAM main server. It collects all the needed traces/logs from

an RNC to allow case of investigation.

1.2. APPLICABILITY

This tool is designed for both Nortel RNC 1000 and RNC 1500.

This tool is relevant for RNC Release 4.1 and 5.0.

1.3. AUDIENCE

This document is intended to operational teams.

2. REFERENCE DOCUMENTS

2.1. APPLICABLE DOCUMENTS

None

2.2. REFERENCE DOCUMENTS

None


6/15


___________________________________________________________________________________________________________________

NN-20500-10001.03/ EN Preliminary July 2006 Copyright


3. GENERAL DESCRIPTION

3.1. TOOL DESCRIPTION

This documents aims at describing the use of the RNC Log Collection tool.

This tool collects and stores all the required log files, and commands results from RNC (1000

or 1500) into an OAM compressed file, in order to allow RNC issue investigation.

The logs to collect are listed into a command file.

It is highly recommended to attach such log to any RNC case.

3.2. LOGS TYPES

Three configuration files are delivered with the tool. They contain the commands to apply

and the files to retrieve from RNC.

The three files are:

gps_EmergencyLogCommands.cfg:

This file contains a set of commands to retrieve all the information which will be lost

in a case of equipment restart. This command file is available for both RNC 1000

and RNC 1500.

gps_ClassicRNCLogCommands.cfg:

This file contains the full log collection commands for an RNC 1000.

gps_CompactRNCLogCommands.cfg:

This file contains the full log collection commands for an RNC 1500.


7/15


Copyright


4. PRE-REQUISITES

To run the tool, the user needs:

A UNIX session on the OAM main server opened by a user that belongs to nortel

group.

The Login and associated password for WICL connection.

The Login and associated password for RNC-CN & omu user password (only when

running the tool against an RNC1000).

The RNC label (declared in OAM database) having an issue.

The Start date for log collection.

The End date for log collection. (Optional, if not provided, the current date will be used

as the end date).

In addition to that, the user may be asked for the following data when the tool can not

retrieve them:

RNC-IN IP address

RNC-IN Login & password.


8/15


___________________________________________________________________________________________________________________



5. PACKAGE DELIVERY DESCRIPTION

The tool is present within the OAM software delivery. The tool is localized in the

/opt/nortel/shell/support_tools/LogCollection/ directory.

The delivered package contains the following components:

The tool utilities

The command file to retrieve logs from RNC 1500

The command file to retrieve logs from RNC 1000

The command file to retrieve all logs removed after an RNC restart.

. . . % l s l a / opt/ nort el / shel l / support _tool s/ LogCol l ect i on/ t ot al 230

- r w- r - - r - - 1 nor t el nor t el 2834 Apr 20 12: 29 gps_Cl assi cRNCLogCommands. cf g- r w- r - - r - - 1 nor t el nor t el 2393 Apr 20 12: 29 gps_Compact RNCLogCommands. cf g- r w- r - - r - - 1 nor t el nor t el 14401 Apr 20 19: 15 gps_Connect i ons. t cl- r w- r - - r - - 1 nor t el nor t el 1433 Apr 14 13: 56 gps_EmergencyLogCommands. cf g- r w- r - - r - - 1 nor t el nor t el 2723 Apr 20 17: 49 gps_getCommands. t cl- r w- r - - r - - 1 nor t el nor t el 1419 Apr 20 17: 50 gps_get RNCI nf o. wcl- r w- r - - r - - 1 nor t el nor t el 7005 Apr 20 17: 49 gps_l ogTr aces. t cl- r w- r - - r - - 1 nor t el nor t el 37914 Apr 20 19: 07 gps_r et r i eveI nf o. t cl- r wxr- xr- - 1 nor t el nor t el 39106 Apr 20 19: 15 gps_r ncLogCol l ect i on. t cl- r w- r - - r - - 1 nor t el nor t el 2334 Apr 20 17: 50 gps_wi cl Commands. t cl. . . %


9/15


Copyright


6. RUNNING THE TOOL

6.1. WHEN TO RUN THE TOOL

The RNC Log collection tool needs to be run when any issue occurs on the RNC. This

collection enables the issue investigation.

The log collection must be executed following those steps:

1. If an equipment restart is required, need to collect all logs which will be

removed at the restart. This is performed by using the

gps_EmergencyLogCommands.cfg command file.

2. After the equipment restart, need to collect the full set of logs. This is

performed by using:

gps_ClassicRNCLogCommands.cfg for RNC 1000 logs collection.

gps_CompactRNCLogCommands.cfg for RNC 1500 logs collection.

Both collected logs collected on steps 1 and 2 must be attached to RNC cases.

6.2. HOW TO RUN THE TOOL

The RNC Log collection tool is present in the

/opt/nortel/shell/support_tools/LogCollection directory. Its launched by the TCL script

gps_rncLogCollection.tcl.

Launching the tool with -help option gives its usage.


10/15


___________________________________________________________________________________________________________________



Several tool inputs can be provided in command line. Otherwise, the user is asked to

provide them when needed.

The tool collects logs within the time period between Start Date and End Date. Those

dates must be provided in format DD/MM/YYYY.

If End Date isnt provided, the current date will be used as the End Date.

6.3. TOOL PROGRESS DESCRIPTION

Once the tool is launched, the tool first connects to WICL to retrieve all the available

RNC on the OAM. The user is then invited to choose the one on which the log

collection needs to be executed:

In the example detailed below, the WICL connection user and password are provided

in the command line.

W

h

e

n

r

u

n

n

i

n

g

,

t

h

e

Once the target RNC is selected, the tool retrieves all the needed connection data.

In the example above, the user chose the option 6 corresponding to RNC_1202.

Depending on RNC Architecture, a list of command files is provided to select which

one must be used during log collection.

As the RNC selected in the example above is an RNC 1000, the tool offers the choice

between a complete log collection for an RNC 1000 and a light log collection)


11/15


Copyright


Once the command file is chosen, the tool requests the missing information for the

equipment connection, and then starts the log collection showing the tool progress. At

the end of the execution, the tool displays results summary.


12/15


___________________________________________________________________________________________________________________



6.4. TOOL RESULTS

The tool execution provides the two following files as output:

The tool execution trace file. This file is named as follows:

ExternalLogCollection_RNC_DateOfExecution.log, where DateOfExecutionrepresent the date of tool execution given on the following format:

DDMMYYYY_HHMMSS.

This file must be provided to the tool development team if any problem occurs

during tool execution.

The tool resulting file. This file is a compression of all logs collected.

This file is named as follows:

ExternalLogCollection_RNCLabel_StartDate_EndDate_DateOfExecution.tar.Z

where:

o RNCLabel is the label of the RNC on which log collection is performed;

o StartDate is the start date of log collection period in format DDMMYYYY;

o EndDate is the end date of log collection period in format DDMMYYYY;

o DateOfExecution is the date of tool execution given on the following

format: DDMMYYYY_HHMMSS

The tool logs are stored in the /opt/nortel/logs/support_tools/ExternalLogCollection

directory.

Only the 20 last execution traces are kept.

The tool result files are stored in the

/opt/nortel/data/support_tools/ExternalLogCollection directory.

No purge mechanism exists on this directory, so the user must remove files

periodically.

6.5. TOOL PRE-CHECKS

When the tool is run, it generates a result file stored in directory

/opt/nortel/data/support_tools/ExternalLogCollection.

There is no purge mechanism on OAM for this directory, so the user has to clean it.

To force this behavior, the tool checks that the directory occupation is less than 80%

of its capacity, and that there are less than 40 resulting files present in the directory.

If any of those conditions is not met, the tool asks the user to remove files.

Example:


13/15


Copyright


7. ABBREVIATIONS AND DEFINITIONS

7.1. ABREVIATIONS

CN Control Node

IN Interface Node

RNC Radio Network Controller

WICL Wireless Internet Command Language

7.2. DEFINITIONS

None


14/15


15/15

Wireless Service Provider SolutionsUMTSRNC Log Collection Tool

To order documentation from Nortel Wireless Knowledge Services from all countries except North America, contact:

Tel.: (1) (615) 432-4848

To order documentation from Nortel Wireless Knowledge Services from North America, contact:

Tel.: (1) (877) 662-5669 [Option 4] or (1) (919) 997-8015

To report a problem in this publication from all countr ies except North America, contact:

NortelDocumentation DepartmentParc d'Activit de Magny-ChteaufortChteaufort78928 Yvelines Cedex 9FranceFax: (33) (1) 39-44-50-29

To report a problem in this publication fr om North America, contact:

NortelGlobal Knowledge Services2221 Lakeside BoulevardRichardson TX 75082USA

Tel.: (1) (800) 466-7838 or (1) (972) 684-5935

From any country, you can also use the "Contact Us" link from the Nortel Networks Customer Documentation WorldWide Web site at:

http://www.nortel.com/documentation

Copyright 2006 Nortel Networks, All Rights Reserved

NORTEL CONFIDENTIAL

The information contained in this document is the property of Nortel Networks. Except as specifically authorized inwriting by Nortel Networks, the holder of this document shall keep the information contained herein confidential

and shall protect same in whole or in part from disclosure and dissemination to third parties and use same for

evaluation, operation and maintenance purposes only.

The content of this document is provided for information purposes only and is subject to modification. It does not

constitute any representation or warranty from Nortel Networks as to the content or accuracy of the information

contained herein, including but not limited to the suitability and performances of the product or its intended

application.

This is the Way. This is Nortel, Nortel, the Nortel logo, and the Globemark are trademarks of Nortel Networks. All

other trademarks are the property of their owners.

Document number: NN-20500-100Document issue: 01.03/ENDocument status: PreliminaryProduct Release: UMTS 4.1, UMTS 5.0Date: J uly 2006

Originated in France

RNC Log Collection Tool

Documents

Transcript of RNC Log Collection Tool