GSM/EDGE BSS, rel.

RG10(BSS), operating documentation, issue 02

Feature description

BSS20097: Automated RNW O&M log collection

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. This documentation is intended for the use of Nokia Siemens Networks customers only for the purposes of the agreement under which the document is submitted, and no part of it may be used, reproduced, modified or transmitted in any form or means without the prior written permission of Nokia Siemens Networks. The documentation has been prepared to be used by professional and properly trained personnel, and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes customer comments as part of the process of continuous development and improvement of the documentation. The information or statements given in this documentation concerning the suitability, capacity, or performance of the mentioned hardware or software products are given "as is" and all liability arising in connection with such hardware or software products shall be defined conclusively and finally in a separate agreement between Nokia Siemens Networks and the customer. However, Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. Nokia Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which may not be covered by the document. Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO EVENT WILL Nokia Siemens Networks BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT. This documentation and the product it describes are considered protected by copyrights and other intellectual property rights according to the applicable laws. The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark of Nokia Corporation. Siemens is a registered trademark of Siemens AG. Other product names mentioned in this document may be trademarks of their respective owners, and they are mentioned for identification purposes only. Copyright Nokia Siemens Networks 2009. All rights reserved

Important Notice on Product Safety

Elevated voltages are inevitably present at specific points in this electrical equipment. Some of the parts may also have elevated operating temperatures. Non-observance of these conditions and the safety instructions can result in personal injury or in property damage. Therefore, only trained and qualified personnel may install and maintain the system. The system complies with the standard EN 60950 / IEC 60950. All equipment connected has to comply with the applicable safety standards.

The same text in German: Wichtiger Hinweis zur Produktsicherheit In elektrischen Anlagen stehen zwangslufig bestimmte Teile der Gerte unter Spannung. Einige Teile knnen auch eine hohe Betriebstemperatur aufweisen. Eine Nichtbeachtung dieser Situation und der Warnungshinweise kann zu Krperverletzungen und Sachschden fhren. Deshalb wird vorausgesetzt, dass nur geschultes und qualifiziertes Personal die Anlagen installiert und wartet. Das System entspricht den Anforderungen der EN 60950 / IEC 60950. Angeschlossene Gerte mssen die zutreffenden Sicherheitsbestimmungen erfllen.

Id:0900d8058058d591

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

Table of contents
This document has 13 pages. Reason for update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1 1.1 1.2 2 2.1 2.2 3 3.1 3.2 3.3 3.4 3.5 4 5 5.1 6 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 In general . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Hardware requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Functional description . . . . . . . . . . . . . . Log file creation and feature activation . Collection of RNW O&M logs to file . . . Displaying logged data . . . . . . . . . . . . . Logged operations . . . . . . . . . . . . . . . . Stopping log collection . . . . . . . . . . . . . ...... ...... ...... ...... ...... ...... ....... ....... ....... ....... ....... ....... ...... ...... ...... ...... ...... ...... ....... ....... ....... ....... ....... ....... .. 9 .. 9 .. 9 . 10 . 10 . 10

System impacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 0 Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

DN70646173, issue 1-1

Id:0900d8058058d591

BSS20097: Automated RNW O&M log collection

List of tables
Table 1 Parameter to enable the writing of RNW O&M logs . . . . . . . . . . . . . . . . 12

Id:0900d8058058d591

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

Reason for update

Reason for update

Issue history Issue number 01 1-1 Date of issue 12/2008 03/2009 Reason for update Approved draft of first issue for new release First issue for new release

Details

DN70646173, issue 1-1

Id:0900d8058051dc24

Reason for update

BSS20097: Automated RNW O&M log collection

Id:0900d8058051dc24

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

Introduction

1 Introduction
1.1 In general
The Automated RNW O&M log collection feature (BSS20097) introduces the automated logging of all relevant operations, errors and faults related to radio network O&M in the BSC. The occurrence of these operations, error and faults is reported in a log file on the disk unit of the OMU in the BSC. The feature facilitates the tracking of O&M faults in the BSC and is particularly useful for those cases where the cause of the fault is unknown and the fault cannot be reproduced. In case of a fault, the log file can be sent to Nokia Siemens Networks Technical Support for fault tracing.

1.2

Benefits
This feature has the following benefits for the operator: Faults are resolved in less time Quality of the end user service is improved Operating costs are reduced

DN70646173, issue 1-1

Id:0900d80580215492

Requirements

BSS20097: Automated RNW O&M log collection

2 Requirements
2.1 Software requirements
This feature requires the BSC S14 software release.

2.2

Hardware requirements
This feature does not have any specific hardware requirements.

Id:0900d8058023299a

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

Functional description

