Nokia 2G Documents

Guide to Nokia GSM/EDGE BSSDocumentation

DN05135097Issue 2-0 en13/03/2008

# Nokia Siemens Networks 1 (47)

BSC3153Nokia GSM/EDGE BSS, Rel. BSS13, BSC andTCSM, Rel. S13, Product Documentation, v.1

The information in this document is subject to change without notice and describes only theproduct defined in the introduction of this documentation. This documentation is intended for theuse of Nokia Siemens Networks customers only for the purposes of the agreement under whichthe document is submitted, and no part of it may be used, reproduced, modified or transmitted inany form or means without the prior written permission of Nokia Siemens Networks. Thedocumentation has been prepared to be used by professional and properly trained personnel,and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomescustomer comments as part of the process of continuous development and improvement of thedocumentation.

The information or statements given in this documentation concerning the suitability, capacity, orperformance of the mentioned hardware or software products are given “as is” and all liabilityarising in connection with such hardware or software products shall be defined conclusively andfinally in a separate agreement between Nokia Siemens Networks and the customer. However,Nokia Siemens Networks has made all reasonable efforts to ensure that the instructionscontained in the document are adequate and free of material errors and omissions. NokiaSiemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues whichmay not be covered by the document.

Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NOEVENT WILL NOKIA SIEMENS NETWORKS BE LIABLE FOR ERRORS IN THISDOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL,DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUTNOT LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESSOPPORTUNITY OR DATA, THAT MAYARISE FROM THE USE OF THIS DOCUMENT OR THEINFORMATION IN IT.

This documentation and the product it describes are considered protected by copyrights andother intellectual property rights according to the applicable laws.

The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark ofNokia 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 2008. All rights reserved.

2 (47) # Nokia Siemens Networks DN05135097Issue 2-0 en13/03/2008

Guide to Nokia GSM/EDGE BSS Documentation

Contents

Contents 3

List of tables 4

List of figures 5

Summary of changes 7

1 Available documentation for GSM/EDGE BSS system and networkelements 9

1.1 Nokia GSM/EDGE BSS product documentation 111.2 Nokia GSM/EDGE base station documentation 121.3 Nokia GSM/EDGE transmission documentation 141.4 Nokia EDGE / WCDMA antenna and power systems documentation 151.5 NetAct documentation 16

2 Delivery timing 172.1 Documentation deliveries in pre-release phase 172.2 Documentation deliveries in release phase 182.3 Documentation update deliveries 18

3 Delivery channels and media 213.1 NOLS 213.2 Nokia Siemens Networks logistics system 243.3 Software-embedded documentation 24

4 Delivery formats 254.1 NED 254.2 PDF 274.3 Online help 27

5 How to find the information you need in GSM/EDGE BSSDocumentation 29

5.1 GSM EDGE BSS, BSC and TCSM product documentation contents 295.2 Site documentation contents 335.3 Software pre-release documentation contents 345.4 Software release documentation contents 35

6 Documentation identification and versioning system 376.1 PDF document identification 386.2 NED online content identification 396.3 Document set identification 40

7 How to give feedback on documentation 457.1 Problem reporting 457.2 Giving feedback 46

DN05135097Issue 2-0 en13/03/2008


Contents

List of tables

Table 1. Nokia GSM/EDGE BSS product documentation sets 11

Table 2. Nokia GSM/EDGE base station documentation sets 12

Table 3. Nokia GSM/EDGE transmission documentation types 14

Table 4. Nokia EDGE / WCDMA antenna systems documentation sets 15

Table 5. Nokia NetAct documentation sets 16

Table 6. GSM/EDGE BSS release documentation 18

Table 7. Document set versioning 41



List of figures

Figure 1. Main components of GSM/EDGE BSS system-wide documentation 10

Figure 2. Access methods to Nokia GSM/EDGE BSS, BSC and TCSMdocumentation in NOLS 22

Figure 3. Nokia Electronic Documentation (NED) logo 23

Figure 4. Browse NED content 26

Figure 5. Main sections of Nokia GSM/EDGE BSS, BSC and TCSM ProductDocumentation 30

Figure 6. PDF document identification 38

Figure 7. NED online content identification 39

Figure 8. Sales item code on PDF cover page 40

Figure 9. NED update package for GSM/EDGE BSS12 System Documentation 42

Figure 10. Change delivery identifiers in NOLS 43

Figure 11. Commenting on a specific document set in NOLS 46

Figure 12. Feedback link in NOLS Documentation Center 47

DN05135097Issue 2-0 en13/03/2008


List of figures



Summary of changes

Changes between document issues are cumulative. Therefore, the latestdocument issue contains all changes made to previous issues.

Changes made between issues 2-0 and 1-1

The BSS system level document, Guide to GSM/EDGE BSS SystemDocumentation, has been merged with the corresponding BSC/TCSMproduct document, Guide to BSC/TCSM Product Documentation becausethe two documentation sets have been merged in the BSS13/S13 release.The new, combined document, Guide to GSM/EDGE BSS Documentation,reflects the contents of the merged documentation set.

All graphics in the document have also been updated to reflect the newNokia Siemens Networks version of Nokia Online Services (NOLS).

The available documentation set versions have been updated in chapterAvailable documentation for GSM/EDGE BSS system and networkelements.

Information on the approval dates in the PDF documents has been beenadded to Documentation identification and versioning system.

All references to the BSS12 and S12 releases have been updated to thelevel of the current release, BSS13 and S13.

Changes made between issues 1-1 and 1-0

Information on document set versioning information has been added tochapters Available documentation for BSS12 system and BSC/TCSM S12and Documentation identification and versioning system, as a versioningsystem has been introduced for document sets.

Information on the frequency of documentation update deliveries has beenupdated in chapter Delivery timing. In addition, information on the GSM/EDGE BSS Documentation Development Roadmap has been added.

DN05135097Issue 2-0 en13/03/2008


Summary of changes

Information on the Legal and Safety Statements category has been addedto chapter How to find the information you need in BSC/TCSMdocumentation, as this category replaces categories Software LicenceTerms and General Product Information.



1 Available documentation for GSM/EDGEBSS system and network elements

The documentation set at hand is a part of the Nokia GSM/EDGE BaseStation Subsystem (BSS) system-wide documentation. Nokia GSM/EDGEBSS consists of several network elements for which various kinds ofdocumentation is available. The key elements in the BSS are the basestation controller (BSC), transcoder submultiplexer (TCSM), and thedifferent types of base stations (BTSs). The available documentation forthe BSS network elements includes BSC/TCSM Product Documentation,BSC Site Documentation, TCSM Site Documentation, Pre-releasedocumentation, and Release documentation. In addition, there are alsoseparate documentation sets available for each of the BTS types.

Figure Main components of GSM/EDGE BSS system-wide documentationgives an overview of all the GSM/EDGE BSS documentation available.

DN05135097Issue 2-0 en13/03/2008


Available documentation for GSM/EDGE BSS system and networkelements

Figure 1. Main components of GSM/EDGE BSS system-wide documentation

Nokia GSM/EDGE BSS, BSC and TCSM Product Documentation containsboth BSS system level and BSC/TCSM product information. Thedocumentation set consists of detailed BSC software and hardwaredescriptions, instructions, and references related to these networkelements, such as alarm, counter, and parameter information.

In most cases the BSS system level information has been integrated in theBSC/TCSM product's description documents. There are, however, alsosome exclusive BSS system level documents which describe the BSSnetwork architecture, transport network solution, or KPI and EDGEdimensioning. For more information on the contents of Nokia GSM/EDGEBSS, BSC and TCSM Product Documentation, see How to find theinformation you need in GSM/EDGE BSS documentation.

The BTS-specific documentation sets concentrate on the detailed productsoftware and hardware descriptions, instructions, and reference materialof each BTS type.

GSM/EDGE BSS system-wide documentation

GSM/EDGE BSS, BSCand TCSM Product

Documentation

BSC SiteDocumentation

BSC SW ReleaseDocumentation

Transmission Product Documentation

for products such as MetroHub/ITN and

FlexiHopper.

Transmission SW Release Documentation

for products such as MetroHub/ITN and

FlexiHopper.

BTS Product Documentation

for each site type, such as Flexi EDGE,

UltraSite EDGE, MetroSite EDGE.

BTS SW Release Documentation

for each site type, such as Flexi EDGE,

UltraSite EDGE, MetroSite EDGE.

TCSM SiteDocumentation



1.1 Nokia GSM/EDGE BSS product documentation

Table Nokia GSM/EDGE BSS product documentation sets lists theavailable BSS, BSC, and TCSM documentation in the releases BSS13and S13.

Table 1. Nokia GSM/EDGE BSS product documentation sets

Name ofdocumentation set

Available formats Available from Description of thedocumentation set

Nokia GSM/EDGE BSS,Rel. BSS13, BSC andTCSM, Rel. S13, ProductDocumentation, v.1, orlater

Downloadable NED

Browseable NED

NOLS DocumentationCenter

Provides a full informationset on the system andproducts, includingdescriptions, referencedocumentation, and task-oriented instructions forimplementation, normaldaily operations,maintenace, andtroubleshooting.

NED CD-ROM Nokia Siemens Networkslogistics system

Nokia BSC3i, Rel. S13,Site Documentation, v.1

Downloadable NED

Browseable NED


Provides instructions onBSC HW installation andupgrading, and lists theneeded equipment andcables.

Paper Nokia Siemens Networkslogistics system

Only with a hardwaredelivery

Nokia TCSM3i, Rel. S13,Site Documentation, v.1

Downloadable NED

Browseable NED


Provides instructions onBSC HW installation andupgrading, and lists theneeded equipment andcables.

Paper Nokia Siemens Networkslogistics system

Only with a hardwaredelivery

Nokia BSC, Rel. S13,SW Pre-releaseDocumentation

PDF NOLS DocumentationCenter

Provides preliminaryinformation on the newSW release, changes inthe SW release as wellas the requirements anditems to be taken intoaccount when upgradingthe BSC to S13 level.

Nokia BSC, Rel. S13,SW ReleaseDocumentation

PDF NOLS Software Delivery(in connection with anSW order)

Provides information onthe new SW release, testresults, and instructionson upgrading to new SWrelease level.

DN05135097Issue 2-0 en13/03/2008



The documentation is available in Nokia Online Services (NOLS). In NOLSDocumentation Center, see any of the following product categories:

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS > BSCi

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS > BSC2i

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS > BSC3i

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS > TCSM2 E/A

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS > TCSM3i

1.2 Nokia GSM/EDGE base station documentation

Table Nokia GSM/EDGE base station documentation sets lists theavailable base station documentation for the BSS13 and S13 releases.

Table 2. Nokia GSM/EDGE base station documentation sets



Nokia Flexi EDGE BaseStation, Rel. EP1,Product Documentation,v.1

Downloadable NED

Browseable NED


Provides product, unitand softwaredescriptions, instructionson base stationinstallation andupgrading,commissioning,maintenance, andmonitoring.


Nokia Flexi EDGE BTS,Rel EP1.1, ReleaseDocumentation, v.1, orlater


Provides information onthe new software release,test cases and results,and instructions onupgrading to newsoftware release level.



Table 2. Nokia GSM/EDGE base station documentation sets (cont.)



Nokia UltraSite EDGEBTS, Rel. CX5, ProductDocumentation, v.2, orlater

Downloadable NED

Browseable NED




Nokia UltraSite EDGEBTS, Rel. CX5 CD2.0,Release Documentation,v.1, or later



Nokia MetroSite EDGEBTS, Rel. CMX5, ProductDocumentation, v.1, orlater

Downloadable NED

Browseable NED



Nokia MetroSite EDGEBTS, Rel. CXM5 CD2.0,Release Documentation,v.1, or later



Nokia LocationMeasurement Unit(LMUB), Release 1.0CD3, ProductDocumentation, v.1, orlater

Downloadable NED

Browseable NED


Provides a productdescription, requirements,and instructions oninstallation andcommissioning.


Online help for BTSManager

Online help BTS Manager SW Online help is embeddedin the BTS Managersoftware and it includesgeneral descriptions ofuser interface items,configuration procedures,and functionalitydescriptions.

DN05135097Issue 2-0 en13/03/2008



Table 2. Nokia GSM/EDGE base station documentation sets (cont.)



Online help for BTS HWConfigurator

Online help BTS HW Configurator SW Online Help is embeddedin the HW Configuratorsoftware and it includesinstructions for upgrade,activation, monitor,troubleshooting,maintenance andadminister procedures.

The documentation is available in Nokia Online Services (NOLS). TheBTS variants are listed in NOLS Documentation Center, under:

. Product Categories > Radio Network > Radio Network Solutions >GSM/EDGE BSS > Base Stations

1.3 Nokia GSM/EDGE transmission documentation

Table Nokia GSM/EDGE transmission documentation types lists theavailable transmission documentation types:

Table 3. Nokia GSM/EDGE transmission documentation types

Type ofdocumentation


Product Documentation Downloadable NED

Browseable NED


Provides productdescriptions, instructionson installation,commissioning,maintaining, removing,and troubleshooting thesystem.


Release Documentation PDF NOLS DocumentationCenter

Provides information onthe new software release.



Table 3. Nokia GSM/EDGE transmission documentation types (cont.)

Type ofdocumentation


Online help Online help Embedded in thesoftware

Online helps areembedded in the BTSManager software andthey include generaldescriptions of userinterface items,configuration procedures,and functionalitydescriptions.

The documentation is available in Nokia Online Services (NOLS). In NOLSDocumentation Center, see:

. Product Categories > Transmission and Backbone >. Transmission Solutions. Microwave Radios. Transmission Interfaces. Transmission Nodes

1.4 Nokia EDGE / WCDMA antenna and power systemsdocumentation

The EDGE and WCDMA antenna and power systems documentation iscombined into one product documentation set.

Table 4. Nokia EDGE / WCDMA antenna systems documentation sets



Nokia EDGE / WCDMAAntenna System, ProductDocumentation, v. 1, orlater

Downloadable NED

Browseable NED


Provides productdescriptions,requirements forinstallation and operation,instructions oninstallation,commissioning, andmaintenance and repair.


DN05135097Issue 2-0 en13/03/2008



Other Nokia EDGE antenna and power systems documentation isavailable in Nokia Online Services (NOLS). In NOLS DocumentationCenter, see:

. Product Categories > Auxiliary Equipment >. Antenna Systems. Mechanics and Power systems

1.5 NetAct documentation

The Nokia Siemens Networks NetAct releases that are compatible with theBSS13 and S13 releases is OSS4.2 CD Set 1 and OSS5.1. Table NokiaNetAct documentation sets lists the available OSS4.2 CD Set 1 productdocumentation:

Table 5. Nokia NetAct documentation sets



Nokia NetAct, Rel.OSS4.2 CB4, CustomerDocumentationOSS_CD_1764, or later

Downloadable NED

Browseable NED


Provides a full informationset on NetAct features.


For more documention, see the following category in NOLSDocumentation Center:

. Product Categories > Operations Support Systems > Network andService Management > Nokia NetAct



2 Delivery timing

Documentation deliveries are tied to system and product milestones. In thefollowing sections, all official and otherwise widely established GSM/EDGE BSS system and network element documentation deliveries are puton a time scale in relationship with release timing. GSM/EDGE BSSDocumentation Roadmap in NOLS Documentation Center /Documentation News also provides schedules for the updated BSS andBSC/TCSM documentation NEDs.

2.1 Documentation deliveries in pre-release phase

In GSM/EDGE BSS documentation, the term pre-release document isused to refer to any document sets that are published prior to the customerpiloting phase.

Pre-release documentation is normally issued in draft state because theinformation it contains does not always reflect the final implementation ofthe software or hardware, nor has the software and hardware been testedby the time of publication.

Note that the information in draft documents describes the product in itscurrent state of development and is subject to change without notice.Nokia Siemens Networks is not responsible in any event for errors oromissions in the documents.

Pre-release sets are usually not complete documentation sets butselections of documents. Typical document sets that are available in thepre-release phase are network element pre-release documentation sets,such as BSC/TCSM Pre-release documentation, and draft system-leveldocumentation collections.

DN05135097Issue 2-0 en13/03/2008


Delivery timing

2.2 Documentation deliveries in release phase

Documentation that is delivered in the release phase is no longer in draftstate, but reflects the final understanding of how the product or systemfunctions and how features are implemented.

The definition of the release phase varies a little. For some products,documentation delivered for the pilot is considered final releasedocumentation. Others refer to the software availability milestone.

For the GSM/EDGE BSS documentation, the pre-release documentationis in draft state. System-level pre-release documentation is delivered at thetime of the E3 milestone and pre-release documentation for the productdocumentation is delivered three months prior to the E4 milestone.

Table GSM/EDGE BSS release documentation lists the document setsthat are typically available in the release phase.

Table 6. GSM/EDGE BSS release documentation

Document set type Available for Timing

Product documentation System-level, BSC and TCSM,BTS, and transmission

Pilot phase

Site documentation BSC, TCSM Pilot phase, product availability

SW Release documentation BSC Pilot phase

SW Release documentation BTS (final) Software availability

2.3 Documentation update deliveries

User needs are the main factor in determining the scope and timing ofdocumentation update deliveries. Update deliveries are continued until theproduct release maintenance ends.

GSM/EDGE BSS system documentation and BSC product documentationupdate deliveries are published typically every two months to synchronisedocumentation updates with software enhancement deliveries. Thecurrent practice has been to first provide Documentation Change Notes(CNs) to inform of corrections or updates made to documents after theprevious publication.



In some cases, a PDF version of a corrected, updated, or new document(s) is delivered with a Change Note. This type of combination is known asDocumentation Change Delivery (CD).

At regular intervals, all the corrected, updated, or new documents aregathered into an updated product documentation NED, which is publishedin NOLS. The updated product documentation NEDs are cumulative andthey contain all the corrections notified earlier via Documentation ChangeNotes and Change Deliveries.

Documentation Change Notes, Technical Notes, and updated ProductDocumentation NEDs are published in NOLS Documentation Center in thesame location as the original NED. When a new version of the NED ispublished, it replaces the old one in NOLS. The Documentation ChangeNotes are removed a couple of months after the NED Update Packagethat delivers the corrections notified in the Documentation Change Noteshas been published.

The Documentation Change Notes and Change Deliveries are referred toas Change Documentation in NOLS categorisation of documentationtypes.

BSC site documentation, TCSM site documentation, BTS andtransmission product documentation update deliveries are published, orwhole document sets updated, as considered necessary.

DN05135097Issue 2-0 en13/03/2008


Delivery timing



3 Delivery channels and media

Depending on the product and the type of documentation, there areseveral delivery channels and media through which the documentation ispublished to customers, all of which are described here. The most widelyused delivery channel is Nokia Online Services (NOLS).

3.1 NOLS

Nokia Online Services (NOLS) is a web-based service that provides easyand secure access to, for example, documentation, software, and onlineordering for Nokia Siemens Networks customers, partners, and otherassociates. One of the services in NOLS is Documentation Center, one ofthe main delivery channels for operating documentation.

The various options for accessing the GSM/EDGE BSS documentation inNOLS are illustrated in figure Access methods to Nokia GSM/EDGE BSS,BSC and TCSM documentation in NOLS.

DN05135097Issue 2-0 en13/03/2008


Delivery channels and media

Figure 2. Access methods to Nokia GSM/EDGE BSS, BSC and TCSMdocumentation in NOLS

NOLS Documentation Center

NOLS Documentation Center provides you access to documentation inseveral different ways. You can choose the search option that best suitsyour needs from the following options:

. Latest documentation

In this section, documentation from the previous four weeks isorganised by publication date. If you are expecting a delivery, Latestdocumentation may be the quickest way to the document set.

. Technical documentation



In this section, all documentation that is available in theDocumentation Center is organised according to Nokia SiemensNetworks product structure. If you use NOLS regularly for findinginformation on a given product family, the product-structure-basednavigation may provide you the best overview of the available rangeof documentation.

The product structure is also the basis for the filtering functionality onthe main page of Documentation Center.

. Reference Information

This section is a web interface to a database where you can retrievethe most up-to-date reference information, that is, alarm, counter,parameter, and Key Performance Indicator (KPI) descriptions. Theavailability of these information types varies depending the product.

. Nokia Electronic Documentation (NED)

Clicking the NED link anywhere in NOLS brings you to a list ofdocumentation sets delivered in NED. You can reach the same listby clicking the NED link on the top navigation menu. For moreinformation, see section NED.

Figure 3. Nokia Electronic Documentation (NED) logo

. Products A-Z

In this section, all Nokia Siemens Networks products are listed inalphabetical order. Selecting a product in the list brings you to thedocument set list of the product.

NOLS Software Delivery

NOLS Software Delivery provides software downloads, including ChangeDeliveries for software products. The available software products are listedin the Software Catalog. You can find the Software Delivery service underthe Care section in NOLS.

DN05135097Issue 2-0 en13/03/2008


Delivery channels and media

3.2 Nokia Siemens Networks logistics system

In addition to NOLS deliveries, Nokia Siemens Networks also providesCD-ROM deliveries.

Full document sets for a product or system release can be delivered asCD-ROM or DVD sales items which you can order in packages of eitherone or ten copies from Nokia Configurator.

Tip

Pre-release documentation, NED update packages, and other changedeliveries are not available as CD-ROMs.

The ordering process for the GSM EDGE BSS NED CD-ROMs and/orDVDs is the same as the ordering process for software and hardwaredeliveries.

3.3 Software-embedded documentation

Embedded documentation inside a software application usually meansonline help. Online help is available for the graphical user interfaces (GUI)of the following GSM/EDGE BSS software applications:

. BTS Manager

. BTS HW Configurator

. Transmission Element Managers



4 Delivery formats

4.1 NED

The primary delivery format for all GSM/EDGE BSS, BSC and TCSMdocumentation is Nokia Electronic Documentation (NED). NED is asoftware application for delivering documentation and viewing it instandard web browsers. The current NED application version used in allnew deliveries is NED5.5, which is backward compatible with the versionsNED5.2, NED5.3, NED5.4, and NED5.4+.

In most cases, NED deliveries contain documentation in two formats:XHTML and PDF. In the Table of contents view (that is, XHTML), thecontent is organised in topics for easy browsing on the computer screen.In the PDF view, the same content is available for downloading andprinting.

For more information on the features and the use of the NED application,see NED guides and training material in NOLS Documentation Center,under Documentation News.

NED in NOLS

NOLS is the main delivery channel for NED documentation. It is possibleto either browse a NED online in NOLS or download NED document setson a computer or a server.

. Browsable NED

The browsable NED allows you to browse documentation in NOLSwithout having to install the NED software. For opening thebrowsable NED content, you have to navigate to the documentationset you wish to view and click on the Browse NED content link asshown in figure Browse NED content.

DN05135097Issue 2-0 en13/03/2008


Delivery formats

Figure 4. Browse NED content

. Downloadable NED

You can use the downloadable NED if the NED application has beeninstalled on your computer locally or is available on a server. Thisoption allows you to download NED files and integrate them amongthe previously installed NED documentation sets.

. Updated documentation NED



Updated documentation NEDs are NED documentation sets thatcan be browsed online in NOLS or downloaded on top of an existingdownloaded documentation set. With updated documentationNEDs, delayed or corrected content can be integrated todocumentation sets that have already been delivered. Updatepackages can also be used for removing documents from existingdocumentation sets.

Instructions for downloading NEDs and update packages can befound in NOLS Documentation Center on all NED delivery pages.Instructions for installing NED application software and theinstallation package itself can also be found in NOLS.

Tip

Updated documentation NEDs are only available via NOLS.

NED on CD-ROM or DVD

NED documentation sets are also available on CD-ROMs and DVDswhich can be ordered. For more information, see section Nokia SiemensNetworks logistics system in chapter Delivery channels and formats.

4.2 PDF

Documents are always provided in PDF format. You can find the PDFdocuments of Product Documentation sets in the PDF view of NED.

PDF-only deliveries are made if documentation must be published veryquickly. Typically, any pre-release documentation sets, SW ReleaseDocumentation sets, and change documentation are published in the PDFformat.

4.3 Online help

Context-sensitive online help is available for some GSM/EDGE BSSsoftware products. You can access the online help from the graphical userinterface (GUI) of the software product. The help provides information onthe dialogues, windows, and functions of the software product in question.

DN05135097Issue 2-0 en13/03/2008


Delivery formats



5 How to find the information you need inGSM/EDGE BSS Documentation

5.1 GSM EDGE BSS, BSC and TCSM productdocumentation contents

The GSM/EDGE BSS, BSC and TCSM Product Documentation setdescribes the Nokia Base Station Subsystem (BSS), Nokia Base StationController (BSC), and Transcoder Submultiplexer (TCSM) networkelements. Note that although this documentation set includes informationon the BTSs, there are also available separate product documentationsets for each of the BTS site types.

This GSM/EDGE BSS documentation set contains instructions forimplementation, normal daily operation, maintenance, and troubleshootingof BSC/TCSM software and hardware. BSC features and functionalities aswell as cabinets and units are described. The documentation set containsreference sections for example for alarms, counters, commands, andparameters. The documentation set also contains information for theimplementation of BSS system level features into the network.

Figure Main sections of Nokia GSM/EDGE BSS, BSC and TCSM ProductDocumentation illustrates the top-level structure of the GSM/EDGE BSSProduct Documentation set visible in NED browser.

DN05135097Issue 2-0 en13/03/2008


How to find the information you need in GSM/EDGE BSSDocumentation

Figure 5. Main sections of Nokia GSM/EDGE BSS, BSC and TCSM ProductDocumentation

Guide to documentation

The purpose of Guide to GSM/EDGE BSS, BSC and TCSMDocumentation (that is, this document) is to describe the availabledocumentation for the BSS13 and S13 releases; its contents, structure,delivery, and versioning. In addition, documentation feedback channelsare described.

Changes

The Changes category serves as a connection between the previousrelease and the current one. For this purpose, information on changes insoftware, hardware, alarms, counters, MML commands, parameters, anddocumentation are provided.

Descriptions

In this section you can find descriptions of the network element's hardwarearchitecture from plug-in units to engineering descriptions, and softwarearchitecture from basic functionalities to individual software features. Thedescription documents are further divided into the following categories:



. System descriptions, which includes the system-level descriptions ofthe base station subsystem and transport network solution

. Functional descriptions

. Feature descriptions

. Product descriptions

. Hardware descriptions, which includes engineering, functional unit,and plug-in unit descriptions

Note that some data features do not have a feature description of theirown. Instead, the information is available in the GPRS and GPRS/EDGEfeature descriptions.

Instructions

Step-by-step instructions for completing specific tasks are arrangedaccording to operator processes ranging from planning to administering.The step-by-step instructions are based on the actual goals of the userrather than on product functionality.

The steps in the instructions are carried out either with MML or serviceterminal commands, or via the Nokia NetAct network managementsystem.

Instructions do not usually contain any further details on, for example,parameters and counters, but provide links to Reference category whereall the details are available.

The instructions category consists of the following topics:

. Plan

. Dimension

. Install and upgrade

. Commission

. Integrate

. Test and activate

. Optimise and expand

. Monitor

. Trouble management

. Measure

DN05135097Issue 2-0 en13/03/2008



. Prevent failures

. Administer

In the Dimension section you can find EDGE dimensioning guidelines forthe BTS, Abis, BSC, and Gb network elements.

Note that some features, such as EGPRS, Dual Transfer Mode (DTM), FileBased Plan Provisioning (FBPP), and GSM-WCDMA Interworking, requiresystem-level implementation. The system-level implementationinstructions are also included in the Nokia GSM/EDGE BSS, BSC andTCSM Product Documentation set.

Reference

The Reference category contains detailed technical information about thenetwork element. The information is relevant in many contexts andtherefore often linked with other parts of the documentation. For example,the parameter dictionary is a reference useful tool during various tasksbecause it is not possible to memorise all parameters but it is possible torefer to them again and again. Typical reference items are the following:

. Alarms

. Clear codes and cause codes

. Database and file descriptions

. Measurements with associated counters,

. MML and service terminal commands

. Parameters

. Interface specifications

. Technical specifications

Note that you can find information on GSM voice key performanceindicators (KPIs) and EDGE and GPRS key performance indicators underthe Counters/performance indicators category. The documents areprovided in both PDF and XHTML format in the BSS13 release.

Legal and safety statements

In the Legal and Safety Statements category you can find:



. environmental information for the BSC and TCSM hardware

. software licence terms that include 3rd party software licencesapplicable to certain software included in the product

. general product information that includes warnings and cautionsconcerning handling and using Nokia DX200 equipment

5.2 Site documentation contents

The purpose of site documentation is to instruct in the planning and settingup a BSC or TCSM site and to describe BSC and TCSM hardware in theirmaximum configuration. Some of the site documents are common for twoor more network elements because of the shared DX200 hardwareplatform

Installation planning documents

Installation planning documents specify the site requirements for BSC,TCSM, and other Nokia DX200 platform network elements. For example,requirements for equipment room, power supply, grounding andoperational environment are defined.

Installation and upgrading documents

Installation documents guide you through all the steps that are required toset up BSC or TCSM hardware. The steps include unpacking of thedelivery, various cabinet installation options, and plug-in unit installation.Details of jumper settings are also described.

Equipment and cable lists

The reference part contains BSC or TCSM equipment and cable lists, anddefines the cabinet interfaces.

For more information on the site documentation sets, see Guide to BSC3iSite Documents in Nokia BSC3i Site Documentation and Guide to TCSM3iSite Documents in Nokia TCSM3i Site Documentation.

DN05135097Issue 2-0 en13/03/2008



5.3 Software pre-release documentation contents

The software pre-release documentation offers you information on the newsoftware release. The documentation provides generic releaseinformation, change information, parameter information andimplementation instructions.

Generic release information

Generic release information documents provide you an introduction to thenew release at hand. Typical documents are:

. Release Notes

. New features

Change information

The change documents describe changes between the previous andcurrent release. Typical documents are:

. Documentation changes

. Hardware changes

. Software changes

. Alarm changes

. Counter changes

. MML command changes

. Parameter changes

Parameter information

Parameter information on the PRFILE, FIFILE, and PAFILE parameters isalso provided in the pre-release documentation.

Implementation instructions

Implementation instructions provide information on the BSC hardwareimplementation.



5.4 Software release documentation contents

The purpose of release documentation is to briefly introduce the newsoftware release, describe test results, and instruct in upgrading softwareto new release level. The documentation is structured into three parts:Generic release information, Test reports and Upgrade.

Generic release information

Documents under Generic release information provide you with anintroduction to the new release at hand. Typical documents are:

. Release Notes

. Generic Failure Reports

. Software development between releases

. New features

Test reports

In addition to actual test reports, the Test reports section containsinformation on compatibility and interoperability. Typical documents are:

. Test results

. Compatibility report

. Interoperability report

Upgrade

Documents that belong to the Upgrade section list prerequisites for andinstruct on carrying out the software upgrade procedure. Typicaldocuments are:

. Software upgrade procedure

. Hardware revision list

. Software control list

DN05135097Issue 2-0 en13/03/2008





6 Documentation identification andversioning system

For identifying Nokia Siemens Networks documentation, the documentsare numbered and given a version and a language code. Documents thatare published with the draft status also have a draft label.

Identification numbers and codes

Identification numbers and codes are used for identifying documents, partsof a document, or entire document sets (such as a NED library or a changedelivery). The identification numbers and codes are unique, that is, onenumber or code is available for one document only.

Version

Version and issue numbering enables you to differentiate between theprevious and current versions of documents. The basic rule is that thehigher the number, the more recent the copy is.

Language

Almost all Nokia Siemens Networks documentation is in English. For somedocuments or document sets, version in other languages are available. Insuch a case, the identifier, issue, and edition are the same for alllanguages, and the differentiation between the languages is made with thelanguage code. Language codes follow the ISO639 standard for names oflanguages. For example, the language code en refers to English, ru toRussian, and zh to Chinese.

Status

The status part of documentation identification is only generated if thedocument is published at a time when its content is likely to change and,therefore, Nokia Siemens Networks cannot be held liable for the content.In this case, you can find the word 'draft' at the end of the identificationdata.

DN05135097Issue 2-0 en13/03/2008


Documentation identification and versioning system

6.1 PDF document identification

The PDF document identification data can be found in the PDF footer asshown in figure PDF document identification. The document numberconsists of two parts, namely the prefix DN, which stands for documentnumber, and a running number which is unique for each document. Infigure PDF document identification, for example, the document number isDN0163595.

Each document is given an issue number, which consists of two digits. Infigure PDF document identification the issue number is 6-2. The issuenumber is incremented every time the content is changed. The first digit ofthe issue number increases once per release and the second partincreases every time the document is updated and published with arelease.

The language code is placed after the issue number. In the exampledocument, the language is English (en) If the document is published as adraft, the word 'draft' is added.

Tip

In the BSS13 and S13 release, we introduce approval dates as a furthermeans for document identification. The date appears in the PDF footer.Note that not all documents have a date on them in the BSS13 and S13release as the dates are only added to documents that have beenupdated in this release.

Figure 6. PDF document identification



6.2 NED online content identification

Each online (XHTML) page of NED libraries has its own identification data.You can find it by clicking the information icon, . , in the upper right-handcorner of the main frame of each page. This is illustrated in the figure NEDonline content identification.

Figure 7. NED online content identification

Document numbers are used for identifying XHTML content as well.Version numbers are used for versioning, and language codes are usedfor identifying different languages.

DN05135097Issue 2-0 en13/03/2008



Tip

Document numbers of online pages do not correspond with PDFdocument numbers because of the different level of granularity betweenthe two formats. An online page roughly corresponds with a chapter in aPDF document.

6.3 Document set identification

Entire document sets do not have document numbers but they areidentified with sales item codes instead. For example, the sales code forNokia GSM/EDGE BSS, Rel. BSS13, BSC and TCSM, Rel. S13, ProductDocumentation is BSC3153.

The sales item code of a document set is visible:

. On the cover page of each PDF document that belongs to thedocument set (see figure Sales item code on PDF cover page).

. On the cdconts.html page which is the starting page for downloadedPDF files.

Figure 8. Sales item code on PDF cover page



The publication date shows when the document set was published. Thepublication date is visible in NOLS Documentation Center in the Modifieddate field.

Each document set is given a version number which appears as part of thedocument set title. Every time a document set is updated and republished,the version number increases. Version 1 is always the so called baserelease. Updated documentation NEDs are considered equal to regularNEDs. If a document set is updated via an updated documentation NED,the version number increases by one. In the GSM/EDGE BSSdocumentation, this type of versioning has been used from releasesBSS12 and BSC/TCSM S12 onwards. Table Document set versioningillustrates how the version number of a document set is incremented.

Table 7. Document set versioning

Base release First updateddocumentation NED

Second updateddocumentation NED

Nokia GSM/EDGE BSS, Rel.BSS13, BSC and TCSM, Rel.S13, Product Documentation,v. 1

Nokia GSM/EDGE BSS, Rel.BSS13, BSC and TCSM, Rel.S13, Product Documentation,v. 2

Nokia GSM/EDGE BSS, Rel.BSS13, BSC and TCSM, Rel.S13, Product Documentation, v. 3

The versioning of the updated document sets is also illustrated in figureNED update package for GSM/EDGE BSS12 System Documentation.Note that document set versioning does not apply to the S11 and GSM/EDGE BSS11 releases and the earlier BSC/TCSM S11.5 and GSM/EDGEBSS11.5. In these cases, the updated documentation NEDs are identifiedwith running numbers to differentiate between the updated documentation,for example GSM/EDGE BSS11.5 System Documentation Update 2.

DN05135097Issue 2-0 en13/03/2008



Figure 9. NED update package for GSM/EDGE BSS12 SystemDocumentation

The NED contents are updated either by publishing change notes, changedeliveries with documents in PDF format, or by publishing updateddocumentation NEDs. The identification of documentation changedeliveries in the PDF format varies, and is different from the identificationof the updated documentation NEDs described above. Each NokiaSiemens Networks business unit has its own system for identifying changedeliveries. For example, Nokia BSC/TCSM change note and changedeliveries are labelled according to the release, its version, and are given arunning number. An example of a BSC documentation change noteidentifier is: S12, v.6, Doc change note 2.

The change delivery identifier is part of the document set title which isvisible in NOLS Documentation Center in the Title field. This is illustrated infigure Change delivery identifiers in NOLS.



Figure 10. Change delivery identifiers in NOLS

Change deliveries are not versioned, because they are never updated. If anew update or correction is needed, a completely new change deliverywith a unique identifier is issued.

DN05135097Issue 2-0 en13/03/2008





7 How to give feedback on documentation

7.1 Problem reporting

Documentation related problems can be reported either to Nokia SiemensNetworks Customer Contact Centers or via the NOLS Helpdesk. In theNOLS Helpdesk service, you are given direct access to the Electra servicerequest tool where you can create, manage, and follow up your company'sservice requests online. Documentation cases are processed according tothe same principles as hardware and software cases.

Submit a problem report via NOLS HelpDesk (Electra) or to your localNokia Siemens Networks contact when:

. Information is incorrect

. Information was not found, or it was difficult to find it

. Documents do not open or show correctly, links do not work, youhave problems in downloading the NED software, NED libraries, orPDFs

. Information is not detailed enough, information is missing or it isinconsistent

. Information does not support the use of the product

If possible, add the following details into your report:

. Document set title and version

. Document title

. Document identifier number

. Document issue

DN05135097Issue 2-0 en13/03/2008


How to give feedback on documentation

7.2 Giving feedback

If you wish to ask something about documentation or communicate adevelopment idea, but not report your feedback as a fault, severalchannels can be used for providing the feedback.

Comment on the document

If you have comments on one document set in particular, the document-set-specific feedback form in NOLS is the best feedback channel for you.A Comment on the document box is located on the right-hand frame ofeach Document details page, as illustrated in figure Commenting on aspecific document set in NOLS. If you click the comments and feedbacklink, it opens a form where document set identification data is filled inautomatically, and you can simply type in the message and submit theform.

Figure 11. Commenting on a specific document set in NOLS



NOLS Documentation Center feedback

A Feedback link is located in the topmost navigation bar and right-handframe Tools box of each Documentation Center page (see figure Feedbacklink in NOLS Documentation Center). Click the link, fill in the feedbackform, select Technical documentation service and submit the form.

Figure 12. Feedback link in NOLS Documentation Center

NOLS Support

If you have any feedback related to NOLS or any content that can be foundin NOLS, you can send it to NOLS Support. You can find guidance byfollowing the Feedback link, which can be found on each NOLS page onthe upper right corner.

DN05135097Issue 2-0 en13/03/2008


How to give feedback on documentation