3 Functional description
This chapter is divided into the following sections: Log file creation and feature activation Collection of RNW O&M logs to file Displaying logged data Logged operations Stopping log collection

3.1

Log file creation and feature activation

The operator needs to activate Automated RNW O&M log collection using the RNW O&M log usage FIFILE parameter. Before the feature can be activated, the operator needs to create a sub log file on the OMUs disk unit. This sub log file is used for the storage of RNW O&M logs. It is created by the operator using the DVC command in a remote or local MML session, and is given the name RNWLOG. The file is implemented as a ring buffer, and its size can be changed within the range of 30 kb to 3.3 Mb. The recommend file size for RNWLOG is 1 Mb. After creating the sub log file, the operator needs to modify log filtering settings using the DVM command. The writing of information logs for the MCMU is enabled by setting the log writing class parameter of the DVM command to INF. The software layer parameter of this command is set to APP , meaning that only log entries related to the application layer are written.

3.2

Collection of RNW O&M logs to file

After creation of RNWLOG and activation of the feature, the collection of RNW O&M logs to file is done in two phases. Whenever an RNW-specific operation starts, the BSC application writes detailed information about the operation in the information log file. This information provides a fingerprint of what the operation is going to do. Only that information which is relevant to fault tracing is written into the log file. After the RNW-specific operation has been completed, the BSC application writes information about whether or not the operation succeeded into the same information log file. Additionally, all error situations are also written into the log file. The error logging functionality pre-dates the Automated RNW O&M log collection feature. However, this feature indicates which O&M operation was being carried out when an error log appeared, and writes this information in the log file. The information log file appears only if the RNW O&M log usage parameter has been set. In the second phase, log entries are collected from both the MCMU information log file and the error logs, and placed in the sub log file RNWLOG. This collective information now can be used to resolving fault situations, because information about the planning and results of individual operations can be traced.

g For more information about using DV commands, refer to the document DV - Disk
Log Handling.

DN70646173, issue 1-1

Id:0900d80580256e17

Functional description

BSS20097: Automated RNW O&M log collection

3.3

Displaying logged data

The operator can display the logged data using the DVL command in a remote or local MML session. For this operation, the log file ID must be given. This ID can be obtained by the operator using the DVP command for displaying log file settings. The displayed logged data is in ASCII text format and can be copied from the MML session and pasted to a text file. This text file can then be sent to Nokia Siemens Networks technical support for further investigation.

3.4

Logged operations
The following RNW O&M operations are logged: BCF initialization, corresponding to a BCF reset situation. Logs are not collected in normal BCF reset situations, such as BSC system reset, and reset requests resulting from a provisioning plan activation. Fault recovery TRX swap SI sending at BSC level BCF lock and unlock BTS or TRX lock and unlock RTSL lock and unlock Sending of configuration data to the BTS network element Spontaneous TRX reset on the BTS network element System or MCMU reset BCSU restart or switchover Gb interface state changes FBPP operations, such as fallback activation, validating or activating a provisioning plan file, or starting or ending the plan file download

3.5

Stopping log collection

The collection of RNW O&M logs can be stopped by operator without having to deactivate the feature. This is done using the DVE command in a remote or local MML session. For this operation, the log file ID is also needed.

g For more information about using DV commands, refer to the document DV - Disk
Log Handling.

10

Id:0900d80580256e17

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

System impacts

4 System impacts
This feature has no additional impacts on the system.

DN70646173, issue 1-1

Id:0900d805802154a1

11

User interface

BSS20097: Automated RNW O&M log collection

5 User interface
This chapter contains the following section: Parameters

5.1

Parameters
Table 1 shows the parameter implemented for Automated RNW O&M Log Collection. This parameter is subject to change. Name RNW_OM_LOG_USAGE New / Level Modified New BSC Description Range Default value FALSE

This visible and TRUE / editable FIFILE FALSE parameter enables the writing of MCMU information logs, associated with automated RNW O&M log collection

Table 1

Parameter to enable the writing of RNW O&M logs

The RNW_OM_LOG_USAGE parameter is stored in the FIFILE parameter file. This file is edited using the the WO command group in the parameter-handling MML. For more detailed instructions on the commands and their parameters, refer to the document WO - Parameter Handling.

12

Id:0900d8058022e356

DN70646173, issue 1-1

BSS20097: Automated RNW O&M log collection

Abbreviations

6 Abbreviations
0Z
ASCII BCF BSC BCSU BTS FBPP MCMU MML O&M OMU PCU RNW RTSL SI TRX American standard code for information interchange base station control function base station controller BSC signaling unit base transceiver station file base plan provisioning marker and cellular management unit man-machine language operation & maintenance operation and maintenance unit packet control unit radio network radio timeslot system information transceiver

DN70646173, issue 1-1

Id:0900d8058024a2a1

